Uuid25 is an alternative UUID representation that shortens a UUID string to just 25 digits using the case-insensitive Base36 encoding. This library provides functionality to convert from the conventional UUID formats to Uuid25 and vice versa.
```rust use uuid25::Uuid25;
// convert from/to string let a = Uuid25::parse("8da942a4-1fbe-4ca6-852c-95c473229c7d")?; asserteq!(a, "8dx554y5rzerz1syhqsvsdw8t"); asserteq!(a.to_hyphenated(), "8da942a4-1fbe-4ca6-852c-95c473229c7d");
// convert from/to 128-bit byte array let b = Uuid25::from([0xff; 16]); asserteq!(b, "f5lxx1zz5pnorynqglhzmsp33"); asserteq!(b.to_bytes(), [0xff; 16]);
// convert from/to uuid crate's Uuid value (enabled by uuid feature) let uuidcrate = uuid::uuid!("f38a6b1f-576f-4c22-8d4a-5f72613483f6"); let c = Uuid25::from(uuidcrate); asserteq!(c, "ef1zh7jc64vprqez41vbwe9km"); asserteq!(uuid::Uuid::from(c), uuid_crate);
// convert from/to other popular textual representations let d = [ Uuid25::parse("e7a1d63b711744238988afcf12161878")?, Uuid25::parse("e7a1d63b-7117-4423-8988-afcf12161878")?, Uuid25::parse("{e7a1d63b-7117-4423-8988-afcf12161878}")?, Uuid25::parse("urn:uuid:e7a1d63b-7117-4423-8988-afcf12161878")?, ]; assert_eq!(d, ["dpoadk8izg9y4tte7vy1xt94o"; 4]);
let e = Uuid25::parse("dpoadk8izg9y4tte7vy1xt94o")?; asserteq!(e.tohex(), "e7a1d63b711744238988afcf12161878"); asserteq!(e.tohyphenated(), "e7a1d63b-7117-4423-8988-afcf12161878"); asserteq!(e.tobraced(), "{e7a1d63b-7117-4423-8988-afcf12161878}"); asserteq!(e.tourn(), "urn:uuid:e7a1d63b-7117-4423-8988-afcf12161878");
// create value in const context const K: Uuid25 = Uuid25::parseunwrap("ae5f2947-0784-48de-af26-690bc03b1f22"); asserteq!(K, "abmwj0hrnat6qdyswurn714bm"); ```
This crate implements conversion traits from/into UUID types of other popular crates. To enable
such conversion traits, turn on the corresponding crate features. For example, to enable
conversion from/into uuid::Uuid, put the following entries in Cargo.toml:
toml
[dependencies]
uuid = { version = "<version>", features = ["v4"] }
uuid25 = { version = "<version>", features = ["uuid"] }
And then:
```rust use uuid25::Uuid25;
let x: Uuid25 = uuid::Uuid::new_v4().into(); println!("{}", x); // e.g. "6n7pvwv8r54xycmuby0pp1q8a"
let y: uuid::Uuid = x.into(); println!("{}", y); // e.g. "703d4a3e-5f1a-473e-90dd-fe20c883780a" ```
Default features:
std integrates this crate with std and enables integration with std::string::String
and std::error::Error. Note that this crate does not rely a lot on std and most of
the functionality of this crate is still available under no_std environments.Optional features:
serde enables serialization/deserialization of Uuid25 values through serdeuuid enables conversion traits from/into uuid::Uuidbson enables conversion traits from/into bson::Uuiduuid7 enables conversion traits from/into uuid7::UuidLicensed under the Apache License, Version 2.0.