diff --git a/pr 5/run_once.py b/pr 5/run_once.py index 6a15d32..31a70f2 100644 --- a/pr 5/run_once.py +++ b/pr 5/run_once.py @@ -2,21 +2,33 @@ from functools import wraps def run_once(func): + """Ein Decorator, der sicherstellt, dass die dekorierte Funktion + + nur ein einziges Mal ausgeführt wird. + """ + # Diese Variablen in der äußeren Funktion dienen als Zustand (State) für die Closure. + # Jede mit @run_once dekorierte Funktion bekommt über diese Closure ihren eigenen Merker. has_run = False result = None + # @wraps kopiert den Namen und Docstring der Originalfunktion auf den wrapper, + # damit Funktionen wie help() oder Metadaten erhalten bleiben. @wraps(func) def wrapper(*args, **kwargs): + # Mit 'nonlocal' teilen wir Python mit, dass wir die Variablen 'has_run' + # und 'result' aus der äußeren Funktion (dem Scope von run_once) lesen + # und verändern wollen, statt neue lokale Variablen anzulegen. nonlocal has_run, result + + # Beim ersten Aufruf wurde has_run noch nicht auf True gesetzt if not has_run: - result = func(*args, **kwargs) - has_run = True + result = func(*args, **kwargs) # Funktion regulär ausführen + has_run = True # Merken, dass sie nun ausgeführt wurde return result else: - print( - f"Hinweis: '{func.__name__}' wurde bereits ausgeführt und wird" - " übersprungen." - ) + # Bei allen Folgeaufrufen wird die Funktion übersprungen + # und direkt das gemerkte Ergebnis zurückgegeben. + print("Already executed") return result return wrapper @@ -25,11 +37,16 @@ def run_once(func): # Testen der Funktionalität @run_once def initialisiere_datenbank(): + """Simuliert den Aufbau der Datenbankverbindung.""" print("--> Datenbankverbindung wird aufgebaut...") return "DB_OK" # Aufrufe testen -print(initialisiere_datenbank()) # Führt die Funktion aus -print(initialisiere_datenbank()) # Wird übersprungen, gibt gemerktes Ergebnis zurück -print(initialisiere_datenbank()) # Wird ebenfalls übersprungen \ No newline at end of file +print( + initialisiere_datenbank() +) # Führt die Funktion aus und gibt "DB_OK" zurück +print( + initialisiere_datenbank() +) # Gibt "Already executed" aus und liefert das gemerkte "DB_OK" +print(initialisiere_datenbank()) # Gibt ebenfalls "Already executed" aus \ No newline at end of file