An open API service indexing awesome lists of open source software.

https://github.com/apathetic-tools/python-logging

Small quality-of-life features on top of stdlib.
https://github.com/apathetic-tools/python-logging

library logger logging python

Last synced: 3 months ago
JSON representation

Small quality-of-life features on top of stdlib.

Awesome Lists containing this project

README

          

# 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]
> This project is largely AI-written and minimally polished. I rely on it, but I haven't reviewed every detail.
> Expect rough edges. Thoughtful issue reports are appreciated.

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