#identifier

no-std ulid

a Universally Unique Lexicographically Sortable Identifier implementation

21 releases (6 stable)

1.1.3 Jul 13, 2024
1.1.2 Feb 3, 2024
1.1.1 Jan 31, 2024
1.1.0 Sep 11, 2023
0.2.2 Jul 28, 2017

#12 in Algorithms

Download history 57113/week @ 2024-07-03 62434/week @ 2024-07-10 57621/week @ 2024-07-17 63408/week @ 2024-07-24 57845/week @ 2024-07-31 60976/week @ 2024-08-07 58850/week @ 2024-08-14 59076/week @ 2024-08-21 58415/week @ 2024-08-28 66133/week @ 2024-09-04 61519/week @ 2024-09-11 64424/week @ 2024-09-18 63931/week @ 2024-09-25 64225/week @ 2024-10-02 67254/week @ 2024-10-09 81745/week @ 2024-10-16

291,824 downloads per month
Used in 316 crates (158 directly)

MIT license

42KB
701 lines

ulid-rs

Build Status Crates.io docs.rs

This is a Rust implementation of the ulid project which provides Universally Unique Lexicographically Sortable Identifiers.

Quickstart

use ulid::Ulid;

// Generate a ulid
let ulid = Ulid::new();

// Generate a string for a ulid
let s = ulid.to_string();

// Create from a String
let res = Ulid::from_string(&s);

assert_eq!(ulid, res.unwrap());

Crate Features

  • std (default): Flag to toggle use of std and rand. Disable this flag for #[no_std] support.
  • serde: Enables serialization and deserialization of Ulid types via serde. ULIDs are serialized using their canonical 26-character representation as defined in the ULID standard. An optional ulid_as_u128 module is provided, which enables serialization through an Ulid's inner u128 primitive type. See the documentation and serde docs for more information.
  • uuid: Implements infallible conversions between ULIDs and UUIDs from the uuid crate via the std::convert::From trait.

Benchmark

Benchmarks were run on my desktop (Win 10/WSL2 Ubuntu; Ryzen 7 5950x). Run them yourself with cargo bench.

test bench_from_string        ... bench:          13 ns/iter (+/- 0)
test bench_from_time          ... bench:          13 ns/iter (+/- 0)
test bench_generator_generate ... bench:          29 ns/iter (+/- 0)
test bench_new                ... bench:          31 ns/iter (+/- 1)
test bench_to_str             ... bench:           7 ns/iter (+/- 0)
test bench_to_string          ... bench:          19 ns/iter (+/- 0)

Dependencies

~0–1MB
~21K SLoC