Decorators

@decorator

Transforms a flat wrapper into a decorator with arguments or not. @decorator passes special call object as first argument to a wrapper.

An easy way to create decorators. Here is a simple logging decorator:

@decorator
def log(call):
    print call._func.__name__, call._args, call._kwargs
    return call()

call object also supports by name arg introspection and passing additional arguments to decorated function:

@decorator
def with_phone(call):
    # call.request gets actual request value upon function call
    phone = Phone.objects.get(number=call.request.GET['phone'])
    # phone arg is added to *args passed to decorated function
    return call(phone)

@with_phone
def some_view(request, phone):
    # ... some code using phone
    return # ...

You can easily create decorators with arguments too:

@decorator
def joining(call, sep):
    return sep.join(imap(sep.__class__, call()))

Usage example shown in joining() docs.

You can see more examples in flow and debug submodules source code.