snowid 2.0.3

A Rust library for generating SnowID - a Snowflake-like timestamp-based distributed unique identifier
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

use chrono::{DateTime, Utc};
use snowid::{SnowID, SnowIDConfig};

fn main() {
    // Create a custom configuration for many nodes (16 bits = 65,536 nodes)
    let config = SnowIDConfig::builder()
        .epoch(1577836800000) // 2020-01-01 00:00:00 UTC
        .node_bits(16) // 16 bits for node ID = 65536 nodes
        .unwrap()
        .build();

    // Create generator with node ID 42
    let generator = SnowID::with_config(42, config).unwrap();

    println!("Base62 Generator configuration:");
    println!("  Node bits: {}", generator.config.node_bits());
    println!("  Sequence bits: {}", generator.config.sequence_bits());
    println!("  Max node ID: {}", generator.config.max_node_id());
    println!("  Max sequence ID: {}", generator.config.max_sequence_id());
    println!("  Epoch: {}", generator.config.epoch());

    // Generate and analyze an ID
    let encoded_id = generator.generate_base62();
    let raw_id = generator.decode_base62(&encoded_id).unwrap();
    let (ts, node, seq) = generator.extract.decompose(raw_id);

    // Calculate the actual timestamp
    let timestamp: u64 = ts + generator.config.epoch();
    let datetime = DateTime::<Utc>::from_timestamp_millis(timestamp as i64).unwrap();

    println!("\nGenerated Base62 ID: {encoded_id}");
    println!("Raw ID value: {raw_id}");
    println!("Components:");
    println!("  Timestamp: {ts} ms since epoch");
    println!("  Human date: {datetime}");
    println!("  Node ID: {node} (of {})", generator.config.max_node_id());
    println!(
        "  Sequence: {} (of {})",
        seq,
        generator.config.max_sequence_id()
    );

    // Generate a few more IDs to demonstrate monotonicity
    println!("\nGenerating a sequence of IDs:");
    for _ in 0..3 {
        let (encoded_id, raw_id) = generator.generate_base62_with_raw();
        let (ts, node, seq) = generator.extract.decompose(raw_id);
        println!("  Base62: {encoded_id}, Raw: {raw_id}");
        println!("    → Timestamp: {ts}, Node: {node}, Sequence: {seq}");
    }
}