Loggerizer

A simple, powerful wrapper for Python's built-in logging module.

Installation

pip install loggerizer

Quick Start

from loggerizer import LoggerFactory

logger = LoggerFactory.console()
logger.info("Hello, World!")

Logger Types

Console Logger

from loggerizer import LoggerFactory

logger = LoggerFactory.console()
logger.info("Human-readable console output")

Colored Console Logger

from loggerizer import LoggerFactory

logger = LoggerFactory.console(colorize=True)
logger.debug("Dim metadata, bold cyan level")
logger.info("Bold green level name")
logger.warning("Bold yellow level name")
logger.error("Red level + red message")
logger.critical("Bright red level + red message")

Color scheme:

• Level name: bold + level color, padded to fixed width
• Message: default terminal color (colored red for ERROR/CRITICAL)
• Exceptions: colored tracebacks for ERROR/CRITICAL
• Metadata (timestamp, logger name, etc.): dim gray
• Separator: dim │

Colors are automatically disabled when output is piped or redirected. Works on Linux, macOS, and Windows.

Colored Console Logger (Builder)

from loggerizer import LoggerBuilder, handlers, LogLevel
from loggerizer.formatters import ColorFormatter

logger = (
    LoggerBuilder()
    .name("my_app")
    .level(LogLevel.DEBUG)
    .formatter(ColorFormatter(flat=True))
    .handler(handlers.stream())
    .build()
)

Custom Color Mapping

from loggerizer.formatters import ColorFormatter

formatter = ColorFormatter(
    flat=True,
    colors={"DEBUG": "\033[35m"},  # magenta for DEBUG
)

Console JSON Logger

from loggerizer import LoggerFactory

logger = LoggerFactory.console_json()
logger.info("Structured JSON output")

File Logger

from loggerizer import LoggerFactory

logger = LoggerFactory.file("app.log")
logger.info("Logging to file")

JSON File Logger

from loggerizer import LoggerFactory

logger = LoggerFactory.file_json("app.json")
logger.info("JSON logging to file")

Rotating Logger (by size)

from loggerizer import LoggerFactory

logger = LoggerFactory.rotating(
    "app.log",
    max_bytes=10_000_000,  # 10MB
    backup_count=5
)
logger.info("Size-based rotation")

Timed Rotating Logger

from loggerizer import LoggerFactory, RotateWhen

logger = LoggerFactory.timed_rotating(
    "app.log",
    when=RotateWhen.MIDNIGHT,
    backup_count=7
)
logger.info("Time-based rotation")

Email Logger

from loggerizer import LoggerFactory, SMTPConfig

config = SMTPConfig(
    host=("smtp.example.com", 587),
    from_address="alerts@example.com",
    to_address=["admin@example.com"],
    subject="[ALERT] Application Error",
)

logger = LoggerFactory.email(config)
logger.error("Critical error occurred!")

Null Logger

from loggerizer import LoggerFactory

logger = LoggerFactory.null()
logger.info("This message is discarded")

Custom Logger (Builder Pattern)

from loggerizer import LoggerBuilder, handlers, LogLevel, LogField, DefaultFormatter

logger = (
    LoggerBuilder()
    .name("my_app")
    .level(LogLevel.DEBUG)
    .formatter(DefaultFormatter(
        fields=[LogField.ASC_TIME, LogField.LEVEL_NAME, LogField.MESSAGE, LogField.MODULE],
        flat=True
    ))
    .handler(handlers.stream())
    .handler(handlers.file("app.log"))
    .build()
)

logger.debug("Debug message")
logger.info("Info message")
logger.error("Error message")

Adding Extra Data

from loggerizer import LoggerFactory

logger = LoggerFactory.console_json()
logger.info("User action", extra={"user_id": 123, "action": "login", "ip": "192.168.1.1"})

Custom Fields

from loggerizer import LoggerFactory, LogField

logger = LoggerFactory.console(
    fields=[
        LogField.ASC_TIME,
        LogField.LEVEL_NAME,
        LogField.MESSAGE,
        LogField.MODULE,
        LogField.FUNC_NAME,
        LogField.LINE_NO,
    ]
)
logger.info("With extra context")

Available Log Fields

Formatters

Handlers

from loggerizer import handlers

handlers.stream()                    # Console output
handlers.file("app.log")             # File output
handlers.rotating("app.log")         # Size-based rotation
handlers.timed_rotating("app.log")   # Time-based rotation
handlers.smtp(config)                # Email alerts
handlers.null()                      # Discard logs

License

MIT