o .j@szdZddlZddlZddlZddlmZddlmZddlmZm Z ddl m Z ddl m Z mZmZmZddlmZmZmZmZmZmZddlZe r\dd lmZd d lmZd d lmZdd lmZm Z m!Z!m"Z"ddl m#Z#d dl$m%Z%d dl&m'Z'm(Z(m)Z)m*Z*m+Z+d dl,m-Z-d dl.m/Z/m0Z0d dl1m2Z2m3Z3d dl4m5Z5d dl6m7Z7edddZ8e9dZ:eGdddZ;ded"e?eeZdZUdZeed<edBed<edBed<eeed<dS) CalendarInfoz7Data for a calendar extracted from a PROPFIND response.urlNcal_idnameresource_types)__name__ __module__ __qualname____doc__str__annotations__listr7r7F/home/thesage/.local/lib/python3.10/site-packages/caldav/collection.pyr+;s   r+r,returncCs\zt|dd}|r|d}|r|WSWdSWdSty-td|YdSw)N/zCalendar has unexpected url )r4rstripsplit Exceptionlogr$)r,partsr-r7r7r8_extract_calendar_id_from_urlEs rAcCs*t|}tt|jdd}t|j|dS)zKQuote the path component of a URL to handle unencoded spaces (e.g. Zimbra).z/@safe)path)rr rrDr_replace)r,parsed quoted_pathr7r7r8_quote_url_pathQsrH propertiescCs,|dg}t|ts|r|gng}d|vS)N{DAV:}resourcetypez'{urn:ietf:params:xml:ns:caldav}calendar)get isinstancer6)rIrtr7r7r8_is_calendar_resourceXs  rNresultsc Csfg}|pgD]*}t|jsqt|j}|jd}t|}|s q|t||||jdgdq|S)zCExtract CalendarInfo objects from a list of PropfindResult objects.{DAV:}displaynamerJ)r,r-r.r/)rNrIrHhrefrKrAappendr+)rO calendarsresultr,r.r-r7r7r8(_extract_calendars_from_propfind_results_s$     rUcCs0|durdSd|vrd|vrd|vrt|S|S)z6Quote @ in owncloud-style URLs that are not full URLs.N@://z%40)r r,r7r7r8_sanitize_calendar_home_set_urlus rYcCs.|pgD]}|jd}|rt|SqdS)zDExtract calendar-home-set URL from a list of PropfindResult objects.z0{urn:ietf:params:xml:ns:caldav}calendar-home-setN)rIrKrY)rOrThome_setr7r7r8'_extract_calendar_home_set_from_results~s   r[c @seZdZdZdedfddZdddZdedfd d Zdd d Z dde d Bde d Bde d Bde d Bddf ddZ dde d Bde d Bde d Bde d Bddf ddZ dde d Bde d BddfddZ d S) CalendarSetz. A CalendarSet is a set of calendars. r9Calendarcst|}fdd|DS)z2Convert PropfindResult list into Calendar objects.c s&g|]}tj|j|j|jdqS))clientr,r.idparent)r]r^r,r.r-).0infoselfr7r8 sz7CalendarSet._calendars_from_results..)rU)rdrOcalendar_infosr7rcr8_calendars_from_resultss z#CalendarSet._calendars_from_results4list[Calendar] | Coroutine[Any, Any, list[Calendar]]cCs6|jr|S|jjt|j|jjdd}||jS)a List all calendar collections in this set. For sync clients, returns a list of Calendar objects directly. For async clients, returns a coroutine that must be awaited. Returns: * [Calendar(), ...] Example (sync): calendars = calendar_set.get_calendars() Example (async): calendars = await calendar_set.get_calendars() rpropsdepth) is_async_client_async_get_calendarsr^propfindr4r,CALENDAR_LIST_PROPSrgrOrdresponser7r7r8 get_calendarss  zCalendarSet.get_calendarscs0|jjt|j|jjddIdH}||jS)z(Async implementation of get_calendars().rriN)r^rnr4r,rorgrOrpr7r7r8rms  z CalendarSet._async_get_calendarscC|Sz Deprecated: Use :meth:`get_calendars` instead. This method is an alias kept for backwards compatibility. rrrcr7r7r8rSzCalendarSet.calendarsNr.r- supported_calendar_component_setmethod(Calendar | Coroutine[Any, Any, Calendar]cCs2|jr |||||St|j||||dj|dS)ax Utility method for creating a new calendar. Args: name: the display name of the new calendar cal_id: the uuid of the new calendar supported_calendar_component_set: what kind of objects (EVENT, VTODO, VFREEBUSY, VJOURNAL) the calendar should handle. Should be set to ['VTODO'] when creating a task list in Zimbra - in most other cases the default will be OK. method: 'mkcalendar' or 'mkcol' - usually auto-detected For async clients, returns a coroutine that must be awaited. Returns: Calendar(...)-object r.r`r_rwrx)rl_async_make_calendarr]r^saverdr.r-rwrxr7r7r8 make_calendarszCalendarSet.make_calendarcs(t|j||||d}|j|dIdHS)&Async implementation of make_calendar.rzr{N)r]r^r})rdr.r-rwrxcalendarr7r7r8r|sz CalendarSet._async_make_calendarcCs\|r|s|D]}|}||kr|Sq|r'|s'td|d|j|s:|s:|}|s6td|dS|jdurCtd|durKtdtt |  t|jj re|jj |}n?t |tsyt |tr| dsy| d r|jdurtd |j |}n|jdurtd |durtd|j t|d }t|j||||d S) ac The calendar method will return a calendar object. If it gets a cal_id but no name, it will not initiate any communication with the server Args: name: return the calendar with this display name cal_id: return the calendar with this calendar id or URL Returns: Calendar(...)-object zNo calendar with name z found under zno calendars foundrN%Unexpected value None for self.clientz Unexpected value None for cal_idhttps://http://"Unexpected value None for self.urlr:)r.r`r,r_)rrget_display_namer$ NotFoundErrorr,r^ ValueErrorr4r' objectify canonical startswithjoinrLr r])rdr.r-r display_namecalsr,r7r7r8rsF   $   zCalendarSet.calendarr9rhNNNNNN)r0r1r2r3r6rgrrrmrSr4rrr|rr7r7r7r8r\sJ    % $r\c seZdZdZ   d@deddeeBeBeBdBdedBde ddf fd d Z e  dAdddeeBeBeBdBdedBddfd d Z    dBd edBdedBde dBddfddZ    dBd edBdedBde dBddfddZdCddZ   d@d edBdedBdedBddfddZdDddZdEd d!Zed"d#ZejdFd$d#ZdGd&d'ZdGd(d)Z  *dHd+d,Zdefd-d.Z  /dId0d1ZdeedBfd2d3ZdJd5d6ZdKd8d9ZdLd;d<Z dMd>d?Z!Z"S)N Principala! This class represents a DAV Principal. It doesn't do much, except keep track of the URLs for the calendar-home-set, etc. A principal MUST have a non-empty DAV:displayname property (defined in Section 13.2 of [RFC2518]), and a DAV:resourcetype property (defined in Section 13.9 of [RFC2518]). Additionally, a principal MUST report the DAV:principal XML element in the value of the DAV:resourcetype property. (TODO: the resourcetype is actually never checked, and the DisplayName is not stored anywhere) Nr^rr,calendar_home_setkwargsr9c s||_tjd||d||durL|jdurtd|jj|_|t}|dur?t dt dt d|jj|jj t ||_dSdS)a Returns a Principal. End-users usually shouldn't need to construct Principal-objects directly. Use davclient.principal() to get the principal object of the logged-in user and davclient.principals() to get other principals. Args: client: a DAVClient() object url: The URL, if known. calendar_home_set: the calendar home set, if known If url is not given, deduct principal path as well as calendar home set path from doing propfinds. r^r,Nr"calendar server lacking a feature:)current-user-principal property not foundz assuming %s is the principal URLr7)_calendar_home_setsuper__init__r^rr, get_propertyr#CurrentUserPrincipalr?warningrr'r)rdr^r,rrcup __class__r7r8r4s    zPrincipal.__init__cs~|||p|j|d}|dur=|tIdH}|dur3tdtdtd|jd|S|jt||_|S)ap Create a Principal, discovering URL if not provided. This is the recommended way to create a Principal with async clients as it handles async URL discovery. For sync clients, you can use the regular constructor: Principal(client) Args: client: A DAVClient or AsyncDAVClient instance url: The principal URL (if known) calendar_home_set: The calendar home set URL (if known) Returns: Principal with URL discovered if not provided Example (async): principal = await Principal.create(async_client) )r^r,rNrrz assuming z is the principal URL) r,rr#rr?rrr'r)clsr^r,r principalrr7r7r8createYs  zPrincipal.creater.r-rwrycCs*|jr |||||S|jj||||dS)z Convenience method, bypasses the self.calendar_home_set object. See CalendarSet.make_calendar for details. For async clients, returns a coroutine that must be awaited. rwrx)rlr|rrr~r7r7r8rs zPrincipal.make_calendarr]cs(|IdH}|j||||dIdHS)rNr)_async_get_calendar_home_setr)rdr.r-rwrxrr7r7r8r|s zPrincipal._async_make_calendarr\csN|jr|jS|tIdH}|dur!d|vr!d|vr!t|}||_|jS)z*Async helper to get the calendar home set.NrVrWrrr"CalendarHomeSetr rrdcalendar_home_set_urlr7r7r8rsz&Principal._async_get_calendar_home_setcal_urlcCs|s2|r+t|tst|tr+|ds|dr+|jdur!tdt|jt|dS|j ||S|jdur;tdt|j|jj |dS)z The calendar method will return a calendar object. It will not initiate any communication with the server. rrNrrX) rLr'r4rr^rr]rrrr,r)rdr.r-rr7r7r8rs"   zPrincipal.calendar.vCalAddress | Coroutine[Any, Any, vCalAddress]cCsh|jr|Sddlm}m}|}|}|t }||d}|||j d<|||j d<|S)z Returns the principal, as an icalendar.vCalAddress object. For async clients, returns a coroutine that must be awaited. rrvTextcncutype) rl_async_get_vcal_address icalendarrrrcalendar_user_address_setrr"CalendarUserTypeparams)rdrrridsrretr7r7r8get_vcal_addresss zPrincipal.get_vcal_addressrcsddlm}m}|}t|ts|IdH}|jtddIdH}|dur,t ddd|Dr5Jt t |d d d }|t IdH}||dj}|||jd <|||jd <|S)zDAsync counterpart of get_vcal_address() for use with AsyncDAVClient.rrNF parse_props,No calendar user addresses given from servercS g|] }|jtjkr|qSr7tagr#Hrefraxr7r7r8re z5Principal._async_get_vcal_address..cSt|dd SN preferredrintrKrr7r7r8z3Principal._async_get_vcal_address..keyrr)rrrrrLr4rr"CalendarUserAddressSetr$rsortedr6rtextr)rdrrr addresses_el addressesrrr7r7r8rs   z!Principal._async_get_vcal_addresscCs@|js|t}|durd|vrd|vrt|}||_|jS)NrVrWrrr7r7r8rszPrincipal.calendar_home_setcCs`t|tr ||_dSt|}|dur"|jr"|j|jjjkr"||j_t|j|jj||_dSN) rLr\rr'rhostnamer^r,r)rdr, sanitized_urlr7r7r8rs   rhcCs |j|S)a] Return the principal's calendars. For sync clients, returns a list of Calendar objects directly. For async clients, returns a coroutine that must be awaited. Example (sync): calendars = principal.get_calendars() Example (async): calendars = await principal.get_calendars() )r^rrrcr7r7r8rr's zPrincipal.get_calendarscCrsrtrurcr7r7r8rS7rvzPrincipal.calendars/dict[str, FreeBusy] | Coroutine[Any, Any, dict]c Cst}|dd|dd|ddt}t}|d||dt|d ||d |||| }t||d }|D] } |j | d d qI|j r\| ||S| |jj|j|jtd} | j|dS)zSends a freebusy-request for some attendee to the server as per RFC6638. For async clients, returns a coroutine that must be awaited. prodidz-//tobixen/python-caldav//ENversionz2.0rxREQUESTuiddtstampdtstartdtenddatar`T)no_default_parameters)headersr`)rr]adduuiduuid4rrnow add_componentschedule_outbox add_attendeerl_async_freebusy_request add_organizerr^postr,rr"_parse_scheduling_response_objects) rdrr attendees freebusy_icalr freebusy_compoutbox caldavobjattendeerqr7r7r8freebusy_requestDs(          zPrincipal.freebusy_requestcsDt}|IdH}|IdH|j|j|j|IdH}|j|dS)z=Async implementation of freebusy_request() for async clients.Nr)rrr^rr,rr)rdrfb_objrrqr7r7r8rds   z!Principal._async_freebusy_request8list[str | None] | Coroutine[Any, Any, list[str | None]]cCsj|jr|S|jtdd}|durtddd|Dr"Jt|}|jddd d d|DS) z$ defined in RFC6638 FrNrcSrr7rrr7r7r8rerz7Principal.calendar_user_address_set..cSrrrrr7r7r8rrz5Principal.calendar_user_address_set..rcSg|]}|jqSr7rrr7r7r8rer) rl _async_calendar_user_address_setrr"rr$rr6sortrd _addressesrr7r7r8rqs z#Principal.calendar_user_address_setcsd|jtddIdH}|durtddd|DrJt|}|jdddd d|DS) NFrrcSrr7rrr7r7r8rerz>Principal._async_calendar_user_address_set..cSrrrrr7r7r8rrz.rcSrr7rrr7r7r8rer)rr"rr$rr6rrr7r7r8rs z*Principal._async_calendar_user_address_set2ScheduleInbox | Coroutine[Any, Any, ScheduleInbox]cC|jr|St|dS)z Returns the schedule inbox, as defined in RFC6638. For async clients, returns a coroutine that must be awaited. r)rl_async_schedule_inbox ScheduleInboxrcr7r7r8schedule_inbox zPrincipal.schedule_inbox4ScheduleOutbox | Coroutine[Any, Any, ScheduleOutbox]cCr)z Returns the schedule outbox, as defined in RFC6638. For async clients, returns a coroutine that must be awaited. r)rl_async_schedule_outboxScheduleOutboxrcr7r7r8rrzPrincipal.schedule_outboxrc$|tIdH}t|j|dSNr)rr"ScheduleInboxURLrr^rdr,r7r7r8rzPrincipal._async_schedule_inboxrcrr)rr"ScheduleOutboxURLrr^rr7r7r8rr z Principal._async_schedule_outboxNNNrr)r9r\)r9r)r9rr9Nr)r9r)r9r)r9r)r9r)r9r)r9r)#r0r1r2r3r r4r r r'rr classmethodrrr|rrrrpropertyrsetterrrrSrdictrrr6rrrrr __classcell__r7r7rr8r%s% .              rcseZdZdZ      ddeddeeBeBeBdBdeddedBd edBd df fd d Z d dddZ dddZ dfdd Z dddZ deded eefddZ d dddZdd eefddZd ed d!fd"d#Zd efd$d%Zd&d'Z  ( (dd)eed edBd*ed+ed d!f d,d-Zdd.d/Zdd1d2Zdd4d5Zdd7d8Z !dd9d:Zdd;d<Zdd=d>Z dd?d@Z!dddBdCZ"ddDdEZ#ddFe$edGed e$efdHdIZ%dJe$e&eefd ee'fdKdLZ(ddFe$edGed e$e'fdMdNZ) (ddFe$edGed ee&eeffdOdPZ* (ddFe$edGed ee'fdQdRZ+dSdTZ,  U V (ddWe-dXe-dBdYddZee.dVBd[ed e/d\f d]d^Z0d_d`Z1 (d addbdcZ2dddeZ3dfe4dged dfdhdiZ5ddkdlZ6  (  (    ddmednedoedgedpee7j8dBd dqf drdsZ9dWe-dXe-d dtfdudvZ:ddxdyZ; z ( dd{e/ed|ed}edBd d~fddZddedBd dfddZ?  ddede7j@dBded\d d!fddZA  ddede7j@dBded\d dfddZBded d!fddZCded d!fddZDded d!fddZE !dddZFded d!fddZGded d!fddZHded d!fddZIeGZJdddZKdddZLded\d efddZM  ( (ddedBdeded dfddZN dddZOeOZPeNZQ  ( (ddedBdeded dfddZRdddZSdddZTZUS)r]z The `Calendar` object is used to represent a calendar collection. Refer to the RFC for details: :rfc:`4791#section-5.3.1`. Nr^rr,r`r!r.r_r9c s$tjd||||||d|dS)a Initialize a Calendar object. Args: client: A DAVClient instance url: The url for this calendar. May be a full URL or a relative URL. parent: The parent object (typically a CalendarSet or Principal) name: The display name for the calendar (stored in props cache) id: The calendar id (used when creating new calendars) props: A dict with known properties for this calendar )r^r,r`r_rjr.Nr7)rr)rdr^r,r`r.r_rjextrarr7r8rs   zCalendar.__init__ None | Coroutine[Any, Any, None]c Cs|dur tt}||_|dur<|jr:|jjjdtd}|ddvr(t d|ddkr7|dd kr7d }nd }nd }|j j |d }||_ t }d}|j pX|jjd } |rg| rgt |}||g7}|r}t} |D] } | t| 7} qo|| 7}|d kr|t t tg7}t |} |d krt nt| } |jr||| |||S|j| ||dd|rz ||gWdStyz|}t||kWYdStyt j!dddYYdSwwdS)z Create a new calendar with display name `name` in `parent`. For async clients, returns a coroutine that must be awaited. Nzcreate-calendar return_typesupport)fullfragilequirkz>Creation of calendars (allegedly) not supported on this serverr behaviourzmkcol-requiredmkcol mkcalendarr:zcreate-calendar.set-displaynameroot query_methodr,expected_return_valueDcalendar server does not support display name on calendar? IgnoringTexc_info)"r4rrr_r^features is_supportedrr$MkcalendarErrorr`r,rr#Prop DisplayNamer"SupportedCalendarComponentSetComp ResourceType Collectionr]SetMkcol Mkcalendarrl _async_create_queryset_propertiesr>rassert_r?r)rdr.r_rwrx supportedrDproprsupports_displaynamesccssccsetrcurrent_display_namer7r7r8_createsf       zCalendar._createc s|j|||ddIdH|rKz ||gIdHWdStyJz|tIdH}t||kWYdStyItj dddYYdSwwdS)zAAsync implementation of _create (call via _create, not directly).rrNr"Tr#) r2r3r>rr#r)r$r4r?r)rdrDrrxr.rr;r7r7r8r1s"  zCalendar._async_createc s$|jr |j|dS|dur8zt|}Wn tjy YdSw|D]}z|Wq#tjy5Yq#wdS|jj dt }|durL|jj d }|ddkrt ddD]+}zt Wn tj yjYnwz |td WqWtjyd }Ynw|r|jddSt dS) uODelete the calendar. For async clients, returns a coroutine that must be awaited. wipe: tristate controlling cleanup behaviour None (default) – wipe all objects instead of deleting if the server doesn't support calendar deletion True – wipe all objects and return without deleting the calendar itself (useful for servers where deletion moves calendars to a trashbin) False – always attempt to delete the calendar via HTTP DELETE wipeTNdelete-calendarrrr333333?F)rl _async_deleter6searchr$rdeleter^r%r&rranger DeleteError get_eventsr)rdr>objectsobj quirk_info_rr7r8rD-sF     zCalendar.deletec sLddl}|dur8z |IdH}Wn tjyYdSw|D]}z |IdHWq tjy5Yq wdS|jjdt}|durL|jjd }|ddkrt ddD]7}z t |IdHWn tj ymYnwz|jddIdH| d IdHWqWtjyd }Ynw|r|j dd IdHdSt |IdHdS) z*Async implementation of Calendar.delete().rNTr?rrr@)eventrAFr=)asynciorCr$rrDr^r%r&rrEr!rBrFr)rdr>rMrHrIrJrKr7r7r8rBasF zCalendar._async_deleterq with_fallbackcCs|jpgD]}|jtj}|r|Sq|stddg}|jr0|jj dr0| d|jr?|jj dr?| d|S)zExtract supported component types from a propfind DAVResponse. Both the sync and async paths produce a DAVResponse via propfind, which always populates response.results via the protocol layer. z.supported-calendar-component-set not supportedVEVENTzsave-load.todoVTODOzsave-load.journalVJOURNAL) rOrIrKr"r*rr$ PropfindErrorr^r%r&rR)rdrqrNrT components rfc_defaultr7r7r8#_supported_components_from_responses   z,Calendar._supported_components_from_responseT*list[Any] | Coroutine[Any, Any, list[Any]]cCsF|jdur td|jr||Stg}|j|dd}|||S)a returns a list of component types supported by the calendar, in string format (typically ['VJOURNAL', 'VTODO', 'VEVENT']) RFC 4791 section 5.2.3: supported-calendar-component-set is optional. When absent, the server MUST accept all component types, so we return the RFC default list (trimmed by known server limitations from compatibility hints) rather than raising or returning empty. See https://github.com/python-caldav/caldav/issues/653 NrFparse_response_xml)r,rrl_async_get_supported_componentsr"r*get_propertiesrUrdrNrjrqr7r7r8get_supported_componentss    z!Calendar.get_supported_componentscs,tg}|j|ddIdH}|||S)NFrW)r"r*rZrUr[r7r7r8rYs  z(Calendar._async_get_supported_componentsicalDCalendarObjectResource | Coroutine[Any, Any, CalendarObjectResource]cKsz|jr |j||fi|S||||jd}||_||D] }|j|fi|q |jddd|_ | |S)a sends a schedule request to the server. Equivalent with add_event, add_todo, etc, but the attendees will be added to the ical object before sending it to the server. For async clients, returns a coroutine that must be awaited. rr^veventrr) rl_async_save_with_invites_calendar_comp_class_by_datar^r`rricalendar_instancewalkr_r}rdr]rattendeeoptionsrIrr7r7r8save_with_invitess zCalendar.save_with_invitescs||||jd}||_|IdH|D]}t|tr%|IdH}|j|fi|q|j ddd|_ | IdH|S)z>Async implementation of save_with_invites() for async clients.r_Nr`rr) rbr^r`rrLrrrrcrdr_r}rer7r7r8ras z!Calendar._async_save_with_invitescKsP|st|ts t|tr&dt|vr&|rd|vr||d<tjdd|i|S|S)NsBEGIN:VCALENDAR ical_fragmentobjtyper7)rLr4bytesr&r% create_ical)rdr]ri ical_datar7r7r8_use_or_create_icss  zCalendar._use_or_create_icsFobjclass no_overwrite no_createcKsn||j|j|fdd|ji||d}|jr"|j|||dS|j||dd}|jdur5|jdd|S) aGAdd a new calendar object (event, todo, journal) to the calendar. This method is for adding new content to the calendar. To update an existing object, fetch it first and use ``object.save()``. Args: objclass: Event, Journal or Todo ical: ical object (text, icalendar or vobject instance) no_overwrite: existing calendar objects should not be overwritten no_create: don't create a new object, existing calendar objects should be updated dtstart: properties to be inserted into the icalendar object dtend: properties to be inserted into the icalendar object summary: properties to be inserted into the icalendar object alarm_trigger: when given, one alarm will be added alarm_action: when given, one alarm will be added alarm_attach: when given, one alarm will be added Note that the list of parameters going into the icalendar object and alarms is not complete. Refer to the RFC or the icalendar library for a full list of properties. riVr)rorpNrorponly_this_recurrenceTfix) r^rmr0upperrl_async_add_object_finishr}r,_handle_reverse_relations)rdrnr]rorprlor7r7r8 add_objects"   zCalendar.add_objectcs8|j||ddIdH}|jdur|jddIdH|S)zLAsync helper for add_object(): awaits save() then handles reverse relations.NrrTrt)r}r,rx)rdryrorpr7r7r8rws  z!Calendar._async_add_object_finish"Event | Coroutine[Any, Any, Event]cO|jtg|Ri|S)zy Add an event to the calendar. Returns ``self.add_object(Event, ...)`` - see :meth:`add_object` )rzrrdlargsrr7r7r8 add_eventzCalendar.add_event Todo | Coroutine[Any, Any, Todo]cOr|)z{ Add a todo/task to the calendar. Returns ``self.add_object(Todo, ...)`` - see :meth:`add_object` )rzr r}r7r7r8add_todo#rzCalendar.add_todo&Journal | Coroutine[Any, Any, Journal]cOr|)z Add a journal entry to the calendar. Returns ``self.add_object(Journal, ...)`` - see :meth:`add_object` )rzrr}r7r7r8 add_journal+rzCalendar.add_journalcO|j|i|S)z Deprecated: Use :meth:`add_object` instead. This method is an alias kept for backwards compatibility. See https://github.com/python-caldav/caldav/issues/71 )rzr}r7r7r8 save_object6s zCalendar.save_objectcOr)z Deprecated: Use :meth:`add_event` instead. This method is an alias kept for backwards compatibility. See https://github.com/python-caldav/caldav/issues/71 )rr}r7r7r8 save_eventAzCalendar.save_eventcOr)z Deprecated: Use :meth:`add_todo` instead. This method is an alias kept for backwards compatibility. See https://github.com/python-caldav/caldav/issues/71 )rr}r7r7r8 save_todoJrzCalendar.save_todocOr)z Deprecated: Use :meth:`add_journal` instead. This method is an alias kept for backwards compatibility. See https://github.com/python-caldav/caldav/issues/71 )rr}r7r7r8 save_journalSrzCalendar.save_journalrycCsH|jdur"|jd}|jr|||S|jd|j||d|j|S)z The save method for a calendar is only used to create it, for now. We know we have to create it when we don't have a url. For async clients, returns a coroutine that must be awaited. Returns: * self NrP)r_r.rxr7)r,rjrKrl _async_saver<r_extra_init_options)rdrxrr7r7r8r}\s  z Calendar.savecs(|jd||j|d|jIdH|S)zAsync implementation of save.)r.r_rxNr7)r<r_r)rdrrxr7r7r8ros"zCalendar._async_save event_urlsraise_notfoundc cs|jdur tdtt}t|dd|D}||dd}|tg}|rL|j D]}|j |}|rKd|vrKt d|d|q3|D] } | || tjj fVqNdS) u get multiple events' data. TODO: Does it overlap the _request_report_build_resultlist method ## WARNING: async logic is duplicated in _async_multiget — mirror any changes there NrcSg|] }tj|jdqS)valuer#rrDraur7r7r8rez&Calendar._multiget..report404Status  in ) r,rr#r(r" CalendarDataCalendarMultiGetr2expand_simple_propsstatusesr$rr) rdrrr6rrqrOrQstatusrr7r7r8 _multigetvs     zCalendar._multigetrOcsfdd|DS)z?Post-processing shared by multiget and _async_multiget_objects.c s@g|]\}}|jjttt|dd|dqS)z/:@rBr,rr`)rbr^r,rr rr4)rar,rrcr7r8resz+Calendar._post_multiget..r7)rdrOr7rcr8_post_multigets zCalendar._post_multigetcCs(|jr |j||dS||j||dS)z get multiple events' data TODO: Does it overlap the _request_report_build_resultlist method? @author mtorange@gmail.com (refactored by Tobias) r)rl_async_multiget_objectsrrrdrrr7r7r8multigetszCalendar.multigetcs|jdur tdtt}t|dd|D}||ddIdH}|tg|rO|j D]}|j |}|rNd|vrNt d|d|q6fddDS) NrcSrrrrr7r7r8rerz,Calendar._async_multiget..rrrrcs g|] }||tjjfqSr7)r"rr)rarrOr7r8rer) r,rr#r(r"rrr2rrr$r)rdrrr6rrqrQrr7rr8_async_multigets    zCalendar._async_multigetcs||j||dIdHS)zAsync version of multiget.rN)rrrr7r7r8rsz Calendar._async_multiget_objectscOst|j|i|S)z get multiple events' data @author mtorange@gmail.com (refactored by Tobias) This is for backward compatibility. It may be removed in a later release. )r6rr}r7r7r8calendar_multigetszCalendar.calendar_multigetrOmaybestartend compfilterexpand verify_expandrcCsntjdtdd|rtd|dkr|duo|du}|dkr"t}n |dkr)t}nd}|j||||d d }|S) a .. deprecated:: 3.0 Use :meth:`search` instead. This method will be removed in 4.0. Search events by date in the calendar. Args: start: Start of the date range to search. end: End of the date range (optional for open-ended search). compfilter: Component type to search for. Defaults to "VEVENT". Set to None to fetch all calendar components. expand: Should recurrent events be expanded? Default "maybe" becomes True unless the search is open-ended. verify_expand: Not in use anymore, kept for backward compatibility. Returns: List of CalendarObjectResource objects matching the search. Example (migrate to search):: # Legacy (deprecated): events = calendar.date_search(start, end, expand=True) # Recommended: events = calendar.search(start=start, end=end, event=True, expand=True) z7use `calendar.search rather than `calendar.date_search`) stacklevelz`verify_expand in date_search does not work anymore, as we're doing client side expansion insteadrNrOrPF)rr comp_classrsplit_expanded)warningswarnDeprecationWarningloggingrrr rC)rdrrrrrrrHr7r7r8 date_searchs0$zCalendar.date_searchc Csg}||}|D]O}||}tjj|vr(|tjj}|dur%||n|} nd}| dur0t} t|} | jdur=t |} |j | |j krGq | | |j |j | |||dq ||fS)z Get one calendar object from the calendar by UID. Args: uid: the object uid comp_class: filter by component type (Event, Todo, Journal) comp_filter: for backward compatibility. Don't use! Returns: CalendarObjectResource (Event, Todo, or Journal) Tinsistrrrrrrcg|] }|jkr|qSr7r_raryrr7r8rerz.Calendar.get_object_by_uid..%s not found on serverrr)rl_async_get_object_by_uidrCr$rr4rrdrrr items_foundr7rr8get_object_by_uidjs zCalendar.get_object_by_uidcs\|j||ddddIdH}fdd|D}|s!tdtt|dk|d S) z%Async helper for get_object_by_uid().TrrNcrr7rrrr7r8rerz5Calendar._async_get_object_by_uid..rrr)rCr$rr4rr r7rr8rs z!Calendar._async_get_object_by_uidcC|j|tdS)z Get a task/todo from the calendar by UID. Returns the task with the given uid. See :meth:`get_object_by_uid` for more details. r)r r rdrr7r7r8get_todo_by_uid zCalendar.get_todo_by_uidcCr )z Get an event from the calendar by UID. Returns the event with the given uid. See :meth:`get_object_by_uid` for more details. r )r rrr7r7r8get_event_by_uidrzCalendar.get_event_by_uidcCr )z Get a journal entry from the calendar by UID. Returns the journal with the given uid. See :meth:`get_object_by_uid` for more details. r )r rrr7r7r8get_journal_by_uidrzCalendar.get_journal_by_uidcOr)z Deprecated: Use :meth:`get_object_by_uid` instead. This method is an alias kept for backwards compatibility. )r r}r7r7r8 object_by_uidzCalendar.object_by_uidcC ||S)z Deprecated: Use :meth:`get_event_by_uid` instead. This method is an alias kept for backwards compatibility. )rrr7r7r8 event_by_uid zCalendar.event_by_uidcCr)z Deprecated: Use :meth:`get_todo_by_uid` instead. This method is an alias kept for backwards compatibility. )rrr7r7r8 todo_by_uidrzCalendar.todo_by_uidcCr)z Deprecated: Use :meth:`get_journal_by_uid` instead. This method is an alias kept for backwards compatibility. )rrr7r7r8journal_by_uidrzCalendar.journal_by_uid.list[Event] | Coroutine[Any, Any, list[Event]]cC |jtdS)ay List all events from the calendar. For sync clients, returns a list of Event objects directly. For async clients, returns a coroutine that must be awaited. Returns: * [Event(), ...] Example (sync): events = calendar.get_events() Example (async): events = await calendar.get_events() r )rCrrcr7r7r8rGs zCalendar.get_eventscCrs)z Deprecated: Use :meth:`get_events` instead. This method is an alias kept for backwards compatibility. )rGrcr7r7r8events rvzCalendar.eventsrHcCsddl}g}|D]*}t|dr#tjj|jvr#|t|jtjjqt|dr2|t|j q| d |}|j | dd}d|S) a  Generate a fake sync token for servers without sync support. Uses a hash of all ETags to detect changes. Args: objects: List of calendar objects to generate token from Returns: A fake sync token string rNrjr,|F)usedforsecurityfake-)hashlibrr#GetEtagrrjrRr4r,rrrmd5encode hexdigest)rdrHr etagsrIcombined hash_valuer7r7r8_generate_fake_sync_tokens    z"Calendar._generate_fake_sync_token sync_token load_objectsdisable_fallbackdSynchronizableCalendarObjectCollection | Coroutine[Any, Any, SynchronizableCalendarObjectCollection]c Cs|jr ||||Sd}|jjjdtd}|ddkr%|r#tdd}|r3t |t r3| dr3d}|rz6|jj |d gd }|j |tgdd \}}|rc|D]} z| WqPtjybYqPwt|||jd WStjtjfy} z|rztd | dWYd} ~ nd} ~ wwtdt|} |r| D]} t| dr| jdurz| WqtjyYqwq| rFt| ddrtjj| djvrFz[|jtgdd}|tg} dd| D} tdt | d| !D]0\}}t |j"#|$}|| vr(t| |dsi| |_| |j%|td|qWnt&yE} ztd| WYd} ~ nd} ~ ww|'| }|rft |t rf| drf||krft|g|d St|| |d S)aEget_objects_by_sync_token aka get_objects For async clients, returns a coroutine that must be awaited. Do a sync-collection report, ref RFC 6578 and https://github.com/python-caldav/caldav/issues/87 This method will return all objects in the calendar if no sync_token is passed (the method should then be referred to as "objects"), or if the sync_token is unknown to the server. If a sync-token known by the server is passed, it will return objects that are added, deleted or modified since last time the sync-token was set. If load_objects is set to True, the objects will be loaded - otherwise empty CalendarObjectResource objects will be returned. This method will return a SynchronizableCalendarObjectCollection object, which is an iterable. This method transparently falls back to retrieving all objects if the server doesn't support sync tokens. The fallback behavior is identical from the user's perspective, but less efficient as it transfers the entire calendar on each sync. If disable_fallback is set to True, the method will raise an exception instead of falling back to retrieving all objects. This is useful for testing whether the server truly supports sync tokens. T sync-tokenrr unsupported+Sync tokens are not supported by the serverFrgetetagr)rjrjrrrHr)Sync-collection REPORT failed (!), falling back to full retrievalN6Using fallback sync mechanism (retrieving all objects)_datarrjrrkcSi|] }t|j|qSr7r4r,rrarIr7r7r8 z6Calendar.get_objects_by_sync_token..Fallback: Fetching ETags for  objectsFallback: Added ETag to )Failed to fetch ETags for fallback sync: )(rl _async_get_objects_by_sync_tokenr^r%r&rrKr$ ReportErrorrLr4r_build_sync_collection_bodyrr#r!rr&SynchronizableCalendarObjectCollectionr)DAVErrorr?rbdebugr6rCrr7rrj_query_propertiesrritemsr,rrupdater>r(rdr)r*r+use_sync_token sync_supportrrqrHrIe all_objects etag_props url_to_objurl_strrjcanonical_url_strfake_sync_tokenr7r7r8get_objects_by_sync_token-s"            z"Calendar.get_objects_by_sync_tokencOr)z Deprecated: Use :meth:`get_objects_by_sync_token` instead. This method is an alias kept for backwards compatibility. )rUr}r7r7r8objects_by_sync_tokenrzCalendar.objects_by_sync_tokenrEc sd}|jjjdtd}|ddkr|rtdd}|r*t|tr*| dr*d}|rz<|jj |d gd }|j |t gdd Id H\}}|r`|D]} z | Id HWqJtjy_YqJwt|||jd WStjtjfy} z|rwtd| dWYd } ~ nd } ~ wwtdt|Id H} |r| D] } t| dr| jd urz | Id HWqtjyYqwq| rLt| ddrt j j| djvrLz^|jt gddId H}|t g} dd| D} tdt| d| D]0\}}t|j !|"}|| vr.t| |dsi| |_| |j#|td|qWnt$yK} ztd| WYd } ~ nd } ~ ww|%| }|rlt|trl| drl||krlt|g|d St|| |d S)z2Async implementation of get_objects_by_sync_token.Tr-rrr.r/Frr0r1r2Nr3r4r5r6r7rrjrr8cSr9r7r:r;r7r7r8r<r=z=Calendar._async_get_objects_by_sync_token..r>r?r@rA)&r^r%r&rrKr$rCrLr4rrDrr#r!rrrEr)rFr?rbrGr6rCrr7rrjrHrrrIr,rrrJr>r(rKr7r7r8rBs         z)Calendar._async_get_objects_by_sync_token2list[Journal] | Coroutine[Any, Any, list[Journal]]cCr)zd List all journals from the calendar. Returns: * [Journal(), ...] r )rCrrcr7r7r8 get_journalss zCalendar.get_journalscCrs)z Deprecated: Use :meth:`get_journals` instead. This method is an alias kept for backwards compatibility. )rXrcr7r7r8journals%rvzCalendar.journals)NNNNNNr)r9rr r)T)r9rV)NFF)FF)r9r{)r9r)r9r)r9r^)r9ry)F)NrOrF)NNF)r9r)r9r)NFTFNNNN)r9r)rFN)r9rr)r9r)r9r,)r9rW)Vr0r1r2r3r r4r r r'rr<r1rDrBrrr6rUr\rYrgrarmtyper!rzrwrrrrrrrr}rrrtupler(rrrrrrrrrrrrrrrr"rrCrrrrrbr CompFilterr rrrrrrrrrLrGrr(rUrVrH get_objectsrBrXrYrr7r7rr8r]s  P 4'    1      "       H#  #    $  -                    T r]c sdeZdZdZ   ddeddedBdeeBeBe BdBddffdd Z dd d Z d dZ Z S)ScheduleMailboxaw RFC6638 defines an inbox and an outbox for handling event scheduling. TODO: As ScheduleMailboxes works a bit like calendars, I've chosen to inheritate the Calendar class, but this is a bit incorrect, a ScheduleMailbox is a collection, but not really a calendar. We should create a common base class for ScheduleMailbox and Calendar eventually. Nr^rrr,r9c stj||dd|_|s|r|j|_|s$|r$|jdur td|jj}|dur<|dur0td|jt ||_dS|durDtd|jdurMtd|j|_z|jjt| | |_WdSt yt jdddt|jd|_td t| tjfdw) z9 Will locate the mbox if no url is given rNrz Unexpected value None for clientz#Unexpected value None for principalzsomething bad happenedTr#zprincipal has no %s. %s)rr_itemsr^rrr,rr'rrfindpropr>rr$r4check_scheduling_supportrr4 ERR_FRAGMENT)rdr^rr,rr7r8r9s:   $ zScheduleMailbox.__init__ list | Coroutine[Any, Any, list]csjrSfdd}js2z jdd_WjSty1tdj|_YjSwz jWjStyJ|_YjSw)u3Return all items currently in this scheduling mailbox (inbox or outbox). For async clients, returns a coroutine that must be awaited. Unlike regular calendars, schedule mailboxes contain raw iTIP messages (METHOD:REQUEST, METHOD:REPLY, METHOD:CANCEL, …) rather than permanent calendar objects. Items should be processed and then deleted; they are not meant to be kept indefinitely. Servers often do not support the sync-collection REPORT (RFC 6578) on schedule-inbox/outbox — the inbox is not a full calendar collection and may not be indexed the same way. We therefore attempt the sync-token path first (efficient for repeat polling) but fall back transparently to a plain PROPFIND depth-1 followed by individual GETs. Both paths return loaded CalendarObjectResource objects. Claude says that this method does NOT belong on the Calendar super-class. Calendar exposes type-specific accessors (get_events, get_todos, …) and uses search() internally. The mailbox is a different beast — it holds transient, mixed-type scheduling messages and must use children() as its fallback because search() / REPORT queries against a mailbox URL are unreliable across servers. cs,fddD}|D]}|q |S)Ncg|] }t|djdqSr)r,r^rr^rrcr7r8reszJScheduleMailbox.get_items.._load_from_children..childrenrrIrrcr7r8_load_from_childrens z6ScheduleMailbox.get_items.._load_from_childrenTr*_sync-collection REPORT not supported on scheduling mailbox %s; falling back to PROPFIND depth-1) rl_async_get_itemsr_rHr>rrGr,syncrdrjr7rcr8 get_itemsfs,     zScheduleMailbox.get_itemscsfdd}js2zjddIdH_WjSty1tdj|IdH_YjSwz jIdHWjStyP|IdH_YjSw)z"Async implementation of get_items.cs:fddIdHD}|D] }|IdHq|S)Ncrdrerfrrcr7r8reszQScheduleMailbox._async_get_items.._load_from_children..rgrircr7r8rjs  z=ScheduleMailbox._async_get_items.._load_from_childrenTrkNrl)r_rHr>rrGr, _async_syncror7rcr8rms*   z ScheduleMailbox._async_get_itemsr )r9rc)r0r1r2r3r rr4r r r'rrprmrr7r7rr8r^.s   -3r^c@eZdZejZdS)rN)r0r1r2r"rr`r7r7r7r8r rc@rr)rN)r0r1r2r"r r`r7r7r7r8rrsrc @seZdZdZdddZdeefddZdefdd Z d d Z d e d e de e ee effddZ  dddZde eeffddZdS)rEz This class may hold a cached snapshot of a calendar, and changes in the calendar can easily be copied over through the sync method. To create a SynchronizableCalendarObjectCollection object, use calendar.objects(load_objects=True) r9NcCs||_||_||_d|_dSr)rr)rH_objects_by_url)rdrrHr)r7r7r8rs z/SynchronizableCalendarObjectCollection.__init__cCs |jSr)rH__iter__rcr7r7r8ru z/SynchronizableCalendarObjectCollection.__iter__cCs t|jSr)rrHrcr7r7r8__len__rvz.SynchronizableCalendarObjectCollection.__len__cCs0|jduri|_|D] }||j|j<q |jS)zp returns a dict of the contents of the SynchronizableCalendarObjectCollection, URLs -> objects. N)rtr,r)rdrIr7r7r8objects_by_urls z5SynchronizableCalendarObjectCollection.objects_by_urlcurrent_by_url old_by_urlc Csg}g}|D]3\}}||vr6t||dr||jnd}t|dr&|jnd}||kr5|dur5||q||q|D] }||vrK|||q>t||_d|_|j |j|_ ||fS)zPure post-processing for the fallback sync path (no I/O). Compares current server state against cached state to determine what changed, then updates internal state. rN) rIrrrRr6valuesrHrtrr(r)) rdryrz updated_objs deleted_objsr,rIold_datanew_datar7r7r8_post_sync_fallbacks$  z:SynchronizableCalendarObjectCollection._post_sync_fallback6tuple[Any, Any] | Coroutine[Any, Any, tuple[Any, Any]]c Cs|jjr|Sg}g}t|jto|jd}|sz|jj|jdd}t|jtr3|jdr3d}no|}|D]U}|j |_ |j |vrit j j ||j jvrit j j |jvri||j jt j j |jt j j kriq9|||j <z |||Wq9tjy||||j Yq9wt||_d|_|j|_||fWSWntjtjfyd}Ynwtdt|j}|D]}z|WqtjyYqwdd|D}|||S) a Contact the server, fetch changes, and update the local collection. Falls back to comparing the full calendar state when the server does not support sync tokens. Returns a coroutine for async clients; call with ``await`` in that case. rFrkTN5Using fallback sync mechanism (comparing all objects)cSi|]}|j|qSr7r,rr;r7r7r8r<? z?SynchronizableCalendarObjectCollection.sync..)rrlrqrLr)r4rrUrxr,rr#r!rrjrrRr$rrr6r{rHrtrCrFr?rGrCr rdr|r} is_fake_tokenupdatesoburIcurrent_objectsryr7r7r8rns\   "     z+SynchronizableCalendarObjectCollection.syncc sg}g}t|jto|jd}|sz|jj|jddIdH}t|jtr/|jdr/d}nr|}|D]X}|j|_|j|vret j j ||jj vret j j |j vre||jj t j j |j t j j kreq5|||j<z| IdH||Wq5tjy||||jYq5wt||_d|_|j|_||fWSWntjtjfyd}Ynwtdt|jIdH}|D]}z | IdHWqtjyYqwdd|D}|||S) zAsync implementation of sync(). NOTE: the real-token loop mixes I/O (await obj.load()) with data manipulation; any changes here must be mirrored in sync(). rFrkNTrcSrr7rr;r7r7r8r<w rzFSynchronizableCalendarObjectCollection._async_sync..)rLr)r4rrrUrxr,rr#r!rrjrrRr$rrr6r{rHrtrCrFr?rGrCrrr7r7r8rqB sZ   "    z2SynchronizableCalendarObjectCollection._async_syncr )r9r)r0r1r2r3rrrrurrwrxrr[r6rrnrqr7r7r7r8rEs"    CrE)Mr3rrr dataclassesrrrrrtimertypingrrr r urllib.parser r r rrrrr davclientrrCrcollections.abcrrrrr base_clientrcalendarobjectresourcerrrrr davobjectr!elementsr"r#libr$r%lib.python_utilitiesr&lib.urlr'r( getLoggerr?r+r4rArHrrrNr6rUrYr[r\rr]r^rrrEr7r7r7r8sr