Autologging 0.4.0

Autologging makes logging and tracing Python classes easy.

Autologging provides two decorators and a metaclass factory:

@logged

Decorate a class (or function) to create a __logger member. The logger is automatically named to match the dotted-name of the class or module. Alternatively, provide a specific logger by passing it to the decorator (i.e. logged(my_logger)).

@traced

Decorate a module-level function to provide call/return tracing. The log record attributes pathname, filename, lineno, module, and funcName work as expected (i.e. they refer to the original function, NOT the proxy function returned by the decorator).

TracedMethods

Create a metaclass that adds automatic tracing to specified class methods (just like @traced does for module-level functions). The log record attributes pathname, filename, lineno, module, and funcName work as expected (i.e. they refer to the original class method, NOT the proxy method installed by the metaclass).

Additionally, an autologging.TRACE (level 1) custom log level is registered with the Python logging module so that tracing messages can be toggled on/off independently of DEBUG-level logging.