#uuid #random #id #url

nanoid

A tiny, secure, URL-friendly, unique string ID generator for Rust

6 releases

0.3.0 Feb 8, 2020
0.2.0 Jan 7, 2018
0.1.3 Jan 6, 2018
0.1.0 Dec 26, 2017

#21 in Algorithms

Download history 581/week @ 2020-02-05 463/week @ 2020-02-12 457/week @ 2020-02-19 704/week @ 2020-02-26 690/week @ 2020-03-04 808/week @ 2020-03-11 498/week @ 2020-03-18 578/week @ 2020-03-25 685/week @ 2020-04-01 587/week @ 2020-04-08 442/week @ 2020-04-15 346/week @ 2020-04-22 561/week @ 2020-04-29 723/week @ 2020-05-06 945/week @ 2020-05-13 917/week @ 2020-05-20

2,352 downloads per month
Used in 25 crates (20 directly)

MIT license

13KB
125 lines

Nano ID

Package version License Travis build status Appveyor build status Maintenance intention for this crate

A tiny, secure, URL-friendly, unique string ID generator for Rust

extern crate nanoid;
use nanoid::nanoid;

fn main() {
   let id = nanoid!(); //=> "Uakgb_J5m9g-0JDMbcJqLJ"
}

Safe. It uses cryptographically strong random APIs and guarantees a proper distribution of symbols.

Compact. It uses a larger alphabet than UUID (A-Za-z0-9_-) and has a similar number of unique IDs in just 21 symbols instead of 36.

Usage

Simple

The main module uses URL-friendly symbols (A-Za-z0-9_-) and returns an ID with 21 characters.

extern crate nanoid;
use nanoid::nanoid;

fn main() {
   let id = nanoid!(); //=> "Uakgb_J5m9g~0JDMbcJqLJ"
}

Symbols -,.() are not encoded in the URL. If used at the end of a link they could be identified as a punctuation symbol.

Custom length

If you want to reduce ID length (and increase collisions probability), you can pass the length as an argument generate function:

extern crate nanoid;
use nanoid::nanoid;

fn main() {
   let id = nanoid!(10); //=> "IRFa-VaY2b"
}

Custom Alphabet or Length

If you want to change the ID's alphabet or length you can use the low-level custom module.

extern crate nanoid;
use nanoid::nanoid;

fn main() {
    let alphabet: [char; 16] = [
        '1', '2', '3', '4', '5', '6', '7', '8', '9', '0', 'a', 'b', 'c', 'd', 'e', 'f'
    ];

   let id = nanoid(10, &alphabet); //=> "4f90d13a42"
}

Alphabet must contain 256 symbols or less. Otherwise, the generator will not be secure.

Custom Random Bytes Generator

You can replace the default safe random generator using the complex module. For instance, to use a seed-based generator.

extern crate nanoid;
use nanoid::nanoid;

fn randomByte () -> u8 { 0 }

fn main() {
    fn random (size: usize) -> Vec<u8> {
        let mut bytes: Vec<u8> = vec![0; size];

        for i in 0..size {
            bytes[i] = randomByte();
        }

        bytes
    }

    nanoid!(10, &['a', 'b', 'c', 'd', 'e', 'f'], random); //=> "fbaefaadeb"
}

random function must accept the array size and return an vector with random numbers.

If you want to use the same URL-friendly symbols with format, you can get the default alphabet from the url module:

extern crate nanoid;
use nanoid::nanoid;

fn random (size: usize) -> Vec<u8> {
    let result: Vec<u8> = vec![0; size];

    result
}

fn main() {
    nanoid!(10, &nanoid::alphabet::SAFE, random); //=> "93ce_Ltuub"
}

Other Programming Languages

Dependencies

~535KB