feat(calendar): timezone argument for events/tasks (IANA, default Europe/Berlin) for travel/foreign timezones
This commit is contained in:
1 parent
a73dbe8fdc
commit
5131f77a5c
4 files changed
+83
-21
No files matched your search
+48
-20
@@ -27,11 +27,22 @@ CAL_PATHS = _cfg['calendar_paths'] # Baikal-Basen (aktiv)
|
||||
BERLIN = pytz.timezone('Europe/Berlin')
|
||||
|
||||
|
||||
def _local(dt):
|
||||
"""Naive -> Europe/Berlin lokalisieren; aware -> nach Europe/Berlin konvertieren."""
|
||||
def _local(dt, z=None):
|
||||
"""Naive -> in Zone z lokalisieren; aware -> nach z konvertieren (Default Europe/Berlin)."""
|
||||
z = z or BERLIN
|
||||
if dt.tzinfo is None:
|
||||
return BERLIN.localize(dt)
|
||||
return dt.astimezone(BERLIN)
|
||||
return z.localize(dt)
|
||||
return dt.astimezone(z)
|
||||
|
||||
|
||||
def _zone(tz):
|
||||
"""IANA-Zeitzone aufloesen. Leer/None -> Europe/Berlin. Ungueltig -> None."""
|
||||
if not tz:
|
||||
return BERLIN
|
||||
try:
|
||||
return pytz.timezone(tz)
|
||||
except Exception:
|
||||
return None
|
||||
|
||||
mcp = FastMCP("Calendar", stateless_http=True,
|
||||
transport_security={"enable_dns_rebinding_protection": False})
|
||||
@@ -126,9 +137,15 @@ def _parse(xml, comp="VEVENT", t0=None, cap=None):
|
||||
return objs
|
||||
|
||||
def _fmt_dt(v):
|
||||
"""Datetime einheitlich in Europe/Berlin darstellen (naive = lokale Wanduhrzeit)."""
|
||||
"""Datetime mit explizitem Offset darstellen. Benannte IANA-Zone (Europe/Berlin,
|
||||
Asia/Hong_Kong, ...) wird beibehalten; floating (naiv) = Berlin; feste Offset-/UTC-
|
||||
Werte (z.B. Importe) werden nach Berlin normalisiert."""
|
||||
if isinstance(v, datetime):
|
||||
return _local(v).isoformat()
|
||||
if v.tzinfo is None:
|
||||
return _local(v).isoformat()
|
||||
if getattr(v.tzinfo, "zone", None) or getattr(v.tzinfo, "key", None):
|
||||
return v.isoformat()
|
||||
return v.astimezone(BERLIN).isoformat()
|
||||
return v.isoformat() if hasattr(v, 'isoformat') else str(v)
|
||||
|
||||
|
||||
@@ -297,15 +314,15 @@ TRAVEL_MODES = ("walking", "driving", "transit", "biking")
|
||||
|
||||
|
||||
def _build_vevent_fields(ev, title, start, end, location, description, allday,
|
||||
travel_minutes, travel_mode, travel_advisory, reminder_minutes):
|
||||
travel_minutes, travel_mode, travel_advisory, reminder_minutes, z=None):
|
||||
"""Setzt VEVENT-Felder auf ein vobject-Element (wiederverwendet von create/update)."""
|
||||
ev.add("summary").value = title
|
||||
if allday:
|
||||
ev.add("dtstart").value = datetime.strptime(start, "%Y-%m-%d").date()
|
||||
ev.add("dtend").value = datetime.strptime(end, "%Y-%m-%d").date()
|
||||
else:
|
||||
ev.add("dtstart").value = _local(datetime.fromisoformat(start))
|
||||
ev.add("dtend").value = _local(datetime.fromisoformat(end))
|
||||
ev.add("dtstart").value = _local(datetime.fromisoformat(start), z)
|
||||
ev.add("dtend").value = _local(datetime.fromisoformat(end), z)
|
||||
if location:
|
||||
ev.add("location").value = location
|
||||
geo = _geocode(location)
|
||||
@@ -339,7 +356,10 @@ def _build_vevent_fields(ev, title, start, end, location, description, allday,
|
||||
|
||||
def _write_event(user, cals, title, start, end, location, description, allday,
|
||||
travel_minutes, travel_mode, travel_advisory, reminder_minutes,
|
||||
uid=None, verb="Termin erstellt"):
|
||||
uid=None, verb="Termin erstellt", timezone="Europe/Berlin"):
|
||||
z = _zone(timezone)
|
||||
if z is None:
|
||||
return f"Fehler: unbekannte Zeitzone '{timezone}' (IANA-Name, z.B. Europe/Berlin, Asia/Hong_Kong)"
|
||||
cal = vobject.iCalendar()
|
||||
ev = cal.add("vevent")
|
||||
if uid:
|
||||
@@ -349,7 +369,7 @@ def _write_event(user, cals, title, start, end, location, description, allday,
|
||||
target = cals[0]["href"] + uid + ".ics"
|
||||
ev.add("uid").value = uid
|
||||
_build_vevent_fields(ev, title, start, end, location, description, allday,
|
||||
travel_minutes, travel_mode, travel_advisory, reminder_minutes)
|
||||
travel_minutes, travel_mode, travel_advisory, reminder_minutes, z)
|
||||
r = httpx.put(_serve(user)[0] + target,
|
||||
content=cal.serialize(), auth=_auth(user),
|
||||
headers={"Content-Type": "text/calendar"}, timeout=15)
|
||||
@@ -359,6 +379,7 @@ def _write_event(user, cals, title, start, end, location, description, allday,
|
||||
if travel_mode: extras.append(f"Verkehrsmittel {travel_mode}")
|
||||
if travel_advisory: extras.append("Reisezeit aus Route")
|
||||
if reminder_minutes: extras.append(f"Erinnerung {reminder_minutes} Min. vorher")
|
||||
if timezone and timezone != "Europe/Berlin": extras.append(f"Zeitzone {timezone}")
|
||||
extra_str = f" ({', '.join(extras)})" if extras else ""
|
||||
if r.status_code in (201, 204):
|
||||
return f"{verb}: {title} am {start}{extra_str}"
|
||||
@@ -371,8 +392,8 @@ def _write_event(user, cals, title, start, end, location, description, allday,
|
||||
def create_event(
|
||||
calendar: Annotated[str, Field(description="Calendar name, e.g. 'Stefan', 'Arbeit', 'Familie'")],
|
||||
title: Annotated[str, Field(description="Event title")],
|
||||
start: Annotated[str, Field(description="Start: YYYY-MM-DD for all-day, or YYYY-MM-DDTHH:MM for timed events, e.g. '2026-06-15T14:00'. Lokale Zeit Europe/Berlin; explizite Offsets/Z werden konvertiert.")],
|
||||
end: Annotated[str, Field(description="End: YYYY-MM-DD for all-day, or YYYY-MM-DDTHH:MM, e.g. '2026-06-15T15:30'. Lokale Zeit Europe/Berlin.")],
|
||||
start: Annotated[str, Field(description="Start: YYYY-MM-DD for all-day, or YYYY-MM-DDTHH:MM for timed events, e.g. '2026-06-15T14:00'. Lokale Zeit in der Zone aus 'timezone' (Default Europe/Berlin); explizite Offsets/Z werden in diese Zone konvertiert.")],
|
||||
end: Annotated[str, Field(description="End: YYYY-MM-DD for all-day, or YYYY-MM-DDTHH:MM, e.g. '2026-06-15T15:30'. Lokale Zeit in der Zone aus 'timezone'.")],
|
||||
location: Annotated[str, Field(description="Location/Ziel als Text oder POI, e.g. 'Marienplatz 1, Muenchen'. Gets geocoded for map / POI.")] = "",
|
||||
description: Annotated[str, Field(description="Event description or notes")] = "",
|
||||
allday: Annotated[bool, Field(description="True for all-day events (then use YYYY-MM-DD for start/end)")] = False,
|
||||
@@ -380,15 +401,16 @@ def create_event(
|
||||
travel_mode: Annotated[str, Field(description="Optional. Verkehrsmittel fuer die Reise: walking, driving, transit, biking. Leer lassen, wenn nicht relevant.")] = "",
|
||||
travel_advisory: Annotated[bool, Field(description="True: Apple Kalender berechnet die Reise-Erinnerungszeit selbst dynamisch aus der aktuellen Route anhand des Ziels (location). Empfohlen fuer Termine mit Zieladresse.")] = False,
|
||||
reminder_minutes: Annotated[int, Field(description="Reminder alert X minutes before the event (0=none, e.g. 15, 30, 60)")] = 0,
|
||||
timezone: Annotated[str, Field(description="IANA-Zeitzone fuer start/end. Default 'Europe/Berlin'. Fuer Termine im Ausland die Zonen-Zeit nehmen, z.B. 'Asia/Hong_Kong' (dann start/end dort lokal, z.B. 18:00).")] = "Europe/Berlin",
|
||||
) -> str:
|
||||
"""Create a new calendar event. For all-day events, end date is exclusive (June 15 only → start=2026-06-15, end=2026-06-16). Timed events werden als Europe/Berlin (TZID) gespeichert. Location/Ziel wird geocoded (POI/Karte). Mit travel_advisory=true + Ziel berechnet Apple die Reise-Erinnerung dynamisch aus der Route."""
|
||||
"""Create a new calendar event. For all-day events, end date is exclusive (June 15 only → start=2026-06-15, end=2026-06-16). Timed events werden mit TZID der angegebenen 'timezone' gespeichert (Default Europe/Berlin). Location/Ziel wird geocoded (POI/Karte). Mit travel_advisory=true + Ziel berechnet Apple die Reise-Erinnerung dynamisch aus der Route."""
|
||||
user = get_current_user()
|
||||
if not user: return "Error: not authenticated"
|
||||
cals = _match_cols(_discover(user, "VEVENT"), calendar)
|
||||
if not cals: return f"Kalender '{calendar}' nicht gefunden"
|
||||
return _write_event(user, cals, title, start, end, location, description, allday,
|
||||
travel_minutes, travel_mode, travel_advisory, reminder_minutes,
|
||||
verb="Termin erstellt")
|
||||
verb="Termin erstellt", timezone=timezone)
|
||||
|
||||
|
||||
@mcp.tool()
|
||||
@@ -405,6 +427,7 @@ def update_event(
|
||||
travel_mode: Annotated[str, Field(description="Optional. Verkehrsmittel: walking, driving, transit, biking.")] = "",
|
||||
travel_advisory: Annotated[bool, Field(description="True: Apple berechnet die Reise-Erinnerungszeit dynamisch aus der Route anhand des Ziels.")] = False,
|
||||
reminder_minutes: Annotated[int, Field(description="Reminder alert X minutes before the event (0=none)")] = 0,
|
||||
timezone: Annotated[str, Field(description="IANA-Zeitzone fuer start/end. Default 'Europe/Berlin'. Fuer Termine im Ausland die Zonen-Zeit nehmen, z.B. 'Asia/Hong_Kong'.")] = "Europe/Berlin",
|
||||
) -> str:
|
||||
"""Update an existing calendar event (full overwrite of its fields). All optional fields default to clearing the previous value."""
|
||||
user = get_current_user()
|
||||
@@ -413,10 +436,13 @@ def update_event(
|
||||
if not cals: return f"Kalender '{calendar}' nicht gefunden"
|
||||
return _write_event(user, cals, title, start, end, location, description, allday,
|
||||
travel_minutes, travel_mode, travel_advisory, reminder_minutes,
|
||||
uid=uid, verb="Termin aktualisiert")
|
||||
uid=uid, verb="Termin aktualisiert", timezone=timezone)
|
||||
|
||||
|
||||
def _write_task(user, lists, title, due, priority, description, uid=None, verb="Aufgabe erstellt"):
|
||||
def _write_task(user, lists, title, due, priority, description, uid=None, verb="Aufgabe erstellt", timezone="Europe/Berlin"):
|
||||
z = _zone(timezone)
|
||||
if z is None:
|
||||
return f"Fehler: unbekannte Zeitzone '{timezone}' (IANA-Name, z.B. Europe/Berlin, Asia/Hong_Kong)"
|
||||
cal = vobject.iCalendar()
|
||||
todo = cal.add("vtodo")
|
||||
if uid:
|
||||
@@ -427,7 +453,7 @@ def _write_task(user, lists, title, due, priority, description, uid=None, verb="
|
||||
todo.add("uid").value = uid
|
||||
todo.add("summary").value = title
|
||||
todo.add("status").value = "NEEDS-ACTION"
|
||||
if due: todo.add("due").value = _local(datetime.fromisoformat(due)) if "T" in due else datetime.strptime(due, "%Y-%m-%d").date()
|
||||
if due: todo.add("due").value = _local(datetime.fromisoformat(due), z) if "T" in due else datetime.strptime(due, "%Y-%m-%d").date()
|
||||
if priority: todo.add("priority").value = str(priority)
|
||||
if description: todo.add("description").value = description
|
||||
todo.add("dtstamp").value = datetime.utcnow()
|
||||
@@ -446,13 +472,14 @@ def create_task(
|
||||
due: Annotated[str, Field(description="Due date: YYYY-MM-DD or YYYY-MM-DDTHH:MM. Leave empty for no due date.")] = "",
|
||||
priority: Annotated[int, Field(description="Priority 1-9 (1=highest, 9=lowest, 0=none)")] = 0,
|
||||
description: Annotated[str, Field(description="Task notes")] = "",
|
||||
timezone: Annotated[str, Field(description="IANA-Zeitzone fuer due (nur bei HH:MM). Default 'Europe/Berlin', z.B. 'Asia/Hong_Kong' im Ausland.")] = "Europe/Berlin",
|
||||
) -> str:
|
||||
"""Create a new task/reminder in the specified list."""
|
||||
user = get_current_user()
|
||||
if not user: return "Error: not authenticated"
|
||||
lists = _match_cols(_discover(user, "VTODO"), task_list)
|
||||
if not lists: return f"Liste '{task_list}' nicht gefunden"
|
||||
return _write_task(user, lists, title, due, priority, description, verb="Aufgabe erstellt")
|
||||
return _write_task(user, lists, title, due, priority, description, verb="Aufgabe erstellt", timezone=timezone)
|
||||
|
||||
|
||||
@mcp.tool()
|
||||
@@ -463,13 +490,14 @@ def update_task(
|
||||
due: Annotated[str, Field(description="Due date: YYYY-MM-DD or YYYY-MM-DDTHH:MM. Leave empty for no due date.")] = "",
|
||||
priority: Annotated[int, Field(description="Priority 1-9 (1=highest, 9=lowest, 0=none)")] = 0,
|
||||
description: Annotated[str, Field(description="Task notes")] = "",
|
||||
timezone: Annotated[str, Field(description="IANA-Zeitzone fuer due (nur bei HH:MM). Default 'Europe/Berlin'.")] = "Europe/Berlin",
|
||||
) -> str:
|
||||
"""Update an existing task/reminder (full overwrite of its fields) in the specified list."""
|
||||
user = get_current_user()
|
||||
if not user: return "Error: not authenticated"
|
||||
lists = _match_cols(_discover(user, "VTODO"), task_list)
|
||||
if not lists: return f"Liste '{task_list}' nicht gefunden"
|
||||
return _write_task(user, lists, title, due, priority, description, uid=uid, verb="Aufgabe aktualisiert")
|
||||
return _write_task(user, lists, title, due, priority, description, uid=uid, verb="Aufgabe aktualisiert", timezone=timezone)
|
||||
|
||||
|
||||
@mcp.tool()
|
||||
|
||||
Reference in new issue
Block a user