uuid-by-string 2.0.5

Generating uuid-hash from string
Documentation

uuid-by-string NPM Downloads

Generates the RFC-4122 Name-Based UUID. Supports 3 and 5 versions of UUID with and without a namespace.

Note: generating UUID v3 and v5 without a namespace is non-standard (the RFC-4122 covers only the case when you concatenate the namespace with the name, so if you want a reproducable result in other progrmming langiages you need to generate UUID with some namespace, e.g. nil)

According to the implementation differences, it's impossible to replicate results of the no-namespace UUID generation with a standard generation, so keep that in mind.

This library is rewritten from Danakt Saushkin's JavaScript library of the same name. All features and tests are in place.

Installation

cargo add uuid-by-string

Usage

use uuid_by_string::generate_uuid::{generate_uuid};
// Note: generating UUID v3 and v5 without namespace is non-standard
generate_uuid("hello world")
//"2aae6c35-c94f-5fb4-95db-e95f408b9ce9";

// For namespace generation enable feature "namespaces"
use uuid_by_string::generate_uuid_with_namespace::{generate_uuid_with_namespace};
generate_uuid_with_namespace("hello world", "d3486ae9-136e-5856-bc42-212385ea7970").unwrap()
//"1825ed38-348f-5b46-99de-fd84b83aba5e"

The string hello world will always return 2aae6c35-c94f-5fb4-95db-e95f408b9ce9.

You can specify the UUID version. Available versions is 3 and 5 according to RFC-4122. The version is responsible for the hashing algorithm: version 3 uses MD5, and version 5 uses SHA-1. UUIDv5 is used by default if version is not specified.

use uuid_by_string::generate_uuid::{generate_uuid_v3, generate_uuid_v5};

// For namespace generation enable feature "namespaces"
use uuid_by_string::generate_uuid_with_namespace::{generate_uuid_with_namespace_v3, generate_uuid_with_namespace_v5};

fn main() {
    // Note: generating UUID v3 and v5 without namespace is non-standard
    assert_eq!(generate_uuid_v3("hello world"), "5eb63bbb-e01e-3ed0-93cb-22bb8f5acdc3");
    assert_eq!(generate_uuid_v5("hello world"), "2aae6c35-c94f-5fb4-95db-e95f408b9ce9");

    // For namespace generation enable feature "namespaces"
    assert_eq!(generate_uuid_with_namespace_v3("hello world", "d3486ae9-136e-5856-bc42-212385ea7970"), Ok("c8aeb76a-1204-3f07-995e-5c5fa3494b7f".to_owned()));
    assert_eq!(generate_uuid_with_namespace_v3("hello world", "D3486AE9-136e-5856-bc42-212385ea7970"), Ok("c8aeb76a-1204-3f07-995e-5c5fa3494b7f".to_owned()));
    assert_eq!(generate_uuid_with_namespace_v5("hello world", "d3486ae9-136e-5856-bc42-212385ea7970"), Ok("1825ed38-348f-5b46-99de-fd84b83aba5e".to_owned()));
    assert_eq!(generate_uuid_with_namespace_v5("hello world", "D3486AE9-136e-5856-bc42-212385ea7970"), Ok("1825ed38-348f-5b46-99de-fd84b83aba5e".to_owned()));
}

Replacement

You can (and should) replace this library with https://docs.rs/uuid/. The code whould look like this:

let uuid = Uuid::new_v3(&Uuid::nil(), b"Hello world!");
let uuid = Uuid::new_v5(&Uuid::nil(), b"Hello world!");

Since generating a UUID v3 and v5 without namespace is non-standard you either have to stick with this library or rely on your own implementation of the following methods of this library:

generate_uuid
generate_uuid_v3
generate_uuid_v5

More info about replacement: