radim10 / short-uuid

Generate and translate standard uuids into shorter formats and back.

short-uuid

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

Getting started

Install the package with cargo:

cargo add short-uuid

or add it to your Cargo.toml:

[dependencies]
short-uuid = "0.1.0"

Examples

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();

References

• Wikipedia: Universally Unique Identifier
• uuid crate