short-uuid 0.2.1

A library to generate and parse short uuids
Documentation

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

Serialize and deserialize struct with short uuid (you must enable the serde feature):

[dependencies]
short-uuid = { version = "0.2.0", features = ["serde"] }

Example usage:

#[cfg(feature = "serde")]
#[derive(Serialize, Deserialize, PartialEq, Debug)]
struct TestStruct {
    id: ShortUuid,
}

#[cfg(feature = "serde")]
fn example() {
    let uuid_str = "0408510d-ce4f-4761-ab67-2dfe2931c898";
    let short_id = ShortUuid::from_uuid_str(uuid_str).unwrap();

    let test_struct = TestStruct {
        id: short_id,
    };

    let serialized = serde_json::to_string(&test_struct).unwrap();
}

References