Convenciones de nomenclatura de Python en decoradores

Question

¿Existen convenciones de nomenclatura "aceptadas" para las entrañas de los decoradores de Python?

style guide no lo menciona, y this awesome entry about decorators es bastante consistente en el uso de variantes de "envuelto" para la última función que se devuelve, pero ¿qué ocurre con los nombres utilizados al crear decoradores que toman argumentos?

def decorator_name(whatevs): 
    def inner(function): 
     def wrapped(*args, **kwargs): 
      # sweet decorator goodness 
     return wrapped 
    return inner 

Específicamente, ¿cuáles son las convenciones para inner, function y wrapped en el ejemplo anterior?

Answer 1

No existen convenciones estandarizadas (como PEP) para esos nombres. Si comprueba el stdlib de python, encontrará muchos nombres diferentes para esas funciones.

Sin embargo, decorator es un nombre bastante común para la función de decorador inner.
También es común llamar a su función wrappedwrapper y decorarla con functools.wraps(f) con f siendo la función envuelta (func es también un nombre común para ella).

def decorator_name(whatevs): 
    def decorator(f): 
     @wraps(f) 
     def wrapper(*args, **kwargs): 
      pass # sweet decorator goodness 
     return wrapper 
    return decorator 

Answer 2

Por definición, un decorador en Python podría ser una función o una clase, por lo que el tipo de aplicación (clase o función), es el factor decisivo, que la convención de nombres para su uso. un error común es anteponer el nombre de la función con la palabra clave decorador. para obtener más información acerca de los decoradores, vea link