Function compute_hash 

pub fn compute_hash(input: &str) -> String

Compute a 5-character base62 hash from an input string

Uses xxHash3 with the WDP seed 0x000031762D706477 to ensure deterministic results across compilations and platforms.

Note: This function does NOT normalize input (no uppercase conversion). For WDP-conformant hashing with normalization, use compute_wdp_hash.

Examples

use waddling_errors_hash::compute_hash;

let hash = compute_hash("E.AUTH.TOKEN.001");
assert_eq!(hash.len(), 5);
assert!(hash.chars().all(|c| c.is_ascii_alphanumeric()));

Determinism

The same input will always produce the same hash:

use waddling_errors_hash::compute_hash;

let hash1 = compute_hash("E.AUTH.TOKEN.001");
let hash2 = compute_hash("E.AUTH.TOKEN.001");
assert_eq!(hash1, hash2);

Examples found in repository

examples/global_config.rs (line 37)

fn main() {
    println!("🦆 WDP-Compliant Hash Configuration Example");
    println!("===========================================\n");

    // 1. Default behavior (WDP-compliant)
    println!("1. WDP-Compliant Default Configuration");
    println!("   Algorithm: xxHash3 (WDP-specified)");
    println!("   Seed: 0x{:016X} (WDP v1 seed)", WDP_SEED);
    let default_hash = compute_hash("E.AUTH.TOKEN.001");
    println!("   Hash: {}\n", default_hash);

    // 2. Load global configuration
    println!("2. Load Global Configuration");
    let global_config = load_global_config();
    println!("   Algorithm: {}", global_config.algorithm.as_str());
    println!("   Seed: 0x{:016X}", global_config.seed);

    let global_hash = compute_hash_with_config("E.AUTH.TOKEN.001", &global_config);
    println!("   Hash: {}\n", global_hash);

    // 3. Per-diagnostic seed overrides (for testing/isolation)
    println!("3. Custom Seed Override (for testing)");

    // Override seed (e.g., for tenant isolation in tests)
    let custom_seed_config = apply_overrides(&global_config, Some(0x12345678));
    let custom_seed_hash = compute_hash_with_config("E.AUTH.TOKEN.001", &custom_seed_config);
    println!("   Override seed to 0x12345678:");
    println!("   Hash: {}", custom_seed_hash);

    // No override (uses global)
    let no_override_config = apply_overrides(&global_config, None);
    let no_override_hash = compute_hash_with_config("E.AUTH.TOKEN.001", &no_override_config);
    println!("   No override (same as global):");
    println!("   Hash: {}\n", no_override_hash);

    // 4. Different error codes with same config
    println!("4. Multiple Error Codes (same config)");
    let codes = [
        "E.AUTH.TOKEN.001",
        "E.AUTH.SESSION.002",
        "E.DB.CONNECTION.003",
        "E.CACHE.MISS.004",
    ];

    for code in &codes {
        let hash = compute_hash_with_config(code, &global_config);
        println!("   {} → {}", code, hash);
    }

    println!("\n✅ WDP-compliant hashes ensure cross-platform consistency!");

    // 5. Configuration priority demonstration
    println!("\n5. Configuration Priority Order");
    println!("   1. Per-diagnostic seed override (highest)");
    println!("   2. Environment variable WADDLING_HASH_SEED");
    println!("   3. Cargo.toml hash_seed");
    println!("   4. WDP default seed (0x000031762D706477)\n");

    // Check if environment variable is set
    match option_env!("WADDLING_HASH_SEED") {
        Some(seed) => {
            println!("   📌 Environment variable detected:");
            println!("      WADDLING_HASH_SEED={}", seed);
        }
        None => {
            println!("   ℹ️  No environment variable set");
            println!("      Using WDP default seed");
        }
    }

    println!("\n🎯 WDP ensures cross-language compatibility!");
    println!("   Same error code produces same hash in:");
    println!("   - Rust, Python, JavaScript, Go, Java, C, etc.");
}