metobs_toolkit.add_StreamHandler#

add_StreamHandler(setlvl: str = 'WARNING', logformat: str = 'LOG:: %(levelname)s - %(message)s') → None[source]#

Add a StreamHandler to the Toolkit logger.

A StreamHandler directs the logs generated by the metobs_toolkit to sys.stderr.

Parameters:

setlvl (str, optional) – The logger level for the StreamHandler. Must be one of [“DEBUG”, “INFO”, “WARNING”, “ERROR”, “CRITICAL”]. See https://docs.python.org/3/library/logging.html#levels for more details. Default is “DEBUG”.
logformat (str, optional) – The format string for log messages. Default is “LOG:: %(levelname)s - %(message)s”.

Return type:

None

Notes

This function checks existing handlers to avoid duplicate StreamHandlers. If a StreamHandler already exists with the same or more restrictive (higher) log level, no new handler is added. Log levels in order of restrictiveness: DEBUG < INFO < WARNING < ERROR < CRITICAL.