Creació i encadenament de decoradors de funcions en Python

Millora de les funcions de Python amb decoradors

A Python, els decoradors són una eina poderosa per modificar el comportament de funcions o mètodes. Permeten als desenvolupadors incloure funcionalitats addicionals al voltant d'una funció existent d'una manera neta i llegible. En entendre com crear i encadenar decoradors, podeu millorar considerablement la modularitat i la llegibilitat del vostre codi.

Aquest article us guiarà a través del procés de creació de dos decoradors específics: un per fer el text en negreta i un altre per fer el text en cursiva. També demostrarem com encadenar aquests decoradors per aconseguir el resultat desitjat. Al final d'aquest tutorial, podreu cridar una funció senzilla i rebre una cadena formatada amb etiquetes HTML en negreta i cursiva.

Entendre els decoradors de funcions de Python

Els scripts proporcionats mostren com crear i encadenar decoradors de funcions a Python per modificar el comportament de les funcions. Un decorador en Python es defineix mitjançant el def paraula clau per crear una funció que pren una altra funció com a argument i retorna una funció nova. El make_bold decorator embolcalla el resultat de la funció que decora amb etiquetes HTML en negreta utilitzant el format de cadena f: f"<b>{func()}</b>". De la mateixa manera, el make_italic El decorador embolica el resultat amb etiquetes en cursiva: f"<i>{func()}</i>". Quan aquests decoradors s'apliquen a una funció utilitzant el @decorator_name sintaxi, modifiquen la sortida de la funció afegint les respectives etiquetes HTML.

El segon script introdueix un enfocament més versàtil mitjançant la creació d'una funció d'ordre superior, add_html_tag, que genera decoradors per a qualsevol etiqueta HTML especificada. Aquesta funció pren una etiqueta HTML com a argument i retorna un decorador que embolcalla la sortida de la funció a l'etiqueta especificada: f"<{tag}>{func()}</{tag}>". Mitjançant l'ús de @add_html_tag("b") i @add_html_tag("i"), podem encadenar aquests decoradors per embolicar la sortida del say_hello funcionen tant en etiquetes en negreta com en cursiva, donant com a resultat el " desitjat "Hola". Aquests exemples il·lustren el poder i la flexibilitat dels decoradors de Python per millorar i personalitzar el comportament de les funcions d'una manera neta i reutilitzable.

def make_bold(func):
    def wrapper():
        return f"<b>{func()}</b>"
    return wrapper

def make_italic(func):
    def wrapper():
        return f"<i>{func()}</i>"
    return wrapper

@make_bold
@make_italic
def say():
    return "Hello"

print(say())

def add_html_tag(tag):
    def decorator(func):
        def wrapper():
            return f"<{tag}>{func()}</{tag}>"
        return wrapper
    return decorator

@add_html_tag("b")
@add_html_tag("i")
def say_hello():
    return "Hello"

print(say_hello())

Tècniques avançades de decoració de Python

Més enllà de la simple modificació de funcions, els decoradors de Python ofereixen una manera potent de millorar la reutilització i el manteniment del codi. Un cas d'ús avançat són els decoradors parametritzats, que permeten als decoradors acceptar arguments. Aquesta tècnica es va il·lustrar amb el add_html_tag decorador en els exemples anteriors. En definir un decorador que genera altres decoradors, podem crear estructures de codi altament flexibles i reutilitzables. Els decoradors parametritzats ens permeten passar paràmetres al decorador mateix, permetent modificacions dinàmiques i específiques del context en el comportament de la funció.

Un altre aspecte important dels decoradors és la seva capacitat per mantenir les metadades de la funció. Quan un decorador embolcalla una funció, les seves metadades, com ara el seu nom i la cadena de documents, es poden perdre. Per preservar aquestes metadades, les de Python functools.wraps s'utilitza dins del decorador. Mitjançant la sol·licitud @functools.wraps a la funció d'embolcall, les metadades de la funció original es copien, assegurant-se que les eines que es basen en aquestes metadades, com ara els generadors de documentació, continuen funcionant correctament. A més, els decoradors es poden apilar, tal com es mostra amb el @make_bold i @make_italic exemples, per aplicar múltiples capes de modificació del comportament d'una manera neta i llegible.