Crate commons 

Commons

Shared Rust utilities and common patterns for the Sebastien Rousseau ecosystem.

This crate provides reusable components, traits, and utilities used across multiple Rust projects in the ecosystem.

Features

• config - Configuration file loading and management (TOML)
• error - Common error types and Result aliases
• logging - Near-lock-free structured logging engine
• time - Date/time utilities and formatting
• collections - Extended collection utilities (LRU cache)
• validation - Input validation utilities
• retry - Retry logic with backoff strategies
• id - ID generation (timestamp, random, UUID-like)
• env - Environment variable helpers
• fs - Cross-platform filesystem utilities

Quick Start

use commons::prelude::*;

// Use the LRU cache
let mut cache = LruCache::new(100);
cache.insert("key", "value");

Feature Flags

Enable only what you need:

[dependencies]
commons = { version = "0.0.3", default-features = false, features = ["error", "time"] }

Modules

collectionscollections

Specialized data structures and collection utilities.

configconfig

Configuration management utilities.

countercounter

Portable monotonic counters for targets without 64-bit atomics. A monotonic u64 counter that works without 64-bit atomics.

envenv

Environment variable utilities.

errorerror

Common error types and handling utilities.

fsfs

Cross-platform filesystem utilities.

idid

ID generation utilities.

logginglogging

Near-lock-free structured logging engine.

prelude

Prelude module for convenient imports.

retryretry

Retry logic with configurable backoff strategies.

timetime

Time handling and duration utilities.

validationvalidation

Input validation utilities.

Macros

loggerlogging

Create a logger for the current module.

logging_mcp_notifylogging

Emit an MCP-formatted state transition notification.

logging_spanid and logging

Execute a block within an OTLP-tagged span.

logging_time_itlogging

Measure wall-clock latency of a block and emit a Logfmt metric.

Constants

VERSION

Crate version.

Functions

version

Returns the crate version.