Crate unique_id

A trait and implementations for unique ID generators.

This crate provides a very simple trait, Generator, that will return successive unique identifiers. Two implementations of this trait are provided which provide unique string and integer values respectively.

Example

The following shows an example of the StringGenerator implementation.

use unique_id::Generator;
use unique_id::string::StringGenerator;

let gen = StringGenerator::default();
let mut last = gen.next_id();
for _ in 1..100_000 {
    let next = gen.next_id();
    assert_ne!(last, next);
    last = next;
}

Modules

random	An implementation that provides random 128-bit unsigned integer values.
sequence	An implementation that provides monotonically increasing integer values.
string	An implementation that provides unique string values.

Traits

Generator	The primary ID generator trait, it provides for generating a new ID with next_id(). There is no implication that this returns any overall sequence of values, only that it returns a unique value for each call.
GeneratorFromSeed	While it is required for a generator to support the Default trait, in some cases it is useful to create a new generator some some known initial value, the seed.
GeneratorFromStr	If the type T implements FromStr then the associated function is_valid_value determines whether the value s is valid as an ID value.
GeneratorWithInvalid	For generators that are able to reserve a unique value that is not valid as an ID.