#uuid #guid #serialization #segment #generate #io #base62

ksuid

A library for efficiently generating, parsing and serializing Segment.io KSUIDs

2 unstable releases

Uses old Rust 2015

0.2.0 Jun 19, 2017
0.1.0 Jun 15, 2017

#9 in #base62

Download history 29/week @ 2024-04-07 50/week @ 2024-04-14 45/week @ 2024-04-21 51/week @ 2024-04-28 54/week @ 2024-05-05 47/week @ 2024-05-12 47/week @ 2024-05-19 96/week @ 2024-05-26 67/week @ 2024-06-02 36/week @ 2024-06-09 49/week @ 2024-06-16 39/week @ 2024-06-23 58/week @ 2024-06-30 26/week @ 2024-07-07 39/week @ 2024-07-14 26/week @ 2024-07-21

154 downloads per month
Used in 4 crates (3 directly)

MIT license

19KB
294 lines

Version Docs

Ksuid

KSUID stands for K-Sortable Unique IDentifier, a globally unique identifier used by Segment.

KSUIDs incorporate a timestamp with 1-second resolution, allowing them to be (roughly) sorted chronologically, as well as a 128-bit random payload in the style of UUIDv4. They can be serialized using a Base62 encoding for compatibility with environments which only support alphanumeric data. The lexicographic ordering of both the binary and string representations preserves the chronological ordering of the embedded timestamp.

See the canonical implementation for more information.

The author of this package is not affiliated with Segment.

This repository contains two separate crates, a library (ksuid) for generating, parsing and serializing KSUIDs and a simple CLI (ksuid-cli) which exposes a subset of this functionality for interactive use.

Benchmarks

The library includes some benchmarks to compare its performance against the canonical implementation. However, the benchmarks use rust's unstable test crate, so they are hidden behind a feature flag. Execute cargo bench --features bench with a nightly version of the compiler to run the benchmarks.

Dependencies

~1–1.5MB
~23K SLoC