clearcut 0.2.2.post0

A straightforward and lightweight logging and tracing library

Clearcut: A straightforward and lightweight logging wrapper library

This provides some helpful wrapper and util functions for logging, and formats log messages in a more human-readable way by default.

Use

At the top of the file:

from clearcut import get_logger

...

logger = get_logger(__name__)

Logging can be performed ad-hoc:

logger.info("info log")
logger.warning("warn log", exc_info=e)

"log blocks" can also be created which automatically log entrance/exits as well as performance information

from clearcut import log_block, get_logger

...

logger = get_logger(__name__)

...

with log_block("block name", logger):
    ...

TODO

• Would like to use contextvars to create a contextmanager where additional "metadata" can be specified (and unspecified) which would be included with logging automatically. (may not be import with OTLP tracing.)
• json logging