timeid

A compact, time-based unique ID generator with SQLite tracking. Each ID encodes the current Unix timestamp using a custom base character set and ensures uniqueness by storing used IDs in a local SQLite database (~/.timeid.sqlite by default).

📦 Features

• 🔒 Guarantees uniqueness by checking past IDs in a local database.
• 📆 Easily decodes IDs back to human-readable timestamps.
• 📝 Optional memo and tag can be saved with each ID.
• 💾 Uses SQLite under the hood for lightweight local persistence.

🔧 Usage

Add to your Cargo.toml:

[dependencies]
timeid = "0.0.1"

Then use in your code:

use timeid::TimeId;

fn main() -> rusqlite::Result<()> {
    let id = TimeId::gen()?;                   // Generate a new ID
    println!("Generated ID: {}", id);

    let readable = TimeId::parse(&id);         // Parse ID back to datetime
    println!("Parsed: {}", readable);

    let count = TimeId::status()?;             // Check total generated
    println!("Stored rows: {}", count);

    Ok(())
}

🔁 Resetting the Database

You can reset the SQLite database:

TimeId::reset(None)?;

This deletes and recreates the default ~/.timeid.sqlite.

🧪 Testing

To test:

cargo test -- --nocapture

📁 Storage Path

By default, the SQLite file is stored at:

• macOS/Linux: ~/.timeid.sqlite
• Windows: %USERPROFILE%/.timeid.sqlite

You can override the path by passing a custom one to reset() or modifying the internal init() function.

📜 License

MIT License

✨ Author

Nick (@loyoming)