Metadata-Version: 2.4
Name: apathetic-logging
Version: 0.8.0
Summary: Small quality-of-life features on top of stdlib.
License-File: LICENSE
Keywords: library,logging,logger
Author: Apathetic Tools
Requires-Python: >=3.10
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Project-URL: Changelog, https://github.com/apathetic-tools/python-logging/releases
Project-URL: Documentation, https://apathetic-tools.github.io/python-logging/
Project-URL: Homepage, https://github.com/apathetic-tools/python-logging
Project-URL: Issues, https://github.com/apathetic-tools/python-logging/issues
Project-URL: Repository, https://github.com/apathetic-tools/python-logging
Description-Content-Type: text/markdown

# 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.

