Utility that prints calls on the attribute path of the object

printcall_util.py

import logging 

logging.basicConfig()
logging.getLogger(__name__).setLevel(logging.INFO)
LOG = logging.getLogger(__name__)


class PrintCalls(object):
    """
    Log all the calls done on this object. This object wraps, and redirects
    calls to the 'obj' parameter iff given to it's constructor.

    >> # pseudo-docstring
    >> a = PrintCalls()
    >> a.foo()
    INFO:__main__:<root>.foo((), {})
    >> a.foo.bar()
    INFO:__main__:<root.foo.bar((), {})
    >> a.foo.bar.baz(1)
    INFO:__main__:<root>.foo.bar.baz(1, {})
    """
    def __init__(self, obj=None, label=tuple(['<root>'])):
        self.label = label
        self.obj = obj

    def __call__(self, *args, **kwargs):
        LOG.info('%s(%s, %s)', '.'.join(self.label),
                 ', '.join(map(str, args)), kwargs)

        if self.obj:
            self.obj(*args, **kwargs)

    def __getattr__(self, attr):
        return PrintCalls(obj=getattr(self.obj, attr, None),
                          label=self.label + (attr,))