philiprehberger-log-focus 0.2.0

Structured log filtering and highlighting for terminals

philiprehberger-log-focus

Structured log filtering and highlighting for terminals.

Installation

pip install philiprehberger-log-focus

Usage

Quick Setup

from philiprehberger_log_focus import focus

logger = focus("myapp")
logger.info("Server started")
logger.warning("High memory usage")
logger.error("Connection failed")

Custom Handler

import logging
from philiprehberger_log_focus import FocusHandler

handler = FocusHandler(
    repeat_threshold=5,    # Suppress after 5 identical messages
    slow_threshold_ms=100, # Highlight slow operations
)

logger = logging.getLogger("myapp")
logger.addHandler(handler)
logger.setLevel(logging.DEBUG)

Slow Operation Highlighting

logger.info("Query completed", extra={"duration_ms": 250})
# Automatically highlighted if above slow_threshold_ms

Removing the handler

from philiprehberger_log_focus import unfocus

unfocus("my-logger")
# All FocusHandler instances are detached from the named logger.
# The logger's level is left unchanged.

Features

• Color-coded output by log level (DEBUG=gray, INFO=default, WARNING=yellow, ERROR=red, CRITICAL=bold red)
• Repeat suppression — collapses repeated identical messages
• Slow operation highlighting via extra["duration_ms"]

API

Function / Class	Description
focus(name, level="WARNING")	Quick setup, returns a configured logger
unfocus(name=None)	Remove all FocusHandler instances from the named logger and return it
FocusHandler(level, repeat_threshold, slow_key, slow_threshold_ms, stream)	Custom logging handler with color and repeat suppression
Colors	ANSI escape constants — RESET, BOLD, DIM, RED, GREEN, YELLOW, CYAN, GRAY

Development

pip install -e .
python -m pytest tests/ -v

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT