sane_uuid 1.1.0 copy "sane_uuid: ^1.1.0" to clipboard
sane_uuid: ^1.1.0 copied to clipboard

A sane UUID implementation with support for generating and handling v1, v4 and v5 UUIDs according to RFC4122.

sane_uuid #

codecov

A properly designed, efficient UUID library for Dart.

  • Supports v1, v4, v5 and v6 generation
  • Immutable Uuid type with equality, comparison and accessors for properties defined by RFC 4122
    • The internal representation of the UUID is a byte array, not a String
  • Support for all syntactically correct UUIDs (regardless of RFC4122 semantics)

Usage #

A simple usage example:

import 'package:sane_uuid/uuid.dart';

// randomly generated using secure random number generator
final Uuid randomUuid = Uuid.v4();
// Prints properly formatted UUID, e.g.: a8796ef4-8767-4cd0-b432-c5e93ba120df
print(randomUuid);

// parse any common UUID string
final parsedUuid = Uuid.fromString(
  'a8796ef4-8767-4cd0-b432-c5e93ba120df',
);

// hyphens and capitalization don't matter
final parsedUuidDifferentFormatting = Uuid.fromString(
    'A8796EF487674CD0B432C5E93BA120DF',
);

// UUID objects with the same data are actually equal
assert(parsedUuid == parsedUuidDifferentFormatting);

For more examples, see the examples page.

Features and bugs #

Please file feature requests and bugs at the issue tracker.

License #

This project is released under the MIT License. That includes every file in this repository, unless explicitly stated otherwise at the top of a file. A copy of the license text can be found in the LICENSE file.

3
likes
160
points
50.6k
downloads

Publisher

verified publisherbjoernpetersen.net

Weekly Downloads

A sane UUID implementation with support for generating and handling v1, v4 and v5 UUIDs according to RFC4122.

Repository (GitHub)

Documentation

API reference

License

MIT (license)

Dependencies

crypto, meta

More

Packages that depend on sane_uuid