Cuids are "Collision-resistant ids optimized for horizontal scaling and binary search lookup performance."
This is a rust implementation of the CUID library, the original JavaScript implementation of which may be found here
In cargo.toml
toml
cuid = "1.0.2"
```rust use cuid;
fn main() -> () { println!("{}", cuid::cuid().unwrap()); println!("{}", cuid::slug().unwrap()); } ```
cuid is safe to use across threads. When used in a multithreaded context, all
threads share the same atomic counter, which is used as a component of the
generated CUID.
This package also provides a binary:
```sh
cargo run cuid ckmqrwysb0000iz5p4u1b79hd ```
Performance is one of the primary concerns of this library (see Benchmarking, below).
This implementation is currently about 20x faster than the reference JavaScript implementation.
It takes about 400 nanoseconds to generate a CUID, or 335 nanoseconds to generate a CUID slug, on relatively modern desktop hardware.
In a long-running process or thread, CUID generation is faster, since the system fingerprint is calculated once and then re-used for the lifetime of the process. In this case, CUID generation takes about 125 ns.
Tests can be run with
text
cargo test
Note that some tests require tests run in a single thread. These are ignored by default. They can be run with:
text
cargo test -- --ignored --test-threads=1
Inline benchmarks are available when running with the nightly toolchain. There
are also criterion bnechmarks in benches/cuid.rs.
If you're on a Linux system, it's recommended to run benchmarks with the
maximum possible priority, via nice, in order to avoid confounding effects
from other processes running on the system:
text
$ nice -n -20 cargo bench