initial commit

app.py

@@ -8,8 +8,17 @@ from gematria import calculate_gematria, strip_diacritics
 from datetime import datetime, timedelta
 import json
 
-# --- Helper Functions ---
+# --- Hilfsfunktionen ---
 def calculate_gematria_sum(text):
+    """
+    Berechnet die Gematria-Summe eines gegebenen Textes.
+
+    Args:
+      text: Der Text, für den die Gematria-Summe berechnet werden soll.
+
+    Returns:
+      Die Gematria-Summe des Textes, oder None, falls der Text leer ist.
+    """
     if text:
         text_gematria = calculate_gematria(strip_diacritics(text))
         return text_gematria
@@ -18,19 +27,29 @@ def calculate_gematria_sum(text):
 
 def date_to_words(date_string):
     """
-    Konvertiert ein Datum im Format YYYY-MM-DD in die englische Schreibweise.
+    Konvertiert ein Datum im Format YYYY-MM-DD in die englische Schreibweise des Tages.
 
     Args:
       date_string: Ein Datum im Format YYYY-MM-DD.
 
     Returns:
-      Einen String mit der englischen Schreibweise des Datums.
+      Einen String mit der englischen Schreibweise des Tages.
     """
     date_obj = datetime.strptime(date_string, "%Y-%m-%d")
     return date_obj.strftime("%A")
 
 def perform_gematria_calculation_for_date_range(start_date, end_date):
-    logger.info(f"Startdatum: {start_date}, Enddatum: {end_date}")  # Debugging-Ausgabe
+    """
+    Führt die Gematria-Berechnung für einen Datumsbereich durch.
+
+    Args:
+      start_date: Das Startdatum als datetime-Objekt.
+      end_date: Das Enddatum als datetime-Objekt.
+
+    Returns:
+      Ein Dictionary mit den Ergebnissen, gruppiert nach Gematria-Summe.
+    """
+    logger.info(f"Startdatum: {start_date}, Enddatum: {end_date}")
     results = {}
     delta = timedelta(days=1)
     current_date = start_date
@@ -39,9 +58,9 @@ def perform_gematria_calculation_for_date_range(start_date, end_date):
         # Datum in String umwandeln
         date_string = current_date.strftime("%Y-%m-%d")
         date_words = date_to_words(date_string)
-        logger.info(f"Datum: {current_date}, Tagesnamen: {date_words}")  # Debugging-Ausgabe
+        logger.info(f"Datum: {current_date}, Tagesname: {date_words}")
         gematria_sum = calculate_gematria_sum(date_words)
-        logger.info(f"Gematria-Summe: {gematria_sum}")  # Debugging-Ausgabe
+        logger.info(f"Gematria-Summe: {gematria_sum}")
 
         if gematria_sum not in results:
             results[gematria_sum] = []
@@ -56,6 +75,17 @@ def perform_gematria_calculation_for_date_range(start_date, end_date):
     return results
 
 def generate_json_output(results, start_date, end_date):
+    """
+    Generiert die JSON-Ausgabe mit dem Datumsbereich und den Ergebnissen.
+
+    Args:
+      results: Ein Dictionary mit den Ergebnissen, gruppiert nach Gematria-Summe.
+      start_date: Das Startdatum als datetime-Objekt.
+      end_date: Das Enddatum als datetime-Objekt.
+
+    Returns:
+      Einen JSON-String mit den Ergebnissen.
+    """
     result = {
         "DateRange": {
             "StartDate": start_date.strftime("%Y-%m-%d"),
@@ -65,23 +95,33 @@ def generate_json_output(results, start_date, end_date):
     }
     return json.dumps(result, indent=4, ensure_ascii=False)
 
-# --- Main Gradio App ---
+# --- Hauptanwendung mit Gradio ---
 with gr.Blocks() as app:
     with gr.Row():
-        start_date = Calendar(type="datetime", label="Start Date")
-        end_date = Calendar(type="datetime", label="End Date")
+        start_date = Calendar(type="datetime", label="Startdatum")
+        end_date = Calendar(type="datetime", label="Enddatum")
 
-    calculate_btn = gr.Button("Calculate Gematria for Date Range")
-    json_output = gr.Textbox(label="JSON Output")
+    calculate_btn = gr.Button("Gematria für Zeitraum berechnen")
+    json_output = gr.Textbox(label="JSON-Ausgabe")
 
-    # --- Event Handlers ---
+    # --- Event-Handler ---
     def perform_calculation(start_date, end_date):
+        """
+        Führt die Berechnung aus und generiert die JSON-Ausgabe.
+
+        Args:
+          start_date: Das Startdatum als datetime-Objekt.
+          end_date: Das Enddatum als datetime-Objekt.
+
+        Returns:
+          Den JSON-String mit den Ergebnissen.
+        """
         logger.info(f"perform_calculation aufgerufen mit: start_date={start_date}, end_date={end_date}")
         results = perform_gematria_calculation_for_date_range(start_date, end_date)
         json_result = generate_json_output(results, start_date, end_date)
         return json_result
 
-    # --- Event Triggers ---
+    # --- Event-Trigger ---
     calculate_btn.click(
         perform_calculation,
         inputs=[start_date, end_date],