Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Autologging makes logging and tracing Python classes easy.

Project Description

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.

Autologging exposes two decorators and a custom log level:

@logged Decorate a class to create a __log member. The logger is named by default to match the dotted-name of the containing class. A function may also be decorated, creating a _log attribute on the function object whose default name matches the containing module. A specifically-named logger may also be passed to the decorator (i.e. @logged(my_logger)).

@traced Decorate a class to provide automatic method call/return tracing. By default, all class, static, and instance methods are traced (excluding “__special__” methods, with the exception of __init__). As with the logged decorator, the default name of the tracing logger matches the dotted-name of the containing class and may be overridden by passing a specifically-named logger to the decorator. Additionally, this decorator accepts multiple string arguments that explicitly name the methods to be traced (and may even name “__special__” methods). Module-level functions may also be traced using this decorator.

TRACE The autologging.TRACE (level 1) log level is registered with the Python logging module when Autologging is imported so that tracing can be configured and controlled independently of application logging.

Release History

Release History

This version
History Node

1.1.0

History Node

1.0.1

History Node

1.0.0

History Node

0.4.0

History Node

0.3.0

History Node

0.2.1

History Node

0.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Autologging-1.1.0-py2.py3-none-any.whl (12.8 kB) Copy SHA256 Checksum SHA256 3.5 Wheel Aug 13, 2016
Autologging-1.1.0.tar.gz (271.1 kB) Copy SHA256 Checksum SHA256 Source Aug 13, 2016
Autologging-1.1.0.win32.exe (143.0 kB) Copy SHA256 Checksum SHA256 any Windows Installer Aug 13, 2016
Autologging-1.1.0.win32.msi (122.9 kB) Copy SHA256 Checksum SHA256 any Windows MSI Installer Aug 13, 2016
Autologging-1.1.0.zip (339.8 kB) Copy SHA256 Checksum SHA256 Source Aug 13, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting