Int64 UUID (UInt52) Autoincremented via Redis

JavaScript has problems with using Int64 values that are less than the maximum UInt54 value. This library ensures a smooth migration to UUID64 without breaking the front end due to JavaScript rounding bugs.

Open your browser console and enter:

11111111111111111 + 2

What do you see? Yes, it's 11111111111111114.

But there's more. Try this:

11111111111111111

Press enter. What do you see? Yes, it's 11111111111111112.

JavaScript uses Double to store and work with integers, which leads to precision issues. This is why the maximum integer that JavaScript can process correctly is UInt54.

If you don't want to hunt down and fix all occurrences of this bug in your project but need UUID64, use this library.

Generates universally unique identifiers (UUID52) with unsigned Int64 last 52 bits (so it will be UInt52) for use in distributed applications.

1. The ability to auto-increment values in Redis.
2. Unix timestamps with microseconds.
3. The ability to expire keys in the Redis database.
4. Ensuring UInt52 values can be used in JavaScript without precision issues.

Call #generate to generate a new UUID64. The method returns a unique Int64 value less than the maximum UInt52 value.

Add into your Gemfile:

gem 'redis_int52_autoincrement'

before_create do |record|
  record.id ||= RedisInt52Autoincrement.generate(Rails.cache.redis || Redis.new(url: "redis://localhost:6379/0"))
end

A common issue is that servers may have different time settings. During time synchronization, there can be a shift of a few seconds. This library accounts for a maximum delta shift of ±50 (UUID52_MAX_SECONDS_EXPIRE) seconds.

Source code and documentation are hosted on GitHub:

GitHub Repository

To get UUID52 from the source:

git clone git://github.com/trumenov/redis_int52_autoincrement.git

This package is licensed under the MIT License and/or the Creative Commons Attribution-ShareAlike.

See MIT-LICENSE for details.

rake test