nnlogging2 0.1.1

`nnlogging2` is a non-invasive extension of the standard Python logging library. `nnlogging2` is designed to track numerical metrics by time and execution context.

nnlogging2

nnlogging2 is a non-invasive extension of the standard Python logging library. nnlogging2 is designed to track numerical metrics by time and execution context.

• Metric Tracking: Fast automatic metric statistics tracking.
• Extensibility: Fork metric, logger, handler or formatter at any time.
• Compatibility: Compatible with standard python logging library and third-party modules.

---

Preview

---

Installation

pip install nnlogging2

---

Preview Script

from nnlogging2 import (
    get_metric_logger,
    ContextedMetricFormatter,
    AttyStreamHandler,
    level_to_int,
    modify_logger_fallback_attrs_recorded,
)

# 1. Initialize the promoted logger

modify_logger_fallback_attrs_recorded(("lastval", "mean", "median"))
logger = get_metric_logger("train")
logger.setLevel(level_to_int("INFO"))

# 2. Setup formatting for context and metrics
# Inject "%(context_ext)s" and "%(metrics_ext)s" to formatter
# (8 showing characters, 9 ANSI escaped codes)
formatter = ContextedMetricFormatter(
    fmt="%(levelname)-17s %(context_ext)s %(message)s%(metrics_ext)s"
)
handler = AttyStreamHandler()
handler.setFormatter(formatter)
logger.addHandler(handler)

# 3. Attach context to logger (optional)
ctx_logger = logger.contexted({"epoch": "E1/1"})

# 4. Standard logging
ctx_logger.debug("debug ...")
ctx_logger.info("info ...")
ctx_logger.warning("warning ...")
ctx_logger.error("error ...")
ctx_logger.critical("critical ...")

# 5. Update & Logging
for i in range(3):
    # Update numerical values (automatically tracked in a moving window)
    ctx_logger.update(loss=0.5 / (i + 1), accuracy=0.8 + (i * 0.05))
    ctx_logger.log_metric(
        level_to_int("INFO"),
        metrics=[
            ("loss", "[%(metricname)s: %(lastval).2f (%(mean).2f)]"),
            ("accuracy", "[%(metricname)s: %(median).2f]"),
        ],
    )

License

This project is licensed under the MIT License LICENSE.