i"dZddlmZddlZddlmZmZddlmZm Z m Z ddl m Z ddl mZmZmZmZerddlmZdd lmZdd lmZdd lmZmZmZGd d eZd gZdS)zBase class for all adapters.) annotationsN)ABCabstractmethod) TYPE_CHECKINGOptionalSequence) vDDDTypes)cached_propertymake_comparabletime_span_contains_eventto_recurrence_ids)Alarm) Component)Series)UID RecurrenceIDsTimec<eZdZdZgdZeed7dZd8dZe d9d Z e d:d Z e d;dZ e d;dZ edZe edZe edZe dd?d!Zed@d#ZedAd$ZdAd%ZedBd'Zd7d(ZedCd*ZedDd,ZedEd.ZedFd0ZdGd3ZedHd5Z edFd6Z!dS)IComponentAdapterz6A unified interface to work with icalendar components.)RRULERDATEEXDATEreturnstrcdS)zThe icalendar component name.Nrc/root/projects/butler/venv/lib/python3.11/site-packages/recurring_ical_events/adapters/component.pycomponent_namezComponentAdapter.component_namer componentrc||_dS)zCreate a new adapter.N) _component)selfr!s r__init__zComponentAdapter.__init__$s #r list[Alarm]c6|jdS)zThe alarms in this component.VALARM)r#walkr$s ralarmszComponentAdapter.alarms(s##H---r str | NonecdS)zThe name of the end property.Nrr*s r end_propertyzComponentAdapter.end_property-s trrc|jdS)zThe start time.rspanr*s rstartzComponentAdapter.start2y|rc|jdS)z The end time.r0r*s rendzComponentAdapter.end7r3rcZt|j|jf\}}||kr||fS||fS)zReturn (start, end).)r raw_startraw_end)r$r2r6s rr1zComponentAdapter.span<s;%dndl%CDD s 3;;: czrcdSz+Return the start property of the component.Nrr*s rr8zComponentAdapter.raw_startDr rcdSr;rr*s rr9zComponentAdapter.raw_endIr rrcv|jdtt|jS)zyThe UID of a component. UID is required by RFC5545. If the UID is absent, we use the Python ID. r)r#getridr*s ruidzComponentAdapter.uidNs.""5#b.A.A*B*BCCCrsourcesuppress_errorstuple[Exception]Sequence[Series]crddlm}|||||S)zNCollect all components for this adapter. This is a shortcut. r)ComponentsWithName)$recurring_ical_events.selection.namerFrcollect_series_from)clsrArBrFs rrHz$ComponentAdapter.collect_series_fromWsM LKKKKK!!#"4"4"6"6<<PP O   rNTr2Optional[Time]stopkeep_recurrence_attributesboolc|j}t||jn||d<|dd|j t||jn|||j<|s|jD] }||vr||= |jjD]}| |d|vrt|dj |d<|S)zECreate a shallow copy of the source event and modify some attributes.NDTSTARTDURATION RECURRENCE-ID) r#copyr r2popr.r6ATTRIBUTES_TO_DELETE_ON_COPY subcomponents add_componentdt)r$r2rKrLcopied_component attribute subcomponents r as_componentzComponentAdapter.as_componentes  ?//11&/em QV&W&W#Z...   (2; Ld33 T. /* 4!> 4 4  000(3 O9 9 9L  * *< 8 8 8 8 "2 2 209 +.11 _ - rrcf|jd}|dSt|jS)zFThe recurrence ids of the component that might be used to identify it.rQNr)r#r>r rWr$ recurrence_ids rrecurrence_idszComponentAdapter.recurrence_idss5++O<<  2 !1222rcv|jd}|dSd|jvr|jddkSdS)z6The recurrence ids has a thisand future range propertyrQNFRANGE THISANDFUTURE)r#r>paramsr]s rthis_and_futurez ComponentAdapter.this_and_futuresJ++O<<  5 m* * * '0OC Curc*t|jS)z&Whether the adapter is a modification.)rMr_r*s ris_modificationz ComponentAdapter.is_modificationsD'(((rintc8|jddS)zjThe sequence in the history of modification. The sequence is negative if none was found. SEQUENCE)r#r>r*s rsequencezComponentAdapter.sequences "":r222rc rd|jjd|jd|jd|jd|jd|jd S)z$Debug representation with more info.) __class____name__r@r2r_rkr6r*s r__repr__zComponentAdapter.__repr__sl '  dh  tz  "1  =A]  8    r list[Time]cg}|jdg}t|ts|fn|D]&}|d|jD'|S)zA list of exdates.rc3$K|] }|jV dSNrW).0exdates r z+ComponentAdapter.exdates..s$>>&)>>>>>>rr#r> isinstancelistextenddts)r$resultexdatess rrzComponentAdapter.exdatesso /%%h33)3GT)B)BOzz ? ?G MM>>'+>>> > > > > rset[str]c|jdd}|stSdt|tr|n|gDS)z#A list of rrules of this component.rNcZh|](}|)Sr)to_icaldecode)rwrrules r z*ComponentAdapter.rrules..s<    MMOO " " $ $   r)r#r>setr{r|)r$ruless rrruleszComponentAdapter.rrulessb##GT22 55L  #-eT#:#:G%%    rlist[Time, tuple[Time, Time]]c|jdg}g}t|ts|fn|D]&}|d|jD'|S)z$A list of rdates, possibly a period.rc3$K|] }|jV dSrurv)rwrdates rryz*ComponentAdapter.rdates..s$;;u%(;;;;;;rrz)r$rdatesrs rrzComponentAdapter.rdatesso$$Wb11'1&$'?'?KviiV < r r2r6rW)r$subtract_from_start add_to_stoprecurrence_id_propr2r6r^s rextend_query_span_byz%ComponentAdapter.extend_query_span_bys#m(++ !_00AA  :(7TX'9'<=)) %E3 }$$+e3 }$$&)M&9#"K//rc|jrI|jd}|s Jdt|j|jf\}}||z St jdS)aOccurrences of this component should be moved by this amount. Usually, the occurrence starts at the new start time. However, if we have a RANGE=THISANDFUTURE, we need to move the occurrence. RFC 5545: When the given recurrence instance is rescheduled, all subsequent instances are also rescheduled by the same time difference. For instance, if the given recurrence instance is rescheduled to start 2 hours later, then all subsequent instances are also rescheduled 2 hours later. Similarly, if the duration of the given recurrence instance is modified, then all subsequence instances are also modified to have this same duration. rQz*RANGE=THISANDFUTURE implies RECURRENCE-ID.r)rdr#r>r r2rWrr)r$rr2r^s rmove_recurrences_byz$ComponentAdapter.move_recurrences_byss$   )!%!4!4_!E!E % S S'S S S S#2DJ@R@U3V#W#W E==( (!!$$$r)rr)r!r)rr&)rr,)rr)rr)rArrBrCrrD)NNT)r2rJrKrJrLrM)rr)rrM)rrg)rrr)rr)rr)rr)rrrrrrM)rr)"rp __module__ __qualname____doc__rT staticmethodrrr%propertyr+r.r2r6r r1r8r9r@ classmethodrHr[r_rdrfrkrqrrrrrrrrrrrrs@@#?#?#? ,,,^\,$$$$...X.XXX_::^X:::^X:DDDXD    [  !%#+/      4333_3_))))333_3    _   _ _%%%_%UUUU000_02%%%_%%%rr)r __future__rrabcrrtypingrrricalendar.propr recurring_ical_events.utilr r r r icalendarr icalendar.calrrecurring_ical_events.seriesrrecurring_ical_events.typesrrrr__all__rrrrsJ""""""""########4444444444$$$$$$E''''''333333DDDDDDDDDDb%b%b%b%b%sb%b%b%J  r