uid
| Crates.io | uid |
| lib.rs | uid |
| version | 0.1.8 |
| source | src |
| created_at | 2018-10-22 13:43:08.102165 |
| updated_at | 2024-09-11 09:42:50.49822 |
| description | A crate for the creation of unique IDs. |
| homepage | https://github.com/d-e-s-o/uid |
| repository | https://github.com/d-e-s-o/uid.git |
| max_upload_size | |
| id | 91979 |
| size | 49,776 |
Daniel Müller (d-e-s-o)
documentation
README
uid
uid (short for unique identifiers) is a crate for creating
unique IDs for usage in a Rust program. IDs can have many purposes in
programs, but this crate's IDs are mostly useful for identification
tasks. For example, consider having some form of simple in-memory
database (in the form of a HashMap or something more sophisticated).
IDs as created by this crate make for perfect primary keys.
Said IDs have a couple properties that, depending on the context, are useful to have:
-
IDs are lightweight and ultimately just a number with some compile time magic (and a small creation cost) attached to them.
-
Created IDs are guaranteed to be unique. That is, when created at runtime (deserialization is not supported for obvious reasons), two newly crated IDs are guaranteed to never be the same.
-
They are fully thread safe. That is, uniqueness is guaranteed even among different threads.
-
IDs are immutable. Once created, an ID can (potentially) be copied, hashed, compared, and more, but it cannot be changed.
-
IDs can form name (or rather type) spaces. That is, an ID can be parametrized by an arbitrary (potentially private) type and only IDs that are parametrized by the same type can interact (i.e., be compared etc.).