https://github.com/jakob1379/sane-rich-logging
One-liner for beautiul logs in python
https://github.com/jakob1379/sane-rich-logging
logging python rich
Last synced: 5 months ago
JSON representation
One-liner for beautiul logs in python
- Host: GitHub
- URL: https://github.com/jakob1379/sane-rich-logging
- Owner: jakob1379
- License: mit
- Created: 2024-11-22T09:51:21.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-29T19:57:10.000Z (6 months ago)
- Last Synced: 2026-01-02T02:20:49.697Z (6 months ago)
- Topics: logging, python, rich
- Language: Python
- Homepage: https://pypi.org/project/sane-rich-logging/
- Size: 113 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌟 Sane Rich Logging - Sparkling Logging Made Simple! 🚀
Welcome to **Sane Rich Logging**! ✨ A beautiful logging package that makes setting up robust and pretty logging in Python a breeze! With rich console output and flexible file handling, your logs will shine brighter than ever! ✨🔮
## 🎉 Features
- **Rich Logging Console Output** 🌈: Make your logs delightful with colorful, informative formatting.
- **Rotating File Logs** 🗂️: Keep your logs neat and tidy with built-in rotation.
- **Simple Integration** 🚀: Plug and play with minimal configuration.
## 🚀 Installation
Use your favorite tool to install the package
```bash
pip install sane-rich-logging
poetry install sane-rich-logging
uv add sane-rich-logging
```
## 💡 Usage
With **Sane Rich Logging**, setting up logging is easy-peasy! 🍋 Here is how to use it:
### Setting Up Logging
Just import the package and call `setup_logging()` to configure your logger:
```python
from sane_rich_logging import setup_logging
setup_logging()
logging.debug("Use me like normally")
```
### Sane Defaults for the Root Logger
This package provides a **sane default setup for the root logger**, which will propagate to other loggers that inherit from it. The usage of logging remains unchanged: simply use the **standard Python logging library** functions (`logging.debug()`, `logging.info()`, etc.). With **Sane Rich Logging**, you get a better experience with minimal effort—just set up the logger once, and enjoy consistent, clean logging throughout your application.
### Configuration Options
`setup_logging()` can be customized with arguments or environment variables:
- **`log_file`** (`str | None`): The file path to store log outputs. You can provide it as an argument, or set the `LOG_FILE` environment variable. Defaults to `'application.log'` if none is provided.
- **`log_level`** (`Literal['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'] | None`): The log level for both console and file handlers. You can provide it as an argument, or set the `LOG_LEVEL` environment variable. Defaults to `'DEBUG'`.
- **`log_max_size`** (`int | None`): The maximum size of the log file before rotation. You can provide it as an argument, or set the `LOG_MAX_SIZE` environment variable. Defaults to `5 MB`.
This flexibility makes it easy to adapt the logging setup to different environments, such as development, testing, or production.
### Running the Example
You can also run the package directly to see the magic in action! 🌠
```bash
python -m sane_rich_logging
```
The **console output** is visually pleasing, providing clear and colorful messages for each log level, while the **written log** is saved in a detailed format for easier debugging and tracking:
```
2024-11-22 11:38:00,187 [DEBUG] [__main__.py:11] - This is a debug message.
2024-11-22 11:38:00,190 [INFO] [__main__.py:12] - This is an info message.
2024-11-22 11:38:00,191 [WARNING] [__main__.py:13] - This is a warning message.
2024-11-22 11:38:00,192 [ERROR] [__main__.py:14] - This is an error message.
2024-11-22 11:38:00,193 [CRITICAL] [__main__.py:15] - This is a critical message.
```
✨ It's that simple to make your logging glimmer with **Sane Rich Logging**! 🎇
## ❤️ Contributions Welcome
Have ideas or want to help make **Sane Rich Logging** even shinier? Feel free to submit an issue or pull request! Contributions are more than welcome! 🌟
## 📄 License
This project is licensed under the MIT License. 📝
---
Enjoy logging, the **sparkling** way! 🪄✨