Autologging — easier logging and tracing for Python classes¶
Autologging eliminates boilerplate logging setup code and tracing code, and provides a means to separate application logging from program flow and data tracing.
Python modules that make use of Autologging are cleaner, leaner, and more resilient to changes that would otherwise require updating tracing statements.
Autologging allows for tracing to be configured (and controlled) independently from application logging. Toggle tracing on/off, write trace log records to a separate log, and use different formatting for trace log entries - all via standard Python logging facilities, and without affecting your application logging.
Python 2.7 and Python 3.3+ are supported using the same codebase. All examples given on this site use Python 3 syntax.
New in version 1.1.0: Autologging now exposes the
function. This function replaces the
traced decorator with a
no-op that returns traced classes and functions unmodified
(effectively disabling all tracing capabilities). This is useful for
cases where any overhead from tracing is not desired (for example,
when running in production environments, or when running performance
Table of Contents¶
- Introduction to Autologging
- Examples of using
- How does
Download and Install¶
The easiest way to install Autologging is to use pip:
$ pip install Autologging
To install from source, clone or fork the repository:
$ git clone https://github.com/mzipay/Autologging.git
Run the test suite and install the
autologging module (make sure you
$ cd Autologging $ python setup.py test $ python setup.py install
You can also install from one of the available binary packages available at https://pypi.python.org/pypi/Autologging or https://sourceforge.net/projects/autologging/files/.