Add dynamic log level control with LoggerFilter and LoggerProcessor

[jkebinger]

Summary

Implements configurable log level management through Reforge configuration, allowing real-time control of logging verbosity without application restarts.

Key Features

• LogLevel enum mapping to Python logging levels (TRACE, DEBUG, INFO, WARN, ERROR, FATAL)
• get_log_level() method with context-based evaluation using reforge-sdk-logging context
• logger_key option (default: "log-levels.default") for configuring the config key
• LoggerFilter for standard Python logging integration
• LoggerProcessor for structlog integration (optional dependency via extras)
• Evaluates LOG_LEVEL_V2 config type with context: {"reforge-sdk-logging": {"lang": "python", "logger-path": logger_name}}
• Returns DEBUG as default when config not found
• No telemetry/record_log functionality (removed from predecessor)

Changes

Core Implementation

• sdk_reforge/log_level.py - LogLevel enum with Python logging level mapping
• sdk_reforge/logging.py - LoggerFilter and LoggerProcessor implementations
• sdk_reforge/sdk.py - Added get_log_level() method
• sdk_reforge/options.py - Added logger_key parameter
• sdk_reforge/__init__.py - Export logging classes (removed protobuf LogLevel to avoid conflicts)

Dependencies

• pyproject.toml - Made structlog optional via extras: pip install sdk-reforge[structlog]

Tests

• tests/test_log_level.py - Tests for LogLevel enum and get_log_level() method
• tests/test_logging.py - Tests for LoggerFilter and LoggerProcessor

Examples

• examples/standard-logging/ - Complete example for standard Python logging
• examples/structlog/ - Complete example for structlog integration

Usage

Standard Logging

import logging
from sdk_reforge import ReforgeSDK, Options, LoggerFilter

def configure_logger():
    handler.addFilter(LoggerFilter())

sdk = ReforgeSDK(Options(on_ready_callback=configure_logger))
logger = logging.getLogger("myapp")
logger.info("This message is controlled by Reforge config")

Structlog

import structlog
from sdk_reforge import ReforgeSDK, Options, LoggerProcessor

structlog.configure(
    processors=[
        structlog.stdlib.add_log_level,
        LoggerProcessor().processor,
        # ... other processors
    ]
)

sdk = ReforgeSDK(Options())
logger = structlog.getLogger()
logger.info("This message is controlled by Reforge config")

Testing

All tests passing:

• 3 tests in test_log_level.py
• 4 tests in test_logging.py
• All pre-commit hooks passing (black, ruff, prettier, mypy)

[jdwyah]

thanks

[jdwyah]

thanks