stems.logging_ module

Some sensible defaults for logging

Designed for applications or interactive use – not importing in library code. The ‘stems’ logger is setup for library use with a NullHandler in stems/__init__.py.

stems.logging_.setup_logger(logger='stems', fmt='%(asctime)s %(levelname)s %(lineno)s %(module)s.%(funcName)s %(message)s', datefmt='%H:%M:%S', level=20, handler=None, replace_handler=True)[source]

Setup and return a logger with formatter and handler

Parameters

  • logger (logging.Logger or str, optional) – Logger, or name of logger to use

  • fmt (str, optional) – Format string for logging.Formatter

  • datefmt (str, optional) – Date format string for logging.Formatter

  • level (int or str, optional) – Level for logging passed to logging.Logger.setLevel

  • handler (logging.Handler or None, optional) – Specify a handler to use. Defaults to a newly created logging.StreamHandler.

  • replace_handler (bool, optional) – Replace all existing handlers (otherwise appends handler)

Returns

Configured logger

Return type

logging.Logger