# Apathetic Python Logging 🪵

[![CI](https://github.com/apathetic-tools/python-logs/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/goldilocks/python-logs/actions/workflows/ci.yml)
[![License: MIT-a-NOAI](https://img.shields.io/badge/License-MIT--a--NOAI-blueviolet.svg)](LICENSE)
[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?logo=discord&logoColor=white)](https://discord.gg/PW6GahZ7)

📘 **[Roadmap](./ROADMAP.md)** · 📝 **[Release Notes](https://github.com/apathetic-tools/python-logs/releases)**

**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 context.

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

## Quick Start

```python
from apathetic_logging import get_logger, register_logger

# Register your logger
register_logger("my_app")

# Get the logger instance
logger = get_logger()

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

## Installation

```bash
# Using poetry
poetry add apathetic-logger

# Using pip
pip install apathetic-logger
```

## Documentation

📚 **[Full Documentation →](https://apathetic-tools.github.io/python-logging/)**

For installation guides, API reference, examples, and more, visit our documentation website.

---

## ⚖️ License

- [MIT-a-NOAI License](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.
