---
id: tiered-debug
version: "1.5.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# tiered-debug — A Python logging helper module that allows multiple levels of debug logging

License: permissive · Maintenance: active · Downloads: 147.6K/mo

## 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 above — 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

pip install tiered-debug
uv add tiered-debug
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_current
- Install friction: low
- Maintenance: active
- Downloads: 147.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tiered debug logging, multi-level debug output, conditional debug logging, debug verbosity control, layered logging helper, debug level management, logging, debugging

[View on SkillFed](https://skillfed.io/packages/tiered-debug) · [View on PyPI](https://pypi.org/project/tiered-debug/)