Documentation for quicklogging

Resources

  • doc: Documentation Status - read the doc on readthedocs (github rst is broken)
  • source code: on github
  • package: package

What is quicklogging

quicklogging is a Python logging wrapper to

  • remove a bit of logging boilerplate,
  • redirect print output.

quicklogging transparently provides a logger with a name relevant to the code at hand:

Important

the name of the logger is the name of the module making the call

For instance, if you log from project/models/chair.py, your logger will be named project.models.chair.

Advantage #1 of this naming scheme

the configuration of the logging.Logger s and handlers is much easier -muting, changing verbosity for a particular piece of code etc

Advantage #2

we can provide a quicklogging.catch_prints() and a quicklogging.warn_prints() functionality to catch calls to print() from specific modules (typically: the module you’re editing).

Licence, original authors

  • MIT (see file LICENCE ).
  • authors: majerti - Feth AREZKI

Requirements

Python versions

According to travis-ci :

  • Python 3.5: ok
  • Python 3.5-dev: ok
  • Python nightly: ok
  • Python 2.7: NOT ok, doesn’t have importlib.abc

Libs required

None ! unless you’re running the tests. So I’ve got this easy badge: Requirements Status.