Apathetic Python Logging 🪵

Small quality-of-life features on top of stdlib. Because you don’t need another large dependency.

Apathetic Python Logger provides a lightweight, dependency-free logging solution designed for CLI tools. It extends Python’s standard library logging module with colorized output, dual-stream handling (stdout/stderr), extra logging levels, and seamless integration with Apathetic Tools projects.

Features

🪶 Zero dependencies — Uses only Python’s standard library
🔄 Drop-in replacement — Can be used as a drop-in replacement for stdlib logging
🐍 stdlib-compatible — Uses camelCase naming to match Python’s standard library logging module
🔄 Dual-stream handling — Smart routing to stdout/stderr
📊 Extra logging levels — TEST, TRACE, DETAIL, BRIEF, and SILENT levels for fine-grained control
🏷️ Tag-based formatting — Clean, readable log tags with emoji support
🎨 Colorized output — Automatic color detection with TTY support
🔧 CLI-friendly — Designed with command-line applications in mind
🧩 Apathetic Tools integration — Works seamlessly with serger and other Apathetic Tools

[!NOTE] Heads up: the AI cooked dinner. It’s edible, but watch your step.
Detailed bug reports welcome.

Quick Example

from apathetic_logging import getLogger, registerLogger

# Register your logger
registerLogger("my_app")

# Get the logger instance
logger = getLogger()

# Use it!
logger.info("Hello, world!")
logger.detail("Extra verbosity above INFO")
logger.brief("Lower verbosity than INFO")
logger.trace("Trace information")

Requirements

Python 3.10+

No other dependencies required — this library uses only Python’s standard library.

Installation

Install via poetry or pip:

# Using poetry
poetry add apathetic-logger

# Using pip
pip install apathetic-logger

For alternative installation methods, see the Installation Guide.

Documentation

Installation Guide — How to install and set up
Quick Start — Get up and running in minutes
API Reference — Complete API documentation
Examples — Advanced usage examples
Custom Logger Guide — Creating application-specific loggers
Contributing — How to contribute

License

MIT-a-NOAI License

You’re free to use, copy, and modify the library under the standard MIT terms.
The additional rider simply requests that this project not be used to train or fine-tune AI/ML systems until the author deems fair compensation frameworks exist.
Normal use, packaging, and redistribution for human developers are unaffected.