Odpowiedź.

Dekoratory w Pythonie powstały jako sposób na uczynienie kodu bardziej zwięzłym i czytelnym, inkapsulując powtarzające się zachowania wokół funkcji i metod. Przed pojawieniem się składni @decorator były stosowane w sposób jawny, co utrudniało zrozumienie kodu. Dziś dekoratory odgrywają kluczową rolę w organizacji logiki, powtarzających się sprawdzeń, logowaniu, buforowaniu i innych działaniach.

Problem przy używaniu dekoratorów polega na poprawnym przetwarzaniu różnic między funkcjami, metodami instancji oraz metodami statycznymi/klasowymi. Często pojawiają się błędy związane z utratą informacji o metodzie, późnym/wczesnym wiązaniem self oraz z podpisem funkcji (signature).

Rozwiązaniem jest stosowanie modułu functools.wraps w celu zachowania metadanych oraz uważne odnoszenie się do typu dekorowanego obiektu (na przykład, prawidłowe uwzględnienie, że metody instancji otrzymują self jako pierwszy argument).

Przykład kodu:

import functools

def my_decorator(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        print(f"Przed funkcją: {func.__name__}")
        result = func(*args, **kwargs)
        print(f"Po funkcji: {func.__name__}")
        return result
    return wrapper

class Example:
    @my_decorator
    def method(self, x):
        print(f"Metoda wywołana z {x}")

ex = Example()
ex.method(5)

Kluczowe cechy:

• Dekorator na poziomie metody otrzymuje funkcję, która oczekuje self jako pierwszego argumentu.
• Aby zachować oryginalne metadane, zaleca się stosować functools.wraps.
• Dekoratory można parametryzować dla większej elastyczności.

Pytania z podstępem.

Czy użycie dekoratora napisanego dla funkcji na metodzie klasy wymaga użycia functools.wraps i co stanie się z self?

Nie, sam dekorator działa, ale bez wraps traci się nazwę funkcji, pomoc IDE i dokumentację. Self nadal będzie pierwszym parametrem, ale utrata metadanych utrudni debugowanie i refleksję.

def bad_decorator(f):
    def wrapper(*args, **kwargs):
        print("ozdobiony")
        return f(*args, **kwargs)
    return wrapper

class Test:
    @bad_decorator
    def foo(self):
        pass
print(Test().foo.__name__)  # wrapper

Czy można zastosować ten sam dekorator zarówno do metody instancji, jak i do metody statycznej?

Tak, ale trzeba pamiętać: metody statyczne nie otrzymują self jako pierwszy argument. Jeśli dekorator oczekuje pracy z self, wystąpią błędy z @staticmethod / @classmethod.

Jak dekorator wpływa na podpis metody i autouzupełnianie?

Najłatwiej ująć: bez functools.wraps podpis i dokumentacja widoczna dla IDE znikają, a wiele narzędzi do podpowiadania przestaje działać poprawnie.

Typowe błędy i antywzorce

• Nie używanie functools.wraps — utrata nazwy funkcji, dokumentacji, co utrudnia debugowanie.
• Dekorator napisany dla funkcji, bez uwzględnienia self — działa nieprawidłowo na metodach.
• Ponowne wykorzystanie tego samego dekoratora bez uwzględnienia kontekstu (metoda statyczna/klasowa/zwykła metoda).

Przykład z życia

Negatywny przypadek: Dekoratory bez functools.wraps we wszystkich metodach klasy.
Zalety: szybki prototyp, działa.
Wady: niemożność śledzenia błędów przez stos, IDE nie podpowiada sygnatury.

Pozytywny przypadek: Dekoratory używają functools.wraps, kod jest udokumentowany.
Zalety: czytelność, utrzymanie, komfort IDE.
Wady: minimalny dodatek do składni i uwagi.