o .j @s~dZddlmZddlmZddlmZmZddlm Z ddl Z ddl m Z ddl mZe r4dd lmZeGd d d ZdS) a( JMAP calendar resource object. Wraps a raw JSCalendar CalendarEvent dict with the same minimal interface as :class:`caldav.calendarobjectresource.CalendarObjectResource`: ``.id``, ``.parent``, :meth:`get_data`, :meth:`get_icalendar_instance`, :meth:`edit_icalendar_instance`, and :meth:`save`. ) annotations)contextmanager) dataclassfield) TYPE_CHECKINGN) jscal_to_ical)JMAPMethodError) JMAPCalendarc@sreZdZUdZded<ded<edddddZd ed <edd dZdddZ dddZ e ddZ dddZ dS)JMAPCalendarObjectuqThin wrapper around a raw JSCalendar CalendarEvent dict. Stores the server's JSON response as-is. No JMAP field names are mapped to typed attributes — callers work with the dict directly via :meth:`get_data`, or convert to iCalendar via :meth:`get_icalendar_instance`. Attributes: data: Raw JSCalendar CalendarEvent dict as returned by ``CalendarEvent/get``. parent: The :class:`~caldav.jmap.objects.calendar.JMAPCalendar` this object belongs to, or ``None`` when fetched without a calendar context (e.g. via :meth:`~caldav.jmap.client.JMAPClient.get_event`). dictdatazJMAPCalendar | NoneparentNF)defaultinitreprcomparezicalendar.Calendar | None _ical_cachereturnstrcCs |jdS)zServer-assigned JMAP event ID.idr selfrX/home/thesage/.local/lib/python3.10/site-packages/caldav/jmap/objects/calendar_object.pyr/s zJMAPCalendarObject.idcCs|jS)zDReturn the raw JSCalendar dict as returned by ``CalendarEvent/get``.rrrrrget_data4szJMAPCalendarObject.get_dataicalendar.CalendarcCs$|jdurtjt|j|_|jS)zReturn an :class:`icalendar.Calendar` for this object. The result is cached after the first conversion. Treat it as read-only; use :meth:`edit_icalendar_instance` to make and persist changes. N)r icalendarCalendar from_icalrr rrrrget_icalendar_instance8s z)JMAPCalendarObject.get_icalendar_instanceccs|}|VdS)aBorrow an editable :class:`icalendar.Calendar` for this object. Yields the cached :class:`icalendar.Calendar` for in-place editing. Call :meth:`save` after the ``with`` block to persist changes to the server. Note: :meth:`save` is sync-only. Async-backed calendars cannot use this path yet. Example:: with obj.edit_icalendar_instance() as cal: cal.subcomponents[0]["SUMMARY"] = vText("New title") obj.save() N)r )rcalrrredit_icalendar_instanceCs z*JMAPCalendarObject.edit_icalendar_instanceNonecCs^|jdur tddd|jjrtd|jdur|jnt|j}|jj |j |dS)aPersist changes made via :meth:`edit_icalendar_instance` to the server. Serialises the (possibly edited) icalendar object back to an iCalendar string and calls ``update_event()`` on the parent calendar's client. Raises: JMAPMethodError: If no parent calendar is set (``parent`` is ``None``). RuntimeError: If called on an async-backed calendar. NzN/Az&Cannot save: no parent calendar is set)urlreasonzesave() is not supported for async-backed calendars. Use await parent._client.update_event() directly.) r r _is_async RuntimeErrorrto_icaldecoderr _client update_eventr)rical_strrrrsaveVs  zJMAPCalendarObject.save)rr)rr )rr)rr#)__name__ __module__ __qualname____doc____annotations__rrpropertyrrr rr"r-rrrrr s      r )r1 __future__r contextlibr dataclassesrrtypingrrcaldav.jmap.convertrcaldav.jmap.errorrcaldav.jmap.objects.calendarr r rrrrs