ANN: Tracerlib 0.1 Released

[Calvin Spealman]

Tracerlib is a set of utilities to make tracing Python code easier.

It provides TracerManager, which can allow multiple trace functions to
coexist. It can easily be enabled and disabled, either manually or as
a context manager in a with statement.

Tracer classes make handling the different trace events much easier.

class TraceExceptions(Tracer):
    def trace_exception(self, func_name, exctype, value, tb):
        print "Saw an exception: %r" % (value,)

Tracer is also easily capable of filtering which events it listens to.
It accepts both an events parameter, a list of trace events it will
respond to, and a watch parameter, a list of paths it will respond to
in the form of package.module.class.function.

This can easily wrap a trace function, or you can subclass Tracer and
implement one of its helpful trace_*() methods.

And, a helper class FrameInspector which wraps a frame and makes it
trivial to inspect the function name and arguments the function had
been called with.

inspector = FrameInspector(sys._getframe())

print "Called", inspector.func_name
print "args:", inspector.args
print "kwargs:", inspector.kwargs

You can read the full documentation at the read the docs site and see
the code at github.

http://tracerlib.readthedocs.org
https://github.com/ironfroggy/tracerlib