Logging

matchbox.common.logging

Logging utilities.

Classes:

• PrefixedLoggerAdapter –

  A logger adapter that supports adding a prefix enclosed in square brackets.

Functions:

• get_formatter –

  Retrieve plugin registered in ‘matchbox.logging’ entry point, or fallback.

• build_progress_bar –

  Create a progress bar.

Attributes:

• LogLevelType –

  Type for all Python log levels.

• logger (Final[PrefixedLoggerAdapter]) –

  Logger for Matchbox.

• console (Final[Console]) –

  Console for Matchbox.

LogLevelType module-attribute

LogLevelType = Literal['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']

Type for all Python log levels.

logger module-attribute

logger: Final[PrefixedLoggerAdapter] = PrefixedLoggerAdapter(getLogger('matchbox'), {})

Logger for Matchbox.

Used for all logging in the Matchbox library.

Allows passing a prefix to any logging call.

Examples:

log_prefix = f"Model {name}"
logger.debug("Inserting metadata", prefix=log_prefix)
logger.debug("Inserting data", prefix=log_prefix)
logger.info("Insert successful", prefix=log_prefix)

console module-attribute

console: Final[Console] = Console()

Console for Matchbox.

Used for any CLI utilities in the Matchbox library.

PrefixedLoggerAdapter

Bases: LoggerAdapter

A logger adapter that supports adding a prefix enclosed in square brackets.

This adapter allows passing an optional prefix parameter to any logging call without modifying the underlying logger.

Methods:

• process –

  Process the log message, adding a prefix if provided.

process

process(msg: Any, kwargs: dict[str, Any]) -> tuple[Any, dict[str, Any]]

Process the log message, adding a prefix if provided.

Parameters:

• msg

  (Any) –

  The log message

• kwargs

  (dict[str, Any]) –

  Additional arguments to the logging method

Returns:

• tuple[Any, dict[str, Any]] –

  Tuple of (modified_message, modified_kwargs)

get_formatter

get_formatter() -> Formatter

Retrieve plugin registered in ‘matchbox.logging’ entry point, or fallback.

build_progress_bar

build_progress_bar(console_: Console | None = None) -> Progress

Create a progress bar.