📜 Cirious Codex Logger

Structured Logging & Tracing for the Cirious Ecosystem

📖 Overview

Cirious Codex Logger is a highly optimized, foundational library for structured logging and event tracing. It provides efficient mechanisms for capturing, formatting, and dispatching application events with rich metadata.

Designed to be the ultimate observability bedrock for tools and applications within the Cirious ecosystem, prioritizing performance, structural integrity, and seamless terminal integration.

✨ Features

Core logging macros (trace, debug, info, warn, error).
Extensible output formatters (JSON, human-readable terminal).
Pluggable dispatchers (stdout, stderr, rolling files).
Integration with cirious_codex_term for rich, native terminal styling.

🚀 Quick Start

Add the following to your Cargo.toml:

[dependencies]
cirious_codex_logger = "0.1"

And then in your code:

use cirious_codex_logger::{debug, error, info, trace, warn};
 
fn main() {
  info!("Application started successfully.");
  debug!("Debugging an internal variable: {}", 42);
  warn!("Memory usage is high.");
  error!("Failed to connect to the database.");
  trace!("Tracing execution flow.");
}

🚧 Current Status & Roadmap

The architecture is currently being mapped out for the initial v0.2 release:

Global Logger Registration (OnceLock integration for macros).
Context & Metadata Enrichment (timestamp, module_path, file, line).
Log Filtering (Level & Module-based filtering capabilities).
Non-blocking / Async Dispatching (Background thread queueing).
Rolling File Dispatcher (Size or Date-based file rotation).

📜 License

Licensed under either of the following, at your option: