ipylogging 2020.341.0

Easy log messages in Jupyter notebooks.

ipylogging

Easy logging in Jupyter notebooks.

Most people will be fine with the default options from get_simple_logger().

import ipylogging

logger = ipylogging.get_simple_logger()
...
logger.debug('The nitty gritty.')
logger.info('Nice to know.')
logger.warning('It could be worse.')
logger.error("It's worse.")
logger.critical('Houston, we have a problem.')

If you want more control, you can also use IPythonHandler directly, which is a standard logging.Handler that supports all the same stuff as logging.StreamHandler.

import logging
import ipylogging
logger = logging.getLogger('foo')
handler = ipylogging.IPythonHandler()
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)
logger.addHandler(handler)
logger.setLevel(logging.ERROR)

ipylogging also works outside of Jupyter, in which case get_simple_logger() will simply return a normal Python logging.Logger with a StreamHandler. This is useful when writing modules that might be used inside or outside of notebooks.