np-logging 0.1.0

Pre-configured file, web and email logging for neuropixels projects, repackaging code from mpeconfig.

import np_config

np_config.setup() will run automatically on import using a default logging config.

• user configs can be specified according to the logging library dict schema

• the default config is fetched from the ZooKeeper server eng-mindscope:2181

• configs can be added via ZooNavigator webview: http://eng-mindscope:8081

• or more conveniently, via an extension for VSCode such as gaoliang.visual-zookeeper

ZooKeeper configs can be fetched via their path:

test_config: dict = np_config.fetch_zk_config(
    '/projects/np_logging_test/defaults/logging'
)

Once a logging config dict has been modified as necessary...

test_config['handlers']['email_handler']['toaddrs'] = [e-mail]

re-run the logging setup with the new config dict:

np_config.setup(
    config: dict = test_config,
    project_name = 'test',
)

• project_name must be supplied to use the web logger
• web log can be viewed at http://eng-mindscope:8080

The default config provides the loggers web and email, in addition to the default root which includes file handlers for info and debug logging levels, plus console logging:

logging.getLogger('web').info('test message')
logging.getLogger('email').info('test message')
logging.debug('test message to files and console')

Other parameters to np_config.setup():

• log_at_exit (default True)

  • If True, a message is logged when the program terminates, reporting total elapsed time.

• email_at_exit (default False)

  • If True, an email is sent when the program terminates, reporting the elapsed time and cause of termination. If an exception was raised, the traceback is included.

  • If logging.error, the email is only sent if the program terminates via an exception.