Path: csiph.com!fu-berlin.de!uni-berlin.de!not-for-mail
From: dieter <dieter@handshake.de>
Newsgroups: comp.lang.python
Subject: Re: Meta decorator with parameters, defined in explicit functions
Date: Tue, 28 Jun 2016 09:26:30 +0200
Lines: 51
Message-ID: <mailman.66.1467098809.2358.python-list@python.org>
References: <85mvm5vrbw.fsf@benfinney.id.au> <87h9cddba1.fsf@handshake.de>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Cancel-Lock: sha1:TseOhBW5aHWQjvKefby1E0Cg/S4=
User-Agent: Gnus/5.1008 (Gnus v5.10.8) XEmacs/21.4.22 (linux)
Precedence: list
Xref: csiph.com comp.lang.python:110665

Ben Finney <ben+python@benfinney.id.au> writes:
> I want an explicit replacement for a common decorator idiom.
>
> There is a clever one-line decorator that has been copy-pasted without
> explanation in many code bases for many years::
>
>     decorator_with_args = lambda decorator: lambda *args, **kwargs: lambda func: decorator(func, *args, **kwargs)
>
> My problem with this is precisely that it is clever: it explains nothing
> about what it does, has many moving parts that are not named, it is
> non-obvious and lacks expressiveness.

I have been able to understand the purpose of the definition above -
based solely on background knowledge about "decorator" and the definition.

A decorator is a function which takes a function as argument and
returns another function, the decorated function.

In its simplest form, it is usually is used like:

    @decorator
    def f....


However, there is a more complex use: a decorator with arguments.
It takes the form

    @decorator(...args...)
    def f...

In this use, the decorator is not "decorator" itself but
"decorator(...args...)". "decorator" itself is in fact a "meta" decorator
taking arguments and returning the real decorator.
The standard way to define such a meta decorator would be to have
a local function definition in its body and return that.


Locally defining functions and returning them looks a bit nasty in
Python. You might want to avoid it. That's what the
"decorator_with_args" above tries to facilitate.

It allows you to define a function "decorator"
with arguments "func, *args, **kw", decorate it with
"decorator_with_args" and use this as a decorator with arguments
("*args, **kw).

"decorator_with_args" essentially is a signature transform.
It transforms a function "func, *args, **kw --> ..." into
a function "*args, **kw --> func --> ..." *AND*
it does this in a completely natural and understandable way.