log

Class info

🛈 DocStrings

Logging configuration for llmling_agent.

get_logger

get_logger(name: str, log_level: LogLevel | None = None) -> Logger

Get a logger for the given name.

Parameters:

Name	Type	Description	Default
name	str	The name of the logger, will be prefixed with 'llmling_agent.'	required
log_level	LogLevel | None	The logging level to set for the logger	None

Returns:

Type	Description
Logger	A logger instance

Source code in src/llmling_agent/log.py

def get_logger(name: str, log_level: LogLevel | None = None) -> logging.Logger:
    """Get a logger for the given name.

    Args:
        name: The name of the logger, will be prefixed with 'llmling_agent.'
        log_level: The logging level to set for the logger

    Returns:
        A logger instance
    """
    logger = logging.getLogger(f"llmling_agent.{name}")
    if log_level is not None:
        logger.setLevel(log_level)
    return logger

set_handler_level

set_handler_level(
    level: int,
    logger_names: Sequence[str],
    *,
    session_handler: OutputWriter | None = None,
)

Temporarily set logging level and optionally add session handler.

Parameters:

Name	Type	Description	Default
level	int	Logging level to set	required
logger_names	Sequence[str]	Names of loggers to configure	required
session_handler	OutputWriter | None	Optional output writer for session logging	None

Source code in src/llmling_agent/log.py

@contextmanager
def set_handler_level(
    level: int,
    logger_names: Sequence[str],
    *,
    session_handler: OutputWriter | None = None,
):
    """Temporarily set logging level and optionally add session handler.

    Args:
        level: Logging level to set
        logger_names: Names of loggers to configure
        session_handler: Optional output writer for session logging
    """
    loggers = [logging.getLogger(name) for name in logger_names]
    old_levels = [logger.level for logger in loggers]

    handler = None
    if session_handler:
        from slashed.log import SessionLogHandler

        handler = SessionLogHandler(session_handler)
        for logger in loggers:
            logger.addHandler(handler)

    try:
        for logger in loggers:
            logger.setLevel(level)
        yield
    finally:
        for logger, old_level in zip(loggers, old_levels, strict=True):
            logger.setLevel(old_level)
            if handler:
                logger.removeHandler(handler)