Programmation PYTHON - Zenk - Security - Repository

Structuration du code
CHAPITRE 5
Pour simplifier l’écriture, les decorators introduisent un nouveau mécanisme qui
permet de spécifier qu’une fonction est encapsulée dans une deuxième fonction.
Il suffit de préfixer la définition de la fonction à encapsuler par le nom de la
deuxième fonction préfixé d’une arobase (@).
Définition d’un decorator
>>> def decorate(function):
... function.__doc__ = 'Fonction décorée %s' % function.__doc__
... return function
...
>>> @decorate
... def a_function():
... """Ma fonction."""
... print('traitement')
...
>>> print a_function.__doc__
Fonction décorée ma fonction
Plusieurs decorators peuvent êtres utilisés sur la même fonction : ils sont imbriqués
dans l’ordre de déclaration.
Enchaînement de decorators
@f1 @f2 @f3
def a_function():
pass
Cette notation étant équivalente à l’écriture ci-dessous :
Équivalent explicite
function = f1(f2(f3(function)))
Les decorators servent également à la mise en place de code patterns récurrents,
comme le contrôle de types de paramètres entrants, d’enrichissement du contexte
d’exécution ou de tout mécanisme pré ou post-exécution. La fonction décoratrice est
déclarée une bonne fois pour toute et réutilisée en decorator.
Contrôle d’argument
>>> def only_ints(func):
... def _only_ints(arg):
... ifnot isinstance(arg, int):
... raise TypeError("'%s' doit être un entier" % str(arg))
107