Simple Log Factory

A lightweight wrapper around Python's built-in logging module that creates pre-configured loggers with sensible defaults.

Requires Python 3.11+

Installation

pip install simple_log_factory

Usage

Basic console logger (DEBUG level)

from simple_log_factory import log_factory

logger = log_factory("my_app")
logger.info("Application started")

Console + rotating file logger

The file log rotates daily at midnight. Unless you pass log_time_format, the time-only format (%H:%M:%S) is used, since the date is encoded in the filename.

from simple_log_factory import log_factory

logger = log_factory("my_app", log_file="./app.log")

Console + static file logger

from simple_log_factory import log_factory

logger = log_factory("my_app", log_file="./app.log", rotate_file_by_day=False)

Deduplicate handlers

Prevent duplicate output when multiple loggers write to the same destination:

from simple_log_factory import log_factory

logger = log_factory("my_app", unique_handler_types=True)

LogContext and LogContextGenerators

LogContextGenerators creates context-bound loggers that inject extra key-value pairs into every log call:

from simple_log_factory import LogContextGenerators

gen = LogContextGenerators(log_name="my_app")
ctx = gen.get_logger_for_context(request_id="abc-123", user="alice")

ctx.info("Processing request")  # extra={request_id: "abc-123", user: "alice"}
ctx.error("Something went wrong")

The returned LogContext object is a frozen dataclass with attributes exception, error, warning, info, and debug.

Links

• GitHub
• PyPI