RichColorLog Documentation

RichColorLog Screenshot

RichColorLog is an enhanced Python logging library with Rich formatting, custom log levels, and support for multiple output backends including Console, File, RabbitMQ, Kafka, ZeroMQ, Syslog, and Database.

Note

This library extends Python’s standard logging module with colorful output, emoji icons, syntax highlighting, and enterprise-grade logging backends.

Features

✨ Rich Console Output

Beautiful, colorful log messages with customizable themes

🎨 Multiple Color Modes

Automatic detection of terminal color support (TrueColor, 256-color, Basic, None)

πŸ“Š Custom Log Levels

Extended syslog-compatible levels: EMERGENCY, ALERT, FATAL, NOTICE

πŸ”Œ Multiple Backends

Console, File, RabbitMQ, Kafka, ZeroMQ, Syslog, Database

πŸ’‘ Syntax Highlighting

Code highlighting in log messages using Pygments

🎯 Icon Support

Emoji icons for different log levels

Quick Start

Installation

pip install richcolorlog

# With optional dependencies
pip install richcolorlog[rabbitmq]  # RabbitMQ support
pip install richcolorlog[kafka]     # Kafka support
pip install richcolorlog[zeromq]    # ZeroMQ support
pip install richcolorlog[database]  # Database support
pip install richcolorlog[all]       # All backends

Basic Usage

from richcolorlog import setup_logging

# Simple setup
logger = setup_logging()

logger.debug("Debug message")
logger.info("Info message")
logger.warning("Warning message")
logger.error("Error message")
logger.critical("Critical message")

# Custom levels
logger.notice("Notice message")
logger.alert("Alert message")
logger.emergency("Emergency message")
logger.fatal("Fatal message")
logger.success("Success message")
logger.primary("Primary message")
logger.danger("Danger message")

logger.exception("Exception message") # .exception must set TRACEBACK env var to show traceback, this should in except block

os.environ.update({'TRACEBACK': '1'})
try:
   print(sys.args[1])
except Exception as e:
   logger.error(e)
   logger.exception(f"An exception occurred: {e}")

Contents

User Guide

Handlers

Advanced

API Reference

Development