logging-tree

What it is and what it does

logging_tree is a diagnostic tool that introspects Python's standard logging module and displays the current logger tree in a human-readable ASCII diagram. It shows the root logger and all child loggers, their configured levels, handlers, filters, and propagation settings. The package solves the problem of understanding complex logging configurations at runtime—especially useful when debugging why certain log messages appear or disappear, or when inheriting code with unfamiliar logging setups.

The package has no runtime dependencies and works by querying the logging module's internal state. It offers both a simple `printout()` function for immediate console output and lower-level APIs (`format.build_description()`, `format.describe()`, `tree()`) for programmatic access to the tree structure. It handles edge cases like placeholder nodes (parent loggers created implicitly) and loggers with disabled propagation.

Use it for:

• Debug why a log message is or isn't appearing by visualizing the full logger hierarchy and propagation chain.
• Audit logging configuration in a running application to verify handlers and levels are set as expected.
• Understand inherited or third-party code's logging setup without reading source files.
• Verify that custom logger hierarchies (e.g., 'app.module.submodule') are structured correctly.
• Troubleshoot double-logging or missing log output caused by handler duplication or propagation settings.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Visualizes the hierarchy of loggers, handlers, and filters in Python's standard logging module, showing how messages propagate through the logger tree.

Yes. This is a low-friction, zero-dependency diagnostic tool for a common pain point (understanding logging configuration). It is stable, permissive-licensed, and works across a wide range of Python versions. Install it if you regularly debug logging setups or inherit complex applications; skip it if you never need to inspect logging state at runtime.

Install

logging-tree on PyPI

pip install logging-tree

uv add logging-tree

poetry add logging-tree

Installing logging-tree

Before you install

Low friction: pure Python wheel with no runtime dependencies. Maintenance is dormant (833 days since last release) but the package is marked Mature and the repository remains active with 333 stars; suitable for stable introspection use.

License in practice

Permissive license (BSD) with no restrictions on commercial or private use.

Quickstart

pip install logging-tree

import logging
from logging_tree import printout

logging.getLogger('app').setLevel(logging.DEBUG)
printout()

Verify before relying

• Whether the package works correctly with Python versions newer than 3.12 (latest declared compatibility is 3.12).

Package facts

Evidence: logging_tree-1.10-py2.py3-none-any.whl

Tags

More Logging packages