negogv-log 0.1.7

A custom Python logger configuration with colored console output.

negogv-log

A lightweight, colorized Python logger configuration designed for quick integration and high readability. This package provides a pre-configured logger that handles both console and file output with sensible defaults.

Features

• 🎨 Colorized Console Output: Enhanced readability with level-specific colors.
• 📁 Split File Logging: Automatically separates logs into:
  • high_lvl.log: Warnings, Errors, and Critical messages.
  • low_lvl.log: Debug and Info messages.
• 📄 Multiline Support: File logs automatically indent multiline messages for better formatting.
• 🔍 File Origin Tracking: Includes filename and line numbers in logs to easily identify source locations.
• 🛠️ Exception Helper: log_exception for quick, colorized exception reporting.
• 🚫 Level Filtering: Easily exclude specific log levels from the console.

Installation

pip install negogv-log

Quick Start

from negogv_log import setup_logger

# Initialize the logger with a directory for log files
logger = setup_logger(log_dir="logs")

logger.debug("This is a debug message")
logger.info("Application started")
logger.warning("Something might be wrong")
logger.error("An error occurred")
logger.critical("System failure!")

Advanced Usage

Excluding Console Levels

You can exclude specific levels from being printed to the console:

# Exclude only INFO logs from console
logger = setup_logger(log_dir="logs", exclude_console="INFO")

# Exclude multiple levels
logger = setup_logger(log_dir="logs", exclude_console=["DEBUG", "INFO"])

Exception Logging

Use log_exception to print a concise, colorized summary of an exception:

from negogv_log import log_exception

try:
    1 / 0
except Exception as e:
    log_exception(e)

Multiline Messages

The file logger handles multiline strings gracefully by indenting subsequent lines:

logger.info("This is a\nmulti-line\nmessage")

Configuration

The setup_logger function performs the following:

1. Creates the specified log_dir if it doesn't exist.
2. Sets up a StreamHandler for console output with CustomFormatter (colors).
3. Sets up two FileHandlers:
   • high_lvl.log (Level >= WARNING)
   • low_lvl.log (Level <= INFO)

License

This project is licensed under the MIT License - see the LICENSE file for details.