Skip to content

Logging

logging

Default structlog configuration that defers to the host's logging setup.

gepa-adk logs through structlog and never prints. When a host program has not configured structlog, structlog's built-in default writes every event, DEBUG included, to stdout. This module replaces that default with a configuration that routes events through the standard library logging module, so the host's logging configuration decides what is emitted and where.

ATTRIBUTE DESCRIPTION
configure_default_logging

Route structlog through the standard library when the host has not configured structlog.

TYPE: function

Examples:

The package calls this at import time. A host that wants the DEBUG events configures logging before importing gepa-adk:

import logging

logging.basicConfig(level=logging.DEBUG)

import gepa_adk  # registration events now appear at DEBUG
See Also
Notes

A structlog configuration made before gepa-adk is imported is left untouched. The package never calls logging.basicConfig and adds no handlers, so with no host configuration Python's last-resort handler emits WARNING and above to stderr and drops DEBUG and INFO.

configure_default_logging 

configure_default_logging() -> bool

Route structlog through logging unless the host configured structlog.

RETURNS DESCRIPTION
bool

True if this call configured structlog, False if structlog was already
bool

configured and was left unchanged.

Examples:

from gepa_adk.utils.logging import configure_default_logging

configure_default_logging()  # False after gepa_adk has been imported
Source code in src/gepa_adk/utils/logging.py 
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
def configure_default_logging() -> bool:
    """Route structlog through ``logging`` unless the host configured structlog.

    Returns:
        True if this call configured structlog, False if structlog was already
        configured and was left unchanged.

    Examples:
        ```python
        from gepa_adk.utils.logging import configure_default_logging

        configure_default_logging()  # False after gepa_adk has been imported
        ```
    """
    if structlog.is_configured():
        return False
    structlog.configure(
        processors=[
            # First, so an event below the stdlib logger's level is dropped
            # before any rendering work.
            structlog.stdlib.filter_by_level,
            structlog.stdlib.add_logger_name,
            structlog.stdlib.add_log_level,
            structlog.processors.TimeStamper(fmt="iso"),
            structlog.processors.StackInfoRenderer(),
            structlog.processors.format_exc_info,
            EncodingSafeProcessor(),
            structlog.dev.ConsoleRenderer(colors=False),
        ],
        logger_factory=structlog.stdlib.LoggerFactory(),
        wrapper_class=structlog.stdlib.BoundLogger,
        cache_logger_on_first_use=False,
    )
    return True