tiered-debug

import logging import os from tiered_debug import TieredDebug # Configure a basic logger for demonstration logging.basicConfig( level=logging.DEBUG, format='%(levelname)s:%(name)s:%(message)s' ) # Instantiate TieredDebug with a specific level or rely on default (1) # The debug_level argument overrides any TIERED_DEBUG_LEVEL env var for this instance. td = TieredDebug(debug_level=3, logger_name="my_app") # Log at different tiers td.lv1("This is a level 1 debug message. Always visible if debug_level >= 1.") td.lv2("This is a level 2 debug message. Visible if debug_level >= 2.") td.lv3("This is a level 3 debug message. Visible if debug_level >= 3.") td.lv4("This is a level 4 debug message. Not visible with current config (debug_level=3).") # Using the generic log method td.log(5, "This message is also at level 5. Not visible.") # Temporarily increase the debug level using a context manager print("\n--- Entering higher debug context ---") with td.log_level_context(5): td.lv4("This level 4 message is now visible within the context!") td.lv5("And this level 5 message is also visible!") # You can also pass keyword arguments directly to the underlying logging call try: raise ValueError("Something went wrong!") except ValueError: td.lv1("Error with exc_info", exc_info=True) print("--- Exiting higher debug context ---") td.lv4("This level 4 message is no longer visible after exiting the context.")