loggerizer 1.0.0

A flexible logging framework with JSON, file, and SMTP logging

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")

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="[e-mail]",
    to_address=["[e-mail]"],
    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

Field	Description
ASC_TIME	Human-readable timestamp
LEVEL_NAME	Log level (DEBUG, INFO, etc.)
MESSAGE	Log message
NAME	Logger name
MODULE	Module name
FUNC_NAME	Function name
LINE_NO	Line number
FILE_NAME	File name
PATH_NAME	Full file path
PROCESS	Process ID
THREAD	Thread ID
EXCEPTION	Exception info

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