npm install druuid
|2||downloads in the last day|
|4||downloads in the last week|
|51||downloads in the last month|
|Version||1.0.1 last updated 10 months ago|
Date-relative (and relatively universally unique) UUID generation.
A druuid comprises:
A 41-bit timestamp (which has millisecond precision for over 69 years after a defined epoch); and
23 random bits.
For example, a druuid generated at midnight on February 4, 2012, may look something like 11142943683383068069. In binary:
This ID can be displayed compactly in base 36: 2cnpvvfkm56ed.
64-bit IDs can be stored in BIGINT database columns, which are generally more efficient to index (and index uniquely) than VARCHAR.
The timestamp component allows for efficient date-based queries and easy cursor-based pagination.
23 bits of randomness contains much less entropy than traditional, 128-bit UUIDs, so precautions must be taken to avoid collisions between druuids generated in the same millisecond (e.g., a database constraint). The probability, within a millisecond, can be calculated with the Birthday problem (where n is the number of IDs generated per millisecond and 23 represents the number of random bits):
IDs generated in different milliseconds cannot collide, but at a rate of 10 IDs per millisecond (10,000 IDs per second), the probability a collision will occur within any given millisecond approaches 0.000596%, which is about once every few minutes if that rate is constant.
$ brew install gmp # `apt-get install libgmp' on Ubuntu. $ npm install druuid
$ gem install druuid
var druuid = require('druuid'); // druuid.epoch = Date.UTC(1970, 0); // change the default (Unix) epoch var uuid = druuid.gen(); // => <BigInt 11142943683383068069> druuid.time(uuid); // => Sat Feb 04 2012 00:00:00 GMT-0800 (PST)
require 'druuid' # Druuid.epoch = Time.utc 1970 # change the default (Unix) epoch uuid = Druuid.gen # => 11142943683383068069 Druuid.time uuid # => 2012-02-04 00:00:00 -0800
(The MIT License)
© 2013 Recurly Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.