Crate squint

Source
Expand description

§Squint

github crates.io docs.rs build status

Squint is a library for encoding integers as unique deterministic strings.

It is expected to be used for encoding database IDs as random strings to get fast indexed database lookups and hide actual IDs from the end users.

Library also provides an easy way to introduce different ID types (i.e. UserId(1) shouldn’t be equal to CrateId(1) even though the underlying integer value is the same).

§Usage

Basic example

use squint::aes::{cipher::KeyInit, Aes128};

type Id = squint::Id<0>;

let key = [0; 16];
let cipher = Aes128::new(&key.into());

let id = Id::new(1, &cipher);
let encoded = id.to_string();
assert_eq!("xZV3JT8xVMefhiyrkTsd4T2", &encoded);

let decoded = encoded
    .parse::<Id>()
    .and_then(|id| id.to_raw(&cipher))
    .unwrap();
assert_eq!(decoded, 1);

Different ID types

use squint::{
    aes::{cipher::KeyInit, Aes128},
    tag, Id,
};

type UserId = Id<{ tag("user") }>;

type CrateId = Id<{ tag("crate") }>;

let key = [0; 16];
let cipher = Aes128::new(&key.into());

let user_id = UserId::new(1, &cipher);
let crate_id = CrateId::new(1, &cipher);

assert_eq!("qXfXkNN9ReZCGXu3qi28xC2", &user_id.to_string());
assert_eq!("VgtE1tzjDEHnjd3fh3PwiT2", &crate_id.to_string());

§Comparison

UUID(v4)

§Pros
  • The most adopted standard for public resource IDs
§Cons
  • Not sequential, hence slower database inserts

Cuid and NanoID are similar to UUID relative to this crate


ULID

§Pros
  • Lexicographically sortable
  • Compatible with UUID
§Cons
  • Contain creation timestamps

Sqids

§Pros
  • Can encode multiple numbers in one ID
  • Enable use of auto-incrementing database primary keys
§Cons
  • Increased code complexity
  • Can be decoded revealing ID count
  • No built-in solution to ID reuse across entities

This crate

§Pros
  • Enable use of auto-incrementing database primary keys
  • Cryptographically secure
§Cons
  • Increased code complexity

Re-exports§

pub use aes;

Structs§

Id

Enums§

Error

Functions§

tag

Type Aliases§

Result