Comparison¶

At a glance¶

Logust¶

• Rust core and high throughput
• Loguru-style API
• Rotation, retention, JSON, async writes

Loguru¶

• Rich sink options
• More built-in record fields
• Long-established ecosystem

logging¶

• Standard library
• Very configurable but verbose
• Slower by default

Benchmarks (10,000 messages)¶

Results below are from one recent release-build run of the included benchmark suite (benchmarks/bench_throughput.py) on the current maintainer machine. Use benchmarks/README.md to reproduce them in your environment.

Summary¶

Logust stayed in the mid-teens millisecond range for sync file writes, formatted messages, JSON serialization, bound context, and async file writes in this run.

Throughput¶

Async writes¶

Sync vs Async latency¶

This measures main thread time only - the true benefit of async is not blocking I/O.

In this run, loguru's enqueue=True path remained far slower than its sync path, while logust's async path stayed close to its sync latency.

Feature comparison¶

API differences¶

Most loguru code works with logust with minimal changes:

# loguru
from loguru import logger
logger.add("app.log", rotation="500 MB")
logger.info("Hello")

# logust (same API for common usage)
from logust import logger
logger.add("app.log", rotation="500 MB")
logger.info("Hello")

When to choose logust¶

• Performance and throughput are critical
• You want a loguru-style API with fewer dependencies
• You need rotation, retention, JSON, callable sinks, and async writes

When to choose loguru¶

• You need full loguru compatibility for advanced features
• You need richer built-in record fields or sink options

Logust vs standard logging¶

Advantages of logust¶

1. Zero configuration with readable defaults
2. Better performance out of the box
3. Simpler API with fewer moving parts
4. Built-in rotation, retention, and colors

Migration example¶

# Standard logging
import logging
logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s | %(levelname)s | %(message)s",
    handlers=[
        logging.FileHandler("app.log"),
        logging.StreamHandler(),
    ],
)
logger = logging.getLogger(__name__)
logger.info("Hello")

# Logust (simpler)
from logust import logger
logger.add("app.log")
logger.info("Hello")