Generate and translate standard UUIDs into shorter or just different formats and back.
A port of the JavaScript npm package short-uuid so big thanks to the author.
An example of short uuid string in default flickrBase58 alphabet:
mhvXdrZT4jP5T8vBxuvm75
Install the package with cargo
:
cargo add short-uuid
or add it to your Cargo.toml
:
[dependencies]
short-uuid = "0.1.0"
Generate short uuidv4 encoded in flickrBase58 format:
use short_uuid::ShortUuid;
let shortened_uuid = ShortUuid::generate();
Generate short uuidv4 encoded in flickrBase58 format using macro:
use short_uuid::short;
let shortened_uuid = short!();
Generate short uuidv4 using custom alphabet:
use short_uuid::{ShortUuidCustom, CustomTranslator};
let custom_alphabet = "abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ";
let translator = CustomTranslator::new(custom_alphabet).unwrap();
let custom_short = ShortUuidCustom::generate(&translator);
let custom_short_string = custom_short.to_string();
Get shortened uuid from standard uuid:
use short_uuid::ShortUuid;
// create normal uuid v4
let uuid = uuid::Uuid::new_v4();
let short = ShortUuid::from_uuid(&uuid);
Get shortened uuid from standard uuid using custom alphabet:
use short_uuid::{ShortUuidCustom, CustomTranslator};
let custom_alphabet = "abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ";
let translator = CustomTranslator::new(custom_alphabet).unwrap();
let uuid = uuid::Uuid::new_v4();
let short_custom = ShortUuidCustom::from_uuid(&uuid, &translator);
let short_custom_string = short_custom.to_string();
Get shortened uuid from uuid string:
use short_uuid::ShortUuid;
let uuid_str = "3cfb46e7-c391-42ef-90b8-0c1d9508e752";
let short_uuid = ShortUuid::from_uuid_str(&uuid_str);
Get shortened uuid from uuid string using custom alphabet:
use short_uuid::{ShortUuidCustom, CustomTranslator};
let custom_alphabet = "abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ";
let translator = CustomTranslator::new(custom_alphabet).unwrap();
let uuid_str = "3cfb46e7-c391-42ef-90b8-0c1d9508e752";
let short_custom = ShortUuidCustom::from_uuid_str(&uuid_str, &translator).unwrap();
let short_custom_string = short_custom.to_string();