uuid_type 1.1.1

UUID type, parser and generators. Can generate v1, v4, and v5 UUIDs

example/main.dart

import 'dart:typed_data';
import 'package:uuid_type/uuid_type.dart';

void main() {
  //
  // UUID type
  //

  // create UUID from canonical string
  Uuid u1 = Uuid("6ba7b811-9dad-11d1-80b4-00c04fd430c8");

  // print version & variant
  print("$u1 (ver: ${u1.version} var: ${u1.variant})");
  // -> ver: = 1 var: Variant.rfc4122

  // create UUID from byte array
  Uuid u2 = Uuid.fromBytes(Uint8List.fromList(<int>[
    0x6b, 0xa7, 0xb8, 0x11, //
    0x9d, 0xad,
    0x11, 0xd1,
    0x80, 0xb4, 0x00, 0xc0, 0x4f, 0xd4, 0x30, 0xc8
  ]));

  // UUIDs are equal
  print(u2 == u1); // -> true

  // print as string
  print(u2); // -> 6ba7b811-9dad-11d1-80b4-00c04fd430c8

  // parse URN
  Uuid u3 = Uuid.parse("urn:uuid:6ba7b811-9dad-11d1-80b4-00c04fd430c8");

  // UUIDs are equal
  print(u3 == u1); // -> true

  // parse GUID
  Uuid u4 = Uuid.parse("{6BA7B811-9DAD-11D1-80B4-00C04FD430C8}");

  // UUIDs are equal
  print(u4 == u1); // -> true

  // create old NCS UUID (example from AIX docs )
  Uuid u5 = Uuid.fromBytes(Uint8List.fromList(<int>[
    0x34, 0xdc, 0x23, 0xaf, //
    0xf0, 0x00,
    0x00, 0x00,
    0x0d,
    0x00, 0x00, 0x7c, 0x5f, 0x00, 0x00, 0x00
  ]));
  print("$u5 (ver: ${u5.version} var: ${u5.variant})");
  // -> 34dc23af-f000-0000-0d00-007c5f000000 (ver: 0 var: Variant.ncs)

  //
  // Generators
  //

  Uuid u;

  // generate time-based UUID (with random node ID and clock sequence)
  u = TimeBasedUuidGenerator().generate();
  print("$u (ver: ${u.version} var: ${u.variant})");
  // -> ... (ver: 1 var: Variant.rfc4122)

  // generate name + namespace based UUID
  var nsUrl = Uuid("6ba7b811-9dad-11d1-80b4-00c04fd430c8");
  u = NameBasedUuidGenerator(nsUrl).generate("https://dart.dev/");
  print("$u (ver: ${u.version} var: ${u.variant})");
  // -> 51aa5a34-f12a-5843-89aa-2e687a910904 (ver: 5 var: Variant.rfc4122)

  // generate random-based UUID
  u = RandomBasedUuidGenerator().generate();
  print("$u (ver: ${u.version} var: ${u.variant})");
  // -> ... (ver: 4 var: Variant.rfc4122)

  //
  // Utility
  //

  // generate time-based UUID
  print(uuid.v1());

  // generate random-based UUID
  print(uuid.v4());

  // generate name-based (SHA1) UUID
  print(uuid.v5("6ba7b811-9dad-11d1-80b4-00c04fd430c8", "https://dart.dev/"));

  // compre UUIDs
  print(uuid.compare("6ba7b811-9dad-11d1-80b4-00c04fd430c8",
      "6ba7b811-9dad-11d1-80b4-00c04fd430c8"));
  // -> 0    
}