tiered-debug
A Python logging helper module that allows multiple levels of debug logging
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-debuguv
uv add tiered-debugpoetry
poetry add tiered-debugInstalling 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
Tags
More Software Development packages
Provides backported and experimental type hints…
permissive · top 100 on PyPI
numpyNumPy provides an N-dimensional array object…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
annotated-docProvides a way to document function parameters,…
permissive · top 100 on PyPI
typerTyper builds command-line applications from…
permissive · top 1,000 on PyPI
distlibDistlib provides low-level packaging utilities…
permissive · top 1,000 on PyPI
verboselogsAdds four custom logging levels (NOTICE, SPAM,…
permissive · top 15,000 on PyPI
vmoduleAdds glog-style verbose logging levels to…
permissive · top 15,000 on PyPI
logmuseAdds standard CLI logging options…
permissive · top 15,000 on PyPI
pytest-loggingA pytest plugin that configures Python logging…
permissive · top 15,000 on PyPI
glogA simplified Google-style logging wrapper that…
permissive · top 15,000 on PyPI
coloredlogsAdds colored output to Python's standard…
permissive · top 1,000 on PyPI
pipdeptreepipdeptree displays installed Python packages…
permissive · top 5,000 on PyPI
pytest-structlogProvides a pytest fixture for capturing and…
permissive · top 15,000 on PyPI
structlog-sentryBridges structlog and Sentry to automatically…
permissive · top 5,000 on PyPI
icecreamIceCream provides a drop-in replacement for…
permissive · top 5,000 on PyPI