Crate log4you

log4you

Structured logging for Rust with dynamic UUID log IDs, built on log4rs.

log4you is a lightweight logging crate, designed for applications that need consistent, structured logging with unique log identifiers (UUIDs). It allows simple, efficient, and consistent logging with unique log IDs for each request.

✨ Features

• 🔧 Powered by log4rs, configure logging dynamically with YAML configuration files, compatible with the standard Rust log facade
• ✅ Structured logging with automatic UUID log IDs
• 🆔 Generates a unique log_id (UUID v7) per log entry
• 🪄 Easy-to-use macros: log_info!, log_error!, etc.
• 🛠️ Supports dynamic config paths, log rotation, and file size management
• 🚀 Easy setup and integration — works out of the box
• 🧵 Great for async or multi-threaded apps

Perfect for microservices, APIs, and any system where traceability and clean logs matter.

📦 Installation

Add log4you to your Cargo.toml:

[dependencies]
log4you = "0.1.1"

Or, use cargo-edit to add it directly from your terminal:

cargo add log4you

⚙️ Example YAML Configuration

See the log4rs configuration documentation for more details.

appenders:
  stdout:
    kind: console
    encoder:
      pattern: "[{d(%Y-%m-%dT%H:%M:%S%.6f)} {h({l})} {f}:{L}] - {m}{n}"
 
  log4you:
    kind: rolling_file
    path: "logs/log4you.log"
    policy:
      kind: compound
      trigger:
        kind: size
        limit: 100MB
      roller:
        kind: fixed_window
        pattern: "logs/log4you-{}.log"
        count: 5
    encoder:
      pattern: "[{d(%Y-%m-%dT%H:%M:%S%.6f)} {h({l})} {f}:{L}] - {m}{n}"
 
root:
  level: info
  appenders:
    - stdout
 
loggers:
  log4you:
    level: debug
    appenders:
      - log4you

🛠️ Usage Example

use log4you::{logger::Logger, log_id, log_info, log_info_with_id};
 
fn main() {
    let logid = log_id!();
    // Initialize the logger with a log_id, a path to the YAML config, and the service name
    Logger::init(&logid,  Some("config/log4you.yaml"), Some("log4you"));
 
    // Log an info message, logid will be generated automatically
    log_info!("Service started");
 
    // Log an info message, logid is defined by yourself
    let custom_log_id = log_id!();
    log_info_with_id!(custom_log_id, "This log uses custom log_id");
}

Author

Jerry Maheswara jerrymaheswara@gmail.com

📖 License

This project is licensed under the Apache-2.0 license.

---

Built with ❤️ in Rust

---

Changelog

[v0.1.2]

• Re-export log as __log_crate to support internal macro resolution without requiring users to depend on log explicitly.
• Re-export uuid as __uuid_crate for similar internal macro usage convenience.

Re-exports

pub use log as __log_crate;

pub use uuid as __uuid_crate;

Modules

logger

Logger implementation and utilities used internally for structured logging.

macros

Macros wrapped to avoid requiring direct dependencies from the end user.

utils

Utility functions and helpers used internally across the crate.

Macros

log_debug

Logs a debug-level message with a dynamically generated log_id.

log_debug_with_id

Logs a debug-level message with a custom log_id provided as a parameter.

log_error

Logs an error-level message with a dynamically generated log_id.

log_error_with_id

Logs an error-level message with a custom log_id provided as a parameter.

log_id

A macro to generate a log ID based on the current time using the LogIdFormat trait.

log_info

Logs an info-level message with a dynamically generated log_id.

log_info_with_id

Logs an info-level message with a custom log_id provided as a parameter.

log_warn

Logs a warning-level message with a dynamically generated log_id.

log_warn_with_id

Logs a warning-level message with a custom log_id provided as a parameter.