skillfed

tiered-debug

A Python logging helper module that allows multiple levels of debug logging

tiered-debug v1.5.1 147.6K downloads/30d#11,059 on PyPI0
Permissive license Apache-2.0 Active released

What it is and what it does

tiered-debug is a logging helper module that extends Python's debugging capabilities by allowing you to define and control multiple levels of debug output independently. Rather than a single debug on/off switch, it lets you enable or disable debug messages at different tiers within your application, giving you finer-grained control over what gets logged during development or troubleshooting.

The package is lightweight with no runtime dependencies, making it easy to add to existing projects. It supports modern Python versions (3.10–3.14) and is actively maintained. The documentation includes installation, usage examples, and a full API reference, suggesting it is designed to integrate smoothly into typical Python workflows.

Use it for:

  • Enable debug output only for specific modules or subsystems while keeping others quiet during development.
  • Provide different verbosity levels for different components of a larger application without modifying core logging setup.
  • Troubleshoot production issues by selectively enabling debug tiers for affected code paths without restarting.

Worth the install?

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

A Python logging helper that enables multiple levels of debug output, allowing you to control verbosity across different parts of your code independently.

Yes, if you need finer-grained debug control than standard Python logging provides. The package is actively maintained, has no dependencies, and carries a permissive license. However, verify first that its tiering model matches your use case—the fact sheet does not detail how its tiers differ from or complement the standard logging module.

Install

tiered-debug on PyPI

pip

pip install tiered-debug

uv

uv add tiered-debug

poetry

poetry add tiered-debug

Installing tiered-debug

Before you install

Low friction install with no runtime dependencies. Active maintenance as of 2026-08-04, released 10 days ago. Supports current Python versions (3.10–3.14).

License in practice

Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Quickstart

pip install tiered-debug

import tiered_debug
# See https://tiered-debug.readthedocs.io/en/latest/usage.html for examples

Requires Python 3.10 or later.

Verify before relying

  • What specific debug 'tiers' or levels does the package define, and how do they differ from standard Python logging levels?
  • Does the package integrate with the standard library logging module or provide a standalone alternative?
  • What is the intended use case: development-time debugging, production monitoring, or both?

Package facts

License Apache-2.0 (permissive)
Python support supports the current Python release (>=3.10)
Install friction low — pure-Python wheel
Runtime dependencies none
Maintenance actively maintained — 10 days since the last release
Last repo commit
First released
Downloads 147,561/month — #11,059 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: tiered_debug-1.5.1-py3-none-any.whl

Keywords: debug, logging, tiered-debug

Development Status :: 4 - BetaProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14

Tags

tiered debug loggingmulti-level debug outputconditional debug loggingdebug verbosity controllayered logging helperdebug level management
loggingdebugging

More Software Development packages