core/runtime_logging.py

from __future__ import annotations

import logging
import os
import sys


DEFAULT_LOG_LEVEL = os.getenv("APP_LOG_LEVEL", "INFO").upper()
LOG_FORMAT = "%(asctime)s | %(levelname)s | %(name)s | %(message)s"


def configure_logging(level: str | None = None) -> None:
    resolved_level_name = (level or DEFAULT_LOG_LEVEL).upper()
    resolved_level = getattr(logging, resolved_level_name, logging.INFO)
    formatter = logging.Formatter(LOG_FORMAT)

    root_logger = logging.getLogger()
    if not root_logger.handlers:
        handler = logging.StreamHandler(sys.stdout)
        handler.setFormatter(formatter)
        root_logger.addHandler(handler)
    else:
        for handler in root_logger.handlers:
            handler.setFormatter(formatter)

    root_logger.setLevel(resolved_level)
    logging.captureWarnings(True)

    for logger_name in ("gunicorn.error", "gunicorn.access", "werkzeug"):
        logging.getLogger(logger_name).setLevel(resolved_level)


def get_logger(name: str) -> logging.Logger:
    return logging.getLogger(name)