Viewing version 4.0.0-beta3. Open the latest package page.
uuid
4.0.0-beta3RFC4122 (v1, v4, v5, v6, v7, v8) UUID Generator and Parser for Dart
Readme
uuid
Version 4.0.x is a complete redesign of the underlying setup, but tries to be API compatible or similar to 3.x.
UuidValue is still Experimental and the API for it is in flux, please pay attention to changelogs and versions.
Simple, fast generation of RFC4122 UUIDs.
Features:
- Generate RFC4122 version 1, version 4, or version 5 UUIDs
- Supports draft version 6, version 7, and version 8
- Runs in web, server, and flutter
- Cryptographically strong random number generation on all platforms
- Defaults to non-crypto generator, see UuidUtil for cryptoRNG
- Documentation
Getting Started
Instructions
- Open a command line and cd to your projects root folder
- In your pubspec, add an entry for dart-uuid to your dependencies (example below)
- pub install
- If you wish to run tests, go into packages/dart-uuid/ and run 'dart test/uuid_test.dart'
Pubspec
There are 2 options. Directly from git, or from pub.dartlang.org
pub.dartlang.org: (you can use 'any' instead of a version if you just want the latest always)
dependencies:
uuid: ^4.0.0-beta1
import 'package:uuid/uuid.dart';
var uuid = Uuid();
Then create some ids ...
// Generate a v1 (time-based) id
uuid.v1(); // -> '6c84fb90-12c4-11e1-840d-7b25c5ee775a'
// Generate a v4 (random) id
uuid.v4(); // -> '110ec58a-a0f2-4ac4-8393-c866d813b8d1'
// Generate a v5 (namespace-name-sha1-based) id
uuid.v5(Uuid.NAMESPACE_URL, 'www.google.com'); // -> 'c74a196f-f19d-5ea9-bffd-a2742432fc9c'
Documentation
For documentation, please visit the Documentation page. Examples are included for most functions and classes.
For more complex examples and other usages, please look at the tests.
Release notes
See CHANGELOG
Changelog
Changelog
v4.0.0-beta3
- [BREAKING CHANGE] Replacing UuidUtil rng functions with RNG classes.
- UuidUtil.mathRNG() is replaced with MathRNG().generate().
- UuidUtil.cryptoRNG() is replaced with CryptoRNG().generate().
- Custom crypto implementations just need to implement the
RNGabstract class. - namedArgs and positionalArgs have been removed from GlobalOptions
- You may use LegacyRNG() if you need to use the old function style RNG.
- Fix a bug with the usage of Uint64List in Dart2js by not using it. (Thanks @hambergerpls)
v4.0.0-beta2
- [BREAKING CHANGE] The
Uuidclass now takes aGlobalOptionsclass instead of aMap<String, dynamic>. - Added options classes to eventually replace the Map parameter.
- [BREAKING CHANGE] Since v6,v7,v8 are new for 4.0, I have made it so they only take the new options class.
- Reworked the constructors, and moved state out of the classes. Const is now supported properly again
- Switched tests to use const Uuid to catch regressions.
- Set the
optionsparameter in v1, v4, and v5 to deprecated. - [BREAKING CHANGE] Make UuidValue properly const also
- Can no longer run validation on the const variant.
- Added UuidValue.withValidation() to handle this usecase, it can't be const.
- If you need const and validation. Create the UuidValue with the UUID, then call the
validate()function on it.
v4.0.0-beta1-1
- Mostly cleanup, linting, updating depedencies, etc.
v4.0.0-beta1
- Break up versions into individual objects that can be used standalone.
- No more colliding global states between versions
- Added UUID v6, v7, v8 from the new RFC.
- Add
time,version, andvariantfunctions to UuidValue
v3.0.7
- Fixed parse to allow buffers larger than 16 bytes to be used. [Thanks @hoylen]
v3.0.6
- Enable
avoid_dynamic_callslinting and fix appropriately. (Thanks @devoncarew)
v3.0.5
- Global options were incorrectly being ignored. #76 (Thanks @Skycoder42)
- V4 Global Options were incorrectly named. #76 (Thanks @Skycoder42)
- Global state was static, not per instance. #76 (Thanks @Skycoder42)
- Additional tests to make sure the above doesn't regress. #76 (Thanks @Skycoder42)
v3.0.4
isValidUUIDnow handles some Microsoft GUIDs better that only deviate in the Variant setting. (Thanks @FluentChange)- Improve error output so that it better explains how to handle the above change in your code if you encounter it. (Thanks @FluentChange)
- Improve validation logic to better handle multiple validation cases, error output, and feedback to developers. (Thanks @FluentChange)
v3.0.3
- [Experimental] Fixed UuidValue to properly check things are valid. (Thanks @FlorianUlivi)
- [Experimental] Added new constructors
fromByteListandfromListtoUuidValue - [Experimental] Added
==operator override and hashcode override. (Thanks @giorgiofran for suggestion) - Added
parseAsByteListto offer a direct output toUint8List - [Experimental][BREAKING CHANGE] Change
toBytesinUuidValueto returnUint8Listinstead ofList<int> - [Experimental][BREAKING CHANGE]
isValidUuidfunction signature has changed, now takes 2 optional parametersfromStringandfromListthat will do the appropriate validation on different sources.
v3.0.2
- [Experimental] Add flags to UuidValue constructor and parse to disable validation of the UUID, primarily to allow Microsoft GUIDs to not break things.
v3.0.1
- Fix RNG to not need shuffling and improve performance/memory usage (Thanks @julemand101)
v3.0.0
- Release nullsafety version
v3.0.0-nullsafety.1
- [BREAKING CHANGE] Changed
parse()to throw a FormatException instead of returning NIL uuids or partially handled UUIDs. - Changed
Uuidconstructor to be constant, and adjusted all the code accordingly. - New
isValidUUIDfunction for validating UUIDs. - [BREAKING CHANGE]
parseandunparseare now static functions. - [Exprimental] Object version of the UUID instead of a string or list of bytes.
v3.0.0-nullsafety.0
- Migrate package to null-safety, increase minimum SDK version to 2.12 (Thanks @simolus3)
v2.2.1 & v2.2.2
- Update pedantic analyzer options, fix linting issues, and increase SDK minimium to 2.2 to support set literals
v2.2.0
- fix v1 clock high to properly ignore c and d variants. (fixes #47)
- update example
v2.1.0
- Shuffle mathRNG bytes so that they don't generate duplicates. Will affect codes generated by a static seed.
v2.0.4
- Remove new keyword where not needed. (forgot to rerun before releasing 2.0.3)
v2.0.3
- Do some analyzer fixes and formatting/renaming.
v2.0.2
- Merge fix for time precision loss in V1 time based UUIDs.
v2.0.1
- Fix regression where CryptoRNG was default, moved back to MathRNG
- Added ability to set RNG globally to skip having to set it in every function call
- Allows you to set the v1 clock sequence, nodeID, and seed bytes to use cryptoRNG separately from globalRNG.
v2.0.0
- Fixup the API to split out Buffer and Non-buffer usages.
- Switch to build in Random.secure() and remove custom AES implementation.
- Less dependencies.
- Docs
- Cleanup
v1.0.3
- Fix SDK constraints to allow Dart 2.0 stable.
v1.0.2
- Fix constants breaking in Dart 1.x, need to be backwards compatible.
v1.0.1
- Fix constants to match Dart 2.0 spec
v1.0.0
- Cleanup and prep for dart 2.0
- Has been stable for a long time, upgrading to 1.0 version
v0.5.3
- Merged pull request to support crypto 2.0.0
- Support convert 2.0.0
v0.5.2
- Merged pull request to upgrade crypto library to 1.0.0.
v0.5.1
- Merged pull request for various updates and cleanup.
v0.5.0
- Reverted back to custom AES implementation. Moved RNG methods to UuidUtil (import 'package:uuid/uuid_util.dart')
- Fixed a potential bug with custom RNG method passing and added more ways to pass in custom RNG functions.
- Cleaned up and refactored some stuff. Using only v1 is only 67kb of js, Using only v4 is 97kb. Using crypt v4 is 118kb. Using both v1 and non-crypto v4 is 126kb.
- Default RNG for v4 is now the mathRNG function. If you wish to use cryptoRNG, import UuidUtil and pass in cryptoRNG.
- Updated README.md with more examples and usages.
- Updated Tests.
v0.4.1
- Changed initCipher location so that if you ever only use v1 UUIDs, you will get a very small Dart2JS output compared to v4 or v5 that do load it.
v0.4.0
- Use Cipher base.dart, as I don't need entropy generators, and this allows me to merge client/server together again and fix many issues this caused.
v0.3.2
- Fix import/library bug.
v0.3.1
- Update pubspec to allow installation of the latest Cipher 0.7.
v0.3.0
- Updated to latest Cipher at 0.6.0. This created a breaking change in the imports. Please make sure you update your code.
- Fixed problem when creating v4 UUIDs too fast, it would create duplicate UUIDs.
v0.2.2
- Pegging cipher to 0.4.0 temporarily for browser support
v0.2.1
- Using new version of cipher.
v0.2.0
- Dart 1.0 Readiness
- Switched from custom AES to cipher package AES.
v0.1.6
- Adjusting usage of constants.
- Fixing tests.
v0.1.5
- Stupid typo on import.
v0.1.4
- Fixing Crypto package move.
v0.1.3
- Fixing language changes.
v0.1.2
- Fix change of charCodes to codeUnits
v0.1.1
- Fixing syntax for upcoming breaking changes.
v0.1.0
- Cleanup, changes, and prep for M3.
v0.0.9
- Minor fix with a const RegExp
- Made sure everything builds on latest dart.
- Fixed pubspec to now import unittest from pub instead of sdk.
v0.0.8
- Changed to the new optional paramater syntaxes and usages.
- Adjusted tests for the new function call style due to parameter change.
- Fixed Import/Source/Library statements to the new format.
v0.0.7
- Made changes requested by the Google team to get my package up on pub.dartlang.org
v0.0.6
- Fixed up some code to make it possibly faster and using better Dart practices.
- Cleaned up some documentation.
v0.0.5
- Added Initial AES for Dart (untested if it actually works/matches other AES encryptors)
- Use AES cipher to create crypto strong bytes.
v0.0.4
- Issue wasn't Math.Random() but a bad reseed by me.
- Cleaned up for new Pub layout.
v0.0.3
- Added UUIDv5
- Fixed UUIDv4 bugs
- Added more unit tests
- Found bug in dart's Math.Random(), reported, waiting for fix to fix my code.
v0.0.2
- Initial tests
- Fixed some parser bugs.
v0.0.1
- Initial Release
- No tests
Installing
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir
flutter pub add 'uuid:4.0.0-beta3'pubspec.yaml
name: uuid
version: 4.0.0-beta3
description: >
RFC4122 (v1, v4, v5, v6, v7, v8) UUID Generator and Parser for Dart
homepage: https://github.com/Daegalus/dart-uuid
environment:
sdk: ">=2.14.0 <3.0.0"
dependencies:
crypto: ^3.0.0
sprintf: ^7.0.0
dev_dependencies:
lints: ^2.0.1
test: ^1.24.0
Version history
| Version | Published | Archive | SHA-256 |
|---|---|---|---|
| 0.0.6 | Cached · Upstream SHA-256 matched | Download | d27bb6c0…be6d19 |
| 0.0.7 | Cached · Upstream SHA-256 matched | Download | d5825879…e2df2c |
| 0.0.8 | Cached · Upstream SHA-256 matched | Download | 1a476151…e5f25f |
| 0.0.9 | Cached · Upstream SHA-256 matched | Download | 52a46f15…8de3e9 |
| 0.1.0 | Cached · Upstream SHA-256 matched | Download | b584cb32…c9072b |
| 0.1.1 | Cached · Upstream SHA-256 matched | Download | 32467249…f32c88 |
| 0.1.2 | Cached · Upstream SHA-256 matched | Download | 955a0b19…66d502 |
| 0.1.3 | Cached · Upstream SHA-256 matched | Download | 2ba86667…c61076 |
| 0.1.4 | Cached · Upstream SHA-256 matched | Download | db2564b6…bfc740 |
| 0.1.5 | Cached · Upstream SHA-256 matched | Download | 2f47eaa3…17a80e |
| 0.1.6 | Cached · Upstream SHA-256 matched | Download | b5fb17f2…d01e46 |
| 0.2.0 | Cached · Upstream SHA-256 matched | Download | 930a60d0…c344a4 |
| 0.2.1 | Cached · Upstream SHA-256 matched | Download | 2099b36e…cc6c06 |
| 0.2.2 | Cached · Upstream SHA-256 matched | Download | 5e639255…c44715 |
| 0.3.0 | Cached · Upstream SHA-256 matched | Download | 601c357d…7d5bcf |
| 0.3.1 | Cached · Upstream SHA-256 matched | Download | a6a21f04…6c0928 |
| 0.3.2 | Cached · Upstream SHA-256 matched | Download | 6833ce79…b17506 |
| 0.4.0 | Cached · Upstream SHA-256 matched | Download | f2438445…fc605a |
| 0.4.1 | Cached · Upstream SHA-256 matched | Download | ec889bc5…016f1d |
| 0.5.0 | Cached · Upstream SHA-256 matched | Download | 182e0f47…ec1565 |
| 0.5.1 | Cached · Upstream SHA-256 matched | Download | 07fee225…724990 |
| 0.5.2 | Cached · Upstream SHA-256 matched | Download | fdf930c6…674cc4 |
| 0.5.3 | Cached · Upstream SHA-256 matched | Download | 5ee46227…73d3f8 |
| 1.0.0 | Cached · Upstream SHA-256 matched | Download | 1524595b…cb95f9 |
| 1.0.1 | Cached · Upstream SHA-256 matched | Download | 9d076ca7…b9ae9f |
| 1.0.2 | Cached · Upstream SHA-256 matched | Download | a7605e1c…f1754e |
| 1.0.3 | Cached · Upstream SHA-256 matched | Download | 1b9363b6…11d1e2 |
| 2.0.0-rc1 | Cached · Upstream SHA-256 matched | Download | fae79d68…a80336 |
| 2.0.0 | Cached · Upstream SHA-256 matched | Download | 4930c7aa…5b3caa |
| 2.0.1 | Cached · Upstream SHA-256 matched | Download | 78a84f69…6c78f0 |
| 2.0.2 | Cached · Upstream SHA-256 matched | Download | 9007ebb8…a18370 |
| 2.0.3 | Cached · Upstream SHA-256 matched | Download | fe6702d3…31c8d8 |
| 2.0.4 | Cached · Upstream SHA-256 matched | Download | 4c4896fe…77d56e |
| 2.1.0 | Cached · Upstream SHA-256 matched | Download | 9f6a5645…064312 |
| 2.2.0 | Cached · Upstream SHA-256 matched | Download | 467d0a24…9a9e99 |
| 2.2.1 | Cached · Upstream SHA-256 matched | Download | bedb244e…9fd2fd |
| 2.2.2 | Cached · Upstream SHA-256 matched | Download | bd96a5d8…6d81b0 |
| 3.0.0-nullsafety.0 | Cached · Upstream SHA-256 matched | Download | c0a46930…20b156 |
| 3.0.0-nullsafety.1 | Cached · Upstream SHA-256 matched | Download | 68dff0a6…8b2540 |
| 3.0.0 | Cached · Upstream SHA-256 matched | Download | 9947b48c…a62ac6 |
| 3.0.1 | Cached · Upstream SHA-256 matched | Download | 29aa6310…e99d50 |
| 3.0.2 | Cached · Upstream SHA-256 matched | Download | e89f208c…1d2ccb |
| 3.0.3 | Cached · Upstream SHA-256 matched | Download | 4fe24cb4…6a566a |
| 3.0.4 | Cached · Upstream SHA-256 matched | Download | 0ea20bfc…ca3758 |
| 3.0.5 | Cached · Upstream SHA-256 matched | Download | 00ba1241…fc7714 |
| 3.0.6 | Cached · Upstream SHA-256 matched | Download | 2469694a…9a8afc |
| 3.0.7 | Cached · Upstream SHA-256 matched | Download | 648e1030…519313 |
| 4.0.0-beta1 | Cached · Upstream SHA-256 matched | Download | 20e95d65…17cde3 |
| 4.0.0-beta1-1 | Cached · Upstream SHA-256 matched | Download | e3cfb7bf…a6159f |
| 4.0.0-beta2 | Cached · Upstream SHA-256 matched | Download | 12bf9edc…bcd470 |
| 4.0.0-beta3 | Cached · Upstream SHA-256 matched | Download | 3b261f49…1ee4c0 |
| 4.0.0-beta3-1 | Cached · Upstream SHA-256 matched | Download | 2dd495c0…7bd8db |
| 4.0.0 | Cached · Upstream SHA-256 matched | Download | e0392888…3c3134 |
| 4.1.0 | Cached · Upstream SHA-256 matched | Download | b715b8d3…4af2a7 |
| 4.2.0 | Cached · Upstream SHA-256 matched | Download | 49ea0b5f…a2337b |
| 4.2.1 | Cached · Upstream SHA-256 matched | Download | df5a4d8f…889921 |
| 4.2.2 | Cached · Upstream SHA-256 matched | Download | 22c94e5a…82127f |
| 4.3.0 | Cached · Upstream SHA-256 matched | Download | 505d0e80…26e5b8 |
| 4.3.1 | Cached · Upstream SHA-256 matched | Download | bb55f389…1f36bc |
| 4.3.2 | Cached · Upstream SHA-256 matched | Download | 8c951c9c…3d4d77 |
| 4.3.3 | Cached · Upstream SHA-256 matched | Download | cd210a09…aa81c8 |
| 4.4.0 | Cached · Upstream SHA-256 matched | Download | 814e9e88…fd1ba8 |
| 4.4.1 | Cached · Upstream SHA-256 matched | Download | b3e1cb24…50f3fa |
| 4.4.2 | Cached · Upstream SHA-256 matched | Download | 83d37c7a…ffaa90 |
| 4.5.0 | Cached · Upstream SHA-256 matched | Download | f33d6bb6…576a77 |
| 4.5.1 | Cached · Upstream SHA-256 matched | Download | a5be9ef6…1690ff |
| 4.5.2 | Cached · Upstream SHA-256 matched | Download | a11b6664…6f96e8 |
| 4.5.3 | Cached · Upstream SHA-256 matched | Download | 1fef9e8e…a79489 |
| 4.6.0 | Cached · Upstream SHA-256 matched | Download | 9b129329…d01dcd |
Dependencies
crypto "^3.0.0"
sprintf "^7.0.0"