tincre-logger: A logging wrapper for Rust projects

tincre-logger is a simple, "zero-setup" logging library for Rust that works out-of-the-box with a familiar API.

It's designed to be efficient and easy to use, providing automatic initialization on the first log call.

Here are the logging functions included in this library:

• log() / info() for informational messages.
• warn() for warnings.
• error() for errors.
• debug() for verbose debugging messages.
• info_with(), warn_with(), error_with(), and debug_with() for structured logs with JSON metadata.

This library leverages tracing to provide structured, high-performance logging with minimal boilerplate.

Features

• Zero-Setup Logging: Automatically initializes on the first log call. No manual init() function is required in your application's main.
• Simple, Familiar API: Provides log(), info(), warn(), error(), and debug() functions in a flat logger module.
• Structured Logging Support: Use the _with() variants to attach JSON-serializable metadata to any log message.
• Environment Configuration: Respects the standard RUST_LOG environment variable to control log levels (e.g., RUST_LOG=debug).
• Colored Console Output: Prints colorful, easy-to-read logs to the console by default.
• Fully Tested: Includes a full suite of unit and integration tests to ensure reliability and correctness.

Installation

Add tincre-logger to your Cargo.toml:

cargo add tincre-logger

Usage

use tincre_logger::logger;
use serde_json::json;

fn main() {
    logger::info("Application starting up.");
    logger::warn("Configuration file not found, using defaults.");

    let user_id = "abc-123";
    logger::debug(&format!("Processing data for user: {}", user_id));
    logger::error("Failed to connect to the database!");

    // Structured logging examples
    logger::info_with("User signed in", json!({ "user_id": user_id }));
    logger::warn_with("Cache miss", json!({ "key": "user_profile", "attempts": 2 }));
    logger::error_with("Write failed", json!({ "error": "disk full", "code": 507 }));
    logger::debug_with("Loading config", json!({ "env": "staging", "source": "fallback" }));
}

To see the debug-level logs, run your application with the RUST_LOG environment variable:

RUST_LOG=debug cargo run

License

This project is licensed under the MIT License.