doc

api/advent22_api/core/depends.py

@@ -26,7 +26,7 @@ async def get_all_event_days(
     days: list[int] = Depends(get_all_days),
 ) -> EventDays:
     """
-    Aktuelles EventDays Objekt
+    Aktueller Kalender-Zeitraum
     """
 
     return EventDays.get(

api/advent22_api/core/helpers.py

@@ -73,6 +73,15 @@ async def api_return_image(img: Image.Image) -> StreamingResponse:
 
 
 class EventDays(BaseModel):
+    """
+    Kenndaten eines Ereigniszeitraums:
+
+    - `first`: Datum des ersten Ereignisses
+    - `next`: Datum des nächsten Ereignisses
+    - `last`: Datum des letzten Ereignisses
+    - `end`: Letztes Datum Ereigniszeitraums
+    """
+
     first: date
     next: date | None
     last: date
@@ -94,7 +103,7 @@ class EventDays(BaseModel):
         closing_after: int,
     ) -> Self:
         """
-        foo bar
+        Kenndaten des aktuellen (laufenden oder zukünftigen) Ereigniszeitraums bestimmen
         """
 
         # account for the last event, then add closing period