cuid2 0.1.6

An implementation of the CUID2 protocol in rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# cuid2

[![Build Status](https://github.com/mplanchard/cuid-rust/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/mplanchard/cuid-rust/actions/workflows/ci.yml?query=branch%3Amaster)
[![Crates.io](https://img.shields.io/crates/v/cuid2 "Crates.io")](https://crates.io/crates/cuid2/)
[![docs.rs](https://docs.rs/cuid2/badge.svg)](https://docs.rs/cuid2/)

Secure, collision-resistant ids optimized for horizontal scaling and
performance.

This is a Rust implementation of the CUID2 algorithm, defined by its
reference implementation [here](https://github.com/paralleldrive/cuid2).

Please see that repository for a discussion of the benefits of CUIDs, as
well as for the changes in CUID2 relative to the original CUID algorithm.

Both algorithms are available via the [cuid] crate, while the CUID1
algorithm is available via the [cuid1] crate.

## Usage

The simplest usage is to use the `create_id()` function to create an ID:

```
use cuid2;

let id = cuid2::create_id();

assert_eq!(24, id.len());
```

A `cuid()` alias is provided to make this more of a drop-in replacement for
the v1 cuid package:

```
use cuid2::cuid;

let id = cuid();

assert_eq!(24, id.len());
```

If you would like to customize aspects of CUID production, you can create
a constructor with customized properties:

```
use cuid2::CuidConstructor;

let constructor = CuidConstructor::new().with_length(32);

let id = constructor.create_id();

assert_eq!(32, id.len());
```

If installed with `cargo install`, this package also provides a `cuid2`
binary, which generates a CUID on the command line. It can be used like:

```
> cuid2
y3cfw1hafbtezzflns334sb2
```

[cuid]: https://crates.io/crates/cuid/
[cuid1]: https://crates.io/crates/cuid1/
[cuid2]: https://crates.io/crates/cuid2/