o .j(@svdZddlmZddlmZmZddlmZddlmZddl m Z er0ddl m Z ddl mZeGd d 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) JMAPClientc@seZdZUdZded<ded<dZded<dZded<d Zd ed <ee d Z d ed<dZ ded<d Z d ed<edddddZ ded<edddddZd ed<ed.ddZd/ddZddZd0d!d"Zd1d2d$d%Zd3d'd(Zd4d*d+Zd4d,d-ZdS)5 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 CsL||d|d|d|d|dd|di|dd |d dd 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. r r rr isSubscribedTmyRights sortOrderr isVisible)r r rrrrrr)get)clsrr&Q/home/thesage/.local/lib/python3.10/site-packages/caldav/jmap/objects/calendar.py from_jmap3s    zJMAPCalendar.from_jmapcCsB|j|j|j|jd}|jdur|j|d<|jdur|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. )r r r"r#Nrr)r rrrrr)selfdr&r&r'to_jmapEs    zJMAPCalendar.to_jmapcKsl|jr |jdi|S|d}|d}t|tr|}t|tr'|}|jj|j|||d|dS)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_idr,r-r.parentNr&) r _async_searchr$ isinstancer isoformatr_searchr r) searchargsr,r-r&r&r'searchXs    zJMAPCalendar.searchlist[JMAPCalendarObject]cs^|d}|d}t|tr|}t|tr|}|jj|j|||d|dIdHS)Nr,r-r.r/)r$r3rr4rr5r r6r&r&r'r2}s     zJMAPCalendar._async_searchuidcCs$|jr||S|jj||j|dS)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. r0r1)r_async_get_object_by_uidr_get_object_by_uidr )r)r: comp_classr&r&r'get_object_by_uids zJMAPCalendar.get_object_by_uidrcs|jj||j|dIdHS)Nr;)rr=r )r)r:r&r&r'r<sz%JMAPCalendar._async_get_object_by_uidical_strcCs |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_eventr r)r@r&r&r' add_events zJMAPCalendar.add_eventcs|j|j|IdHSN)rrBr rCr&r&r'rAszJMAPCalendar._async_add_event)rrrr )rr)rr9rE)r:r )r:r rr)r@r rr )__name__ __module__ __qualname____doc____annotations__rrrrrrrrrr classmethodr(r+r8r2r?r<rDrAr&r&r&r'r s.          %   r N)rI __future__r dataclassesrrrtypingr#caldav.jmap.objects.calendar_objectrcaldav.jmap.async_clientrcaldav.jmap.clientr r r&r&r&r's