i#dZddlmZddlmZ d,d-d Zd.dZ d/d0dZd1dZ d2d3dZ d4d Z d5d6d"Z d7d%Z d8d'Z d9d)Zd:d+ZdS);u JMAP CalendarEvent method builders and response parsers. These are pure functions — no HTTP, no state. They build the request tuples that go into a ``methodCalls`` list, and parse the corresponding ``methodResponses`` entries. Method shapes follow RFC 8620 §3.3 (get), §3.4 (changes), §3.5 (set), §3.6 (query), §3.7 (queryChanges); CalendarEvent-specific properties are defined in the JMAP Calendars specification. ) annotationsparse_set_responseN account_idstridslist[str] | None propertiesreturntuplec$||d}|||d<d|dfS)aBuild a ``CalendarEvent/get`` method call tuple. Args: account_id: The JMAP accountId to query. ids: List of event IDs to fetch, or ``None`` to fetch all. properties: List of property names to return, or ``None`` for all. Returns: A 3-tuple ``("CalendarEvent/get", arguments_dict, call_id)`` suitable for inclusion in a ``methodCalls`` list. ) accountIdrNr zCalendarEvent/getzev-get-0)rrr argss U/root/projects/butler/venv/lib/python3.11/site-packages/caldav/jmap/_methods/event.pybuild_event_getrs. *#66D'\ z 22 response_argsdict list[dict]cHt|dgS)agParse the arguments dict from a ``CalendarEvent/get`` method response. Args: response_args: The second element of a ``methodResponses`` entry whose method name is ``"CalendarEvent/get"``. Returns: List of raw JSCalendar dicts as returned by the server. Returns an empty list if ``"list"`` is absent or empty. list)rgetrs rparse_event_getr(s"  !!&"-- . ..r since_state max_changes int | Nonec$||d}|||d<d|dfS)aBuild a ``CalendarEvent/changes`` method call tuple. Args: account_id: The JMAP accountId to query. since_state: The ``state`` string from a previous ``CalendarEvent/get`` or ``CalendarEvent/changes`` response. max_changes: Optional upper bound on the number of changes returned. The server may return fewer. Returns: A 3-tuple ``("CalendarEvent/changes", arguments_dict, call_id)``. )r sinceStateN maxChangeszCalendarEvent/changesz ev-changes-0r)rrrrs rbuild_event_changesr"6s." *EED(\ #T> ::r6tuple[str, str, bool, list[str], list[str], list[str]]c|dd|dd|dd|dpg|dpg|dpgfS) aParse the arguments dict from a ``CalendarEvent/changes`` response. Args: response_args: The second element of a ``methodResponses`` entry whose method name is ``"CalendarEvent/changes"``. Returns: A 6-tuple ``(old_state, new_state, has_more_changes, created, updated, destroyed)``: - ``old_state``: Echo of the ``sinceState`` argument. - ``new_state``: State string to store as the next sync token. - ``has_more_changes``: True if the server capped the response. - ``created``: IDs of newly created events. - ``updated``: IDs of modified events. - ``destroyed``: IDs of deleted events. oldStatenewStatehasMoreChangesFcreatedupdated destroyed)rrs rparse_event_changesr,Ms( *b))*b))*E22)$$*)$$*+&&,"  rfilter_condition dict | Nonesortlist[dict] | Nonepositionintlimitc@||d}|||d<|||d<|||d<d|dfS)aBuild a ``CalendarEvent/query`` method call tuple. Args: account_id: The JMAP accountId to query. filter_condition: A ``FilterCondition`` or ``FilterOperator`` dict, e.g. ``{"after": "2024-01-01T00:00:00Z", "before": "2024-12-31T23:59:59Z"}``. ``None`` means no filter (return all events). sort: List of ``Comparator`` dicts, e.g. ``[{"property": "start", "isAscending": True}]``. ``None`` means server default ordering. position: Zero-based index of the first result to return. limit: Maximum number of IDs to return. ``None`` means no limit. Returns: A 3-tuple ``("CalendarEvent/query", arguments_dict, call_id)``. )rr1Nfilterr/r3zCalendarEvent/queryz ev-query-0r)rr-r/r1r3rs rbuild_event_queryr6jsK. *x@@D#)X V  W !4 66rtuple[list[str], str, int]c|dg}|dd}|dt|}|||fS)a&Parse the arguments dict from a ``CalendarEvent/query`` response. Args: response_args: The second element of a ``methodResponses`` entry whose method name is ``"CalendarEvent/query"``. Returns: A 3-tuple ``(ids, query_state, total)``: - ``ids``: Ordered list of matching event IDs. - ``query_state``: Opaque state string for use with ``CalendarEvent/queryChanges``. - ``total``: Total number of matching events (may exceed ``len(ids)`` when a limit was applied). r queryStater&total)rlen)rr query_stater:s rparse_event_queryr=sV #&&ub11C$((r::K""7CHH55E  U ""rsince_query_statec@||d}|||d<|||d<|||d<d|dfS)aSBuild a ``CalendarEvent/queryChanges`` method call tuple. Args: account_id: The JMAP accountId to query. since_query_state: The ``queryState`` string from a previous ``CalendarEvent/query`` or ``CalendarEvent/queryChanges`` response. filter_condition: Same filter as the original ``CalendarEvent/query`` call. sort: Same sort as the original ``CalendarEvent/query`` call. max_changes: Optional upper bound on the number of changes returned. Returns: A 3-tuple ``("CalendarEvent/queryChanges", arguments_dict, call_id)``. )rsinceQueryStateNr5r/r!zCalendarEvent/queryChangesz ev-qchanges-0r)rr>r-r/rrs rbuild_event_query_changesrAsM( *>OPPD#)X V (\ ($ @@reventsdict[str, dict]c,d|t|ddfS)uBuild a ``CalendarEvent/set`` method call for creating events. Args: account_id: The JMAP accountId. events: Map of client-assigned creation ID → JSCalendar dict. The creation IDs are ephemeral — they are used to correlate server responses with individual creation requests within the same batch call. Returns: A 3-tuple ``("CalendarEvent/set", arguments_dict, call_id)``. CalendarEvent/set)rcreatezev-set-create-0)r)rrBs rbuild_event_set_createrGs," #6ll     rupdatescd||ddfS)uBuild a ``CalendarEvent/set`` method call for updating events. Args: account_id: The JMAP accountId. updates: Map of event ID → partial patch dict. Keys are property names (or JSON Pointer paths for nested properties); values are the new values. Use ``None`` as a value to reset a property to its server default. Returns: A 3-tuple ``("CalendarEvent/set", arguments_dict, call_id)``. rE)rupdatezev-set-update-0r)rrHs rbuild_event_set_updaterKs"  G44 r list[str]cd||ddfS)zBuild a ``CalendarEvent/set`` method call for destroying events. Args: account_id: The JMAP accountId. ids: List of event IDs to destroy. Returns: A 3-tuple ``("CalendarEvent/set", arguments_dict, call_id)``. rE)rdestroyzev-set-destroy-0r)rrs rbuild_event_set_destroyrOs  S11 r.tuple[dict, dict, list[str], dict, dict, dict]c t|S)zParse the arguments dict from a ``CalendarEvent/set`` method response. Returns a 6-tuple ``(created, updated, destroyed, not_created, not_updated, not_destroyed)``. See :func:`caldav.jmap._methods.parse_set_response` for field semantics. rrs rparse_event_setrRs m , ,,r)NN)rrrr r r r r )rrr r)N)rrrrrrr r )rrr r#)NNrN) rrr-r.r/r0r1r2r3rr r )rrr r7)NNN) rrr>rr-r.r/r0rrr r )rrrBrCr r )rrrHrCr r )rrrrLr r )rrr rP)__doc__ __future__rcaldav.jmap._methodsrrrr"r,r6r=rArGrKrOrRrrrrVs[  #"""""333333 !#'33333, / / / /"#;;;;;.>%)" 77777B####2%)"" AAAAA<4.(------r