tokenless-core

Shared core types and utilities for the tokenless workspace.

Part of the tokenless toolkit.

Why tokenless-core?

Every tokenless crate needs validated configuration, path traversal protection, and a unified error type. Rather than duplicating these across 6 crates, tokenless-core provides them once — with compile-time safety guarantees:

• Config validates at construction, not at use-site
• SafePath rejects .., /, and NUL bytes — you can't accidentally construct a dangerous path
• CoreError gives the whole workspace a single Result<T> alias

Quick Start

[dependencies]
tokenless-core = "0.4"

use tokenless_core::{Config, SafePath, CoreError};

// Validated configuration
let config = Config::new("my-app")?
    .with_description("CLI tool");

// Path traversal-safe relative paths (rejects "..", "/", and NUL at construction)
let safe = SafePath::new("data/cache")?;
let display_path = safe.as_path().display();

// Unified error handling
fn do_work() -> tokenless_core::Result<()> {
    Ok(())
}

Types

Config

Validated runtime configuration.

SafePath

Path traversal-resistant relative path. Rejects .., absolute paths, and NUL bytes at construction time — no runtime checks needed.

CoreError

Unified error type (#[non_exhaustive]). Variants: Io, Serialization, App, Path.

Result<T>

Type alias for std::result::Result<T, CoreError>.

Minimum Rust Version

Rust 2024 edition, MSRV 1.89.

License: Apache-2.0