Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- modul:m323:learningunits:lu05:decorator [2024/03/28 14:07] – angelegt - Externe Bearbeitung 127.0.0.1
+++ modul:m323:learningunits:lu05:decorator [2026/09/01 11:16] (aktuell) – Animation zum @-Operator und zum Decorator mit Parameter eingebettet admin
@@ Zeile 9: / Zeile 9: @@
 ==== Syntax ====
-Die grundlegende Syntax für einen Decorator in Python ist die folgende:
+<WRAP group>
+<WRAP half column>
+Die grundlegende Syntax für einen Decorator in Python ist die folgende:
 <code python>
 def decorator_function(original_function):
@@ Zeile 22: / Zeile 24: @@
 def display():
     print("Die Display-Funktion wurde aufgerufen")
+display()
+</code></WRAP>
+<WRAP half column>
+Semantisch ist ''@decorator_function'' genau das gleiche wie eine Zuweisung direkt nach der Funktionsdefinition.
+<code python>
+def decorator_function(original_function):
+    def wrapper_function():
+        # zusätzliche Funktionalitäten hier
+        original_function()
+        # weitere zusätzliche Funktionalitäten
+    return wrapper_function
+def display():
+    print("Die Display-Funktion wurde aufgerufen")
+# das macht @decorator_function:
+display = decorator_function(display)
 display()
 </code>
+</WRAP>
+</WRAP>
 In diesem Beispiel ist ''decorator_function'' der Decorator, der die ''display''-Funktion erweitert. Der "@"-Operator ist [[https://de.wikipedia.org/wiki/Syntaktischer_Zucker|syntaktischer Zucker]] für ''display = decorator_function(display)''.
+===== Animation: was das @-Zeichen wirklich tut =====
+Die Animation zeigt genau diese Zuweisung im Speicher: wie der Name der dekorierten Funktion auf den Wrapper **umgehängt** wird und das Original danach nur noch über die Closure erreichbar ist. Der zweite Tab nimmt den Fall aus dem Abschnitt "Decorators mit eigenen Parametern" vorweg und zeigt die drei Ebenen.
+{{url>https://templates-python.github.io/m323_html/lu05/decorator.html 100%,940px noborder|Animation: Decorators, was das @-Zeichen wirklich tut}}
+Voraussetzung dafür ist das Speichermodell aus [[modul:m323:learningunits:lu05:closures|LU05c - Closures]]: der Wrapper ist eine Closure über die ursprüngliche Funktion.
 ==== Verwendung von Decorators ====
@@ Zeile 74: / Zeile 107: @@
     return factorial
 </code>
+<WRAP center round tip 80%>
+Nach dem Dekorieren heisst die Funktion intern ''wrapper_function'': ''calculate_factorial.__name__'' ergibt nicht mehr den ursprünglichen Namen. Wer das vermeiden will, setzt ''@functools.wraps(original_function)'' auf die ''wrapper_function'' – das kopiert Name und Docstring vom Original herüber.
+</WRAP>
 ===== Decorators mit eigenen Parametern =====
@@ Zeile 123: / Zeile 160: @@
 ----
-{{tag>M323-LU05}}
+{{tag>M323-LU05 M323-C2A}}
 [[https://creativecommons.org/licenses/by-nc-sa/4.0/ch/|{{https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png}}]] (c) Kevin Maurizi