Class GridFormatter

logging_utils/core/rendering.py:268–375

Fixed-width grid formatter with semantic highlighting and burst suppression. Format: TIME | LVL | SOURCE | ID | MESSAGE Example output: 22:47:51.690 INF API y74ebn9 Received /v1/chat/completions request 22:47:51.692 INF WORKR y74ebn9 Processing request logic... 22:47:51.

class GridFormatter(logging.Formatter):
    """
    Fixed-width grid formatter with semantic highlighting and burst suppression.

    Format: TIME | LVL | SOURCE | ID | MESSAGE

    Example output:
    22:47:51.690 INF API   y74ebn9 Received /v1/chat/completions request
    22:47:51.692 INF WORKR y74ebn9 Processing request logic...
    22:47:51.695 INF PROXY         Sniff HTTPS requests (x5)
    """

    def __init__(
        self,
        colorize: bool = True,
        burst_suppression: bool = True,
        show_tree: bool = True,  # Deprecated, kept for compatibility
    ):
        super().__init__()
        self.colorize = colorize
        self.burst_suppression = burst_suppression

    def format(self, record: logging.LogRecord) -> str:
        """Format log record into grid layout."""
        # Skip during Python shutdown to avoid ImportError
        if sys.meta_path is None:
            return record.getMessage()

        # Extract context variables with defaults
        try:
            req_id = request_id_var.get()
        except LookupError:
            req_id = "       "

        try:
            source = source_var.get()
        except LookupError:
            source = "SYS"

        # Normalize source to 5-letter code
        source_normalized = normalize_source(source)

        # Column 1: Time (HH:MM:SS.mmm) - no date
        now = datetime.now()
        timestamp = now.strftime("%H:%M:%S.") + f"{int(now.microsecond / 1000):03d}"
        if self.colorize:
            time_col = f"{Colors.TIME}{timestamp}{Colors.RESET}"
        else:
            time_col = timestamp

        # Column 2: Level (3 chars)
        level_abbrev = Colors.LEVEL_ABBREV.get(
            record.levelname, record.levelname[:3].upper()
        )
        if self.colorize:
            level_color = Colors.LEVELS.get(record.levelname, Fore.WHITE)
            level_col = f"{level_color}{level_abbrev}{Colors.RESET}"
        else: