kiters

Kiters (kit-rs) is a collection of Rust utilities for timestamps, request IDs, and external IDs.

Installation

Add this to your Cargo.toml:

[dependencies]
kiters = "0.3.0"

Modules

timestamp

Get the current UTC timestamp in YYYY-MM-DDTHH:MM:SSZ format.

use kiters::timestamp::get_utc_timestamp;

let ts = get_utc_timestamp();
println!("Current timestamp: {}", ts);  // 2026-01-13T12:00:00Z

Benchmarks

Using Criterion (cargo bench --bench timestamp_bench):

Getting the current time is fast (~37 ns). String formatting dominates the cost.

request_id

Fast, thread-safe request ID generator. Two widths available:

• 6 characters (36 bits, ~68 billion unique IDs) — no heap allocation
• 11 characters (66 bits, captures full u64) — no heap allocation

use kiters::request_id::{
    RequestIdGenerator, WideRequestIdGenerator,
    encode_request_id, encode_request_id_wide, as_str,
};

// 6-char generator (default)
let generator: RequestIdGenerator = RequestIdGenerator::new();
let id = generator.next_id();          // [u8; 6]
let id_str = generator.next_id_string(); // String

// 11-char wide generator (full u64 fidelity)
let wide = WideRequestIdGenerator::new();
let wide_id = wide.next_id();          // [u8; 11]

// Free functions
let id6 = encode_request_id(12345);
println!("ID: {}", as_str(&id6));       // "7CBAAA"

let id11 = encode_request_id_wide(12345);
println!("Wide: {}", as_str(&id11));    // 11-char output

// Mixed mode for random-looking output
let mixed = WideRequestIdGenerator::new_mixed();
let random_looking = mixed.next_id_string();

Benchmarks

Compared against the nanoid crate using Criterion (cargo bench):

Wide variants cost ~3 ns more than their 6-char counterparts — still ~170x faster than nanoid. The performance advantage comes from:

• No heap allocation (returns [u8; N])
• No RNG calls (deterministic counter)
• Simple bit-shift encoding vs cryptographic randomness

eid

External ID system combining a prefix with UUID bytes encoded in base36.

use kiters::eid::ExternalId;

let user_id = ExternalId::new("user");
println!("{}", user_id);  // user-abc123xyz...

let order_id = ExternalId::new("order");
println!("{}", order_id);  // order-def456...

Benchmarks

Compared against raw UUID v4 generation (cargo bench --bench eid_bench):

The bottleneck is UUID v4 generation (RNG). The base36 encoding adds minimal overhead (~3%).

Version History

License

AGPL-3.0-or-later