i(dZddlmZddlmZmZddlmZddlmZddl m Z er ddl m Z ddl mZeGd d Zd S) z JMAP Calendar object. Represents a JMAP Calendar resource as returned by ``Calendar/get``. Properties are defined in the JMAP Calendars specification. ) annotations) dataclassfield)datetime) TYPE_CHECKING)JMAPCalendarObject)AsyncJMAPClient) JMAPClientc0eZdZUdZded<ded<dZded<dZded<d Zd ed <ee Z d ed<dZ ded<d Z d ed<eddddZ ded<eddddZd ed<ed&dZd'dZdZd(dZd)d*d Zd+d"Zd,d$Zd,d%ZdS)- JMAPCalendaruA JMAP Calendar object. Attributes: id: Server-assigned calendar identifier. name: Display name of the calendar. description: Optional longer description. color: Optional CSS color string (e.g. ``"#ff0000"``). is_subscribed: Whether the user is subscribed to this calendar. my_rights: Dict of right names → bool for the current user. sort_order: Hint for display ordering (lower = first). is_visible: Whether the calendar should be displayed. stridnameNz str | None descriptioncolorTbool is_subscribed)default_factorydict my_rightsrint sort_order is_visibleF)defaultinitreprcomparez#JMAPClient | AsyncJMAPClient | None_client _is_asyncdatareturnc ,||d|d|d|d|dd|di|dd |d d S) zConstruct a JMAPCalendar from a raw JMAP Calendar JSON dict. Unknown keys in ``data`` are silently ignored so that forward compatibility is maintained as the spec evolves. rrrr isSubscribedTmyRights sortOrderr isVisible)rrrrrrrr)get)clsr s W/root/projects/butler/venv/lib/python3.11/site-packages/caldav/jmap/objects/calendar.py from_jmapzJMAPCalendar.from_jmap3ssDzf//((7##((>488hhz2..xx Q//xx T22    c|j|j|j|jd}|j |j|d<|j |j|d<|S)u!Serialise to a JMAP Calendar JSON dict for ``Calendar/set``. ``id`` and ``myRights`` are intentionally excluded — both are server-set and must not appear in create or update payloads. Optional fields are included only when they hold a non-default value. )rr#r%r&Nrr)rrrrrr)selfds r)to_jmapzJMAPCalendar.to_jmapEsUI .      '#/Am  : !AgJr+c |jr |jdi|S|d}|d}t|tr|}t|tr|}|j|j|||d|S)a5Search for calendar objects in this calendar. Mirrors :meth:`caldav.collection.Calendar.search`. When called on an async-backed calendar, returns a coroutine that must be awaited. Accepted keyword arguments (all optional): - ``start`` (datetime or str): only events ending after this time (maps to JMAP ``after`` filter). - ``end`` (datetime or str): only events starting before this time (maps to JMAP ``before`` filter). - ``text`` (str): free-text search across title, description, locations, and participants. Unknown parameters are silently ignored for backward compatibility. Returns: List of :class:`~caldav.jmap.objects.calendar_object.JMAPCalendarObject` for all matching objects. startendtext calendar_idr1r2r3parent) r _async_searchr' isinstancer isoformatr_searchrr- searchargsr1r2s r)searchzJMAPCalendar.searchXs* > 4%4%33 33 3w''nnU## eX & & &OO%%E c8 $ $ "--//C|##'' $   r+list[JMAPCalendarObject]cxK|d}|d}t|tr|}t|tr|}|j|j|||d|d{VS)Nr1r2r3r4)r'r9rr:rr;rr<s r)r8zJMAPCalendar._async_search}sw''nnU## eX & & &OO%%E c8 $ $ "--//C\))'' *         r+uidc~|jr||S|j||j|S)aGet a calendar object by its iCalendar UID. Mirrors :meth:`caldav.collection.Calendar.get_object_by_uid`. When called on an async-backed calendar, returns a coroutine that must be awaited. Args: uid: The iCalendar UID to search for. comp_class: Accepted for API compatibility with the CalDAV interface; JMAP ``CalendarEvent/query`` has no native component-type filter, so this argument is currently ignored. Returns: A :class:`~caldav.jmap.objects.calendar_object.JMAPCalendarObject` for the matching object. Raises: JMAPMethodError: If no object with this UID is found. r5r6)r_async_get_object_by_uidr_get_object_by_uidr)r-rA comp_classs r)get_object_by_uidzJMAPCalendar.get_object_by_uidsB( > 60055 5|..sPT.UUUr+rcVK|j||j|d{VS)NrC)rrEr)r-rAs r)rDz%JMAPCalendar._async_get_object_by_uids8\44SdgVZ4[[[[[[[[[r+ical_strcz|jr||S|j|j|S)uAdd an event to this calendar from an iCalendar string. Mirrors :meth:`caldav.collection.Calendar.add_event`. When called on an async-backed calendar, returns a coroutine that must be awaited. Args: ical_str: A VCALENDAR string representing the event. Returns: The server-assigned JMAP event ID. Unlike the CalDAV equivalent, this returns a string ID rather than a calendar object — the ``CalendarEvent/set`` response does not include the full object, so a follow-up GET would be required. Raises: JMAPMethodError: If the server rejects the create request. )r_async_add_eventr create_eventrr-rIs r) add_eventzJMAPCalendar.add_events<$ > 3((22 2|(((;;;r+cRK|j|j|d{VSN)rrLrrMs r)rKzJMAPCalendar._async_add_events2\..twAAAAAAAAAr+)r rr!r )r!r)r!r?rP)rAr )rAr r!r)rIr r!r )__name__ __module__ __qualname____doc____annotations__rrrrrrrrrr classmethodr*r/r>r8rGrDrNrKr7r+r)r r s   GGG III"K""""EMeD111I1111JJ4955ue444GeEE5QQQIQQQQ   [ "&# # # J     VVVVV0\\\\<<<<,BBBBBBr+r N)rT __future__r dataclassesrrrtypingr#caldav.jmap.objects.calendar_objectrcaldav.jmap.async_clientr caldav.jmap.clientr r r7r+r)r]s#"""""(((((((( BBBBBB.888888------ hBhBhBhBhBhBhB hBhBhBr+