akeoott_logging_config

akeoott_logging_config provides an incredibly easy-to-use, modular logging solution designed to simplify logging setup for Python applications of small to medium scale, from quick scripts to medium sized applications.

Warning

This project is licensed under the GNU Lesser General Public License v3.0 (LGPL-3.0) - see the LICENSE website or LICENSE file for details.

Note

This logger is mainly for my personal use.
It's able to get the job done but it's not meant for systems that require active maintaining of it's dependencies and stable reliablility.

✨ Features

• Effortless Setup: Configure comprehensive logging with a single function call.
• Zero Unwanted Logs: Implements NullHandler by default, ensuring your library doesn't spam user consoles unless explicitly configured.
• Highly Configurable: Control log levels, output destinations (console, file), log formats, and date formats with flexible parameters.
• Intelligent File Handling: Automatically resolves log file paths, creates necessary directories, and handles common file-related issues gracefully.
• Idempotent Configuration: Safely call setup multiple times without creating duplicate log handlers.
• Dedicated Logger: Provides a named logger (github_activity) isolated from the root logger, preventing interference with other application logging.
• Robust Error Reporting: Logs internal errors during logging setup itself (e.g., file writing issues) to ensure visibility.
• Cross-Platform Compatibility: Utilizes pathlib for robust and platform-independent file path management.

Third party log silencing is planned to be rewritten. Currently not functional under most situations.

🚀 Installation

You can install akeoott_logging_config directly from PyPI using pip:

pip install akeoott_logging_config