Logging (mpdaf.log)

When imported, MPDAF initialize a logger by default. This logger uses the logging module, and log messages to stderr, for instance for the .info() methods.

It is possible to remove this logger with clear_loggers, and to use setup_logging to setup a logger with a different level or format. setup_logfile can also be used to setup a logger with a file.

Functions

mpdaf.log.clear_loggers(name='mpdaf')

Remove all handlers for a given logger.

mpdaf.log.setup_logging(name='mpdaf', level='DEBUG', color=False, stream=None, fmt='[%(levelname)s] %(message)s', datefmt=None, clear_handlers=True)

Setup stream handler for a given logger.

Parameters:

namestr

Logger name.

levelstr

Level for the stream handler (default: DEBUG).

colorbool

Use colored output (default: True). Used only if a compatible stream or tty is used.

stream{sys.stdout, sys.stderr}

Used stream (default: stderr)

fmtstr

Messages format.

clear_handlersbool

Tell if other handlers must be removed (default: True).

mpdaf.log.setup_logfile(name='mpdaf', level=10, logfile='mpdaf.log', fmt='%(asctime)s [%(levelname)s] {%(name)s:%(lineno)d} %(message)s', datefmt=None, rotating=True)

Setup logging to file.