flake_uuid 0.0.1

  • README.md
  • Installing
  • Versions
  • --

Flake UUID #

Flake UUID is a Dart library that provides 64- and 128-bit, k-ordered identifiers, which preserve their order of creation (somewhat) if sorted lexically.

It generates conflict-free and unique identifiers without further coordination between the nodes on your cluster (assuming time goes forward and machine IDs are unique).

64-bit Flake ID #

The 64-bit Flake ID is created with:

  • 42-bit timestamp (millis since epoch, good til the end of this century)
  • 10-bit machine ID
  • 11-bit sequence (incremented within the same millisecond)

A simple usage example, works only with Dart VM, because it uses the environment to generate a somewhat-random machine ID:

import 'package:flake_uuid/flake_uuid.dart';

main() {
  var x = flake64.nextInt();
  var y = flake64.nextHex(); // '2b06cca4f5542000'
}

A more detailed version if you use the class directly. You must supply a pre-coordinated machine ID:

import 'package:flake_uuid/flake_base.dart';

main() {
  var flake = new Flake64(machineId: 123);
  var x = flake.nextInt();
  var y = flake.nextHex();
}

128-bit Flake ID #

The 128-bit Flake ID is created with:

  • 64-bit timestamps (macroseconds(!) since epoch, won't run out in your lifetime)
  • 48-bit machine ID
  • 16-bit sequence (incremented within the same macrosecond)

A simple usage example, works only with Dart VM, because it uses the environment to generate a somewhat-random machine ID:

import 'package:flake_uuid/flake_uuid.dart';

main() {
  var y = flake128.nextHex(); // '2b06cca4f5542000'
}

A more detailed version if you use the class directly. You must supply a pre-coordinated machine ID:

import 'package:flake_uuid/flake_base.dart';

main() {
  var flake = new Flake128(machineId: 123);
  var x = flake.nextInt(); // not recommended
  var y = flake.nextHex(); // '000540947b2305c4a25c0001c73a0000'
}

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  flake_uuid: ^0.0.1

2. Install it

You can install packages from the command line:

with pub:


$ pub get

Alternatively, your editor might support pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:flake_uuid/flake_uuid.dart';
  
Version Uploaded Documentation Archive
0.1.3 Sep 9, 2018 Go to the documentation of flake_uuid 0.1.3 Download flake_uuid 0.1.3 archive
0.1.2 May 28, 2018 Go to the documentation of flake_uuid 0.1.2 Download flake_uuid 0.1.2 archive
0.1.1 May 6, 2017 Go to the documentation of flake_uuid 0.1.1 Download flake_uuid 0.1.1 archive
0.1.0 Apr 2, 2017 Go to the documentation of flake_uuid 0.1.0 Download flake_uuid 0.1.0 archive
0.0.2 Nov 12, 2016 Go to the documentation of flake_uuid 0.0.2 Download flake_uuid 0.0.2 archive
0.0.1 Nov 5, 2016 Go to the documentation of flake_uuid 0.0.1 Download flake_uuid 0.0.1 archive
Awaiting analysis to complete.