npm

Does your artifact manager get in the way? Join us on Oct. 8 at 10am PT, to discuss how npm can help.Sign up »

simpleflakes

2.1.0 • Public • Published

simpleflakes

travis status npm codacy quality codacy coverage coveralls status
tonicdev demo david dep status david dev dep status

Simpleflake is the smartest way to generate a 64-bit + time-ordered + snowflake based ID. See the presentation!

This port is test driven and no release goes out without tests.
Also, this library does not rely on low level bindings, with OpenSSL, libgmp or anything beyond pure JavaScript.

How to Install:

npm install simpleflakes --save

Implementation:

Assumes original Python implementation as reference and fixes epoch (starts on 2000-01-01T00:00:00.000Z (UTC) while Python API v0.1.5 epoch starts on 2000-01-01T05:00:00.000Z).

simpleflakes uses the TC39 BigInt implementation, when running on newer versions of Node.js. When BigInt is not available, Fedor Indutny's big number library (bn.js) is used as the fastest fallback for big number calculations.

Usage:

const { simpleflake } = require('simpleflakes');
 
const flakeBigInt = simpleflake()
 
// simpleflake(
//    timestamp = Date.now(), 
//    random_bits = 23-bit random, 
//     epoch = Date.UTC(2000, 0, 1)
// )
// returns BigInt on newer Node.js or bn.js BigNum on older engines.
 
flakeBigInt.toString();       // 4234673179811182512
flakeBigInt.toString(16);     // 3ac494d21e84f7b0
flakeBigInt.toString(2);      // 11101011000100...
flakeBigInt.toString(36);     // 20rfh5

You can check the original Python API 0.1.5 documentation for more info.

Reference

// Main flake function and its defaults
simpleflake(
    timestamp = Date.now(), 
    random_bits = 23-bit random, 
    epoch = Date.UTC(2000, 0, 1)
)
 
// Static constant epoch for simpleflake timestamps, starts at the year 2000  
simpleflake.SIMPLEFLAKE_EPOCH // const = 946702800
 
// Show binary digits of a number, pads to 64 bits unless specified.
simpleflake.binary(number, padding=true)
 
// Extract a portion of a bit string. Similar to substr().
simpleflake.extractBits(data, shift, length)
 
// Parses a simpleflake and returns a named tuple with the parts.
simpleflake.parseSimpleflake(flake)
 
// original API alias for SimpleFlake class, from the Python API
simpleflake.simpleflakeStruct
 
// same as simpleflake.simpleflakeStruct
SimpleFlake.SimpleFlakeStruct

License:

MIT

install

npm i simpleflakes

Downloadsweekly downloads

375

version

2.1.0

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability