F2jdZddlmZddlZddlmZddlmZmZm Z m Z ddl m Z erddl mZddlmZmZmZdBd ZdCdZdDdZdEdZdFdZdFdZdFdZdGdZdHdZdId"Z dJdKd)ZdLd,ZdMd.ZdFd/Z dNd3Z!dOd5Z"dPd9Z#dQdRd@Z$gdAZ%dS)SzUtility functions.) annotationsN)wraps) TYPE_CHECKINGCallableOptionalSequence)PeriodEndBeforeStart)ComponentAdapter) RecurrenceIDsTime Timestampdtdatetime.datetimereturnr c*|S)z#Return the time stamp of a datetime) timestamp)rs b/home/thesage/.hermes/hermes-agent/venv/lib/python3.11/site-packages/recurring_ical_events/util.pyrrs <<>>dater datetime.datecLtj|j|j|jS)z%Converts a date or datetime to a date)datetimeryearmonthday)rs rconvert_to_daters =DJ 9 99rtzinfodatetime.tzinfo | Timec"t|dS)zWhether the time zone requires localize() and normalize(). pytz requires these funtions to be used in order to correctly use the time zones after operations. localize)hasattrrs ris_pytzr#s 6: & &&rtimecXt|r|j|S|S)zAWe have to normalize the time after a calculation if we use pytz.) is_pytz_dtr normalizer$s rnormalize_pytzr)#s-$+{$$T*** Krboolclt|tjot|tj S)z*Whether this is a date and not a datetime.) isinstancerrr(s ris_dater-*s) dHM * * V:dHDU3V3V/VVrc6t|tjS)z*Whether this is a datetime and not a date.)r,rr(s r is_datetimer//s dH- . ..rc2t|o|jduS)z*Whether this date/datetime has a timezone.N)r/rr(s r has_timezoner14s t   8D!88rOptional[datetime.tzinfo]cxt|r%tj|j|j|j}t |tjrk|j=|:t|r||S| |Sn%|#t| dS|S|S)a*Converts a date to a datetime. Dates are converted to datetimes with tzinfo. Datetimes loose their timezone if tzinfo is None. Datetimes receive tzinfo as a timezone if they do not have a timezone. Datetimes retain their timezone if they have one already (tzinfo is not None). Nr") r-rrrrr,rr#r replacer))rrs rconvert_to_datetimer59st}}B DJAA$)** ; !6??1!??4000||6|222"^!$''//t/<< < Kr+tuple[datetime.datetime, datetime.datetime]ct|r|n|dddd}||tjdzfS)zConvert the datetime to a start and end date in between it occurs. Returns: (start, end) where start <= dt < end r)hour microsecondminutesecond)days)r-r4r timedelta)rstarts rconvert_to_date_ranger@QsK "++ XBB2::1!AVW:#X#XE %(,!4444 44rdatesSequence[Time] list[Time]cdd}|D]+}t|sd}t|r |jn,|r|Sfd|DS)zEMake an list or tuple of dates comparable. Returns an list. NTFc0g|]}t|S)r5).0rrs r z#make_comparable..js$ @ @ @$ f - - @ @ @r)r-r1r)rA all_datesrrs @rmake_comparablerJ[su FIt}} ID!!  @ @ @ @% @ @ @@rF span_start span_stop event_start event_stop comparablec6|st||||f\}}}}||krtd|d|d||||krtd|d|d||||kr||kr||kS||cxko|kncS||kr||cxko|kncS||ko||kS)a{Return whether an event should is included within a time span. - span_start and span_stop define the time span - event_start and event_stop define the event time - comparable indicates whether the dates can be compared. You can set it to True if you are sure you have timezones and date/datetime correctly or used make_comparable() before. Note that the stops are exlusive but the starts are inclusive. This is an essential function of the module. It should be tested in test/test_time_span_contains_event.py. This raises a PeriodEndBeforeStart exception if a start is after an end. z+the event must start before it ends(start: z end: )z/the time span must start before it ends(start: )rJr )rKrLrMrNrOs rtime_span_contains_eventrRmsM,  9H K <: : 6 I{JZ"<&<<.8<<<      I":%::-6:::      j   " "*, ,[4444944444Yj5555:55555  " >zJ'>>rdate1date2c6t||f\}}||kS)zCCompare two dates if date1 > date2 and make them comparable before.rJrSrTs rcompare_greaterrXs!"E5>22LE5 5=rintcDt||f\}}||k||kz S)zCompare two dates, like cmp(). Returns ------- -1 if date1 < date2 0 if date1 = date2 1 if date1 > date2 rVrWs rcmpr[s,#E5>22LE5 EMeem ,,rc^t|tjot|jS)zWhether the time requires localize() and normalize(). pytz requires these funtions to be used in order to correctly use the time zones after operations. )r,rr#rr(s rr&r&s& dH- . . G74;3G3GGrfuncrpropertycdjtttdfd }|S)z&Cache the property value for speed up._cached_selfobjectcp|j}|ur|x|j<}|SN)__dict__get)ravaluer]name not_founds rcached_propertyz(cached_property..cached_propertysE !!$ 22 I  *.$t** 4DM$ % r)rarb)__name__rbr^r)r]rjrhris` @@rrjrjsg %dm % %DI  4[[[X rr ct|tjst|dfS|j|fS|tjjd|dfS)zConvert the time to a recurrence id so it can be hashed and recognized. The first value should be used to identify a component as it is a datetime in UTC. The other values can be used to look the component up. Nr")r,rr5r astimezonetimezoneutcr4r(s rto_recurrence_idsrps| dH- . .2#D$//11 {w )-..66d6CC D !! radapter1ComponentAdapter | Noneadapter2c(t||dS)z)Return the one with the highest sequence.c|dn|jS)Ng _)sequence)adapters rz'with_highest_sequence..sW_EE':Jr)key)max)rqrss rwith_highest_sequencer{s'  J J   r dictionarydictkeysSequence[object]defaultrbc@|}|D]}|||}|S)z)Get any item from the keys and return it.)rf)r|r~rresultrys rget_anyrs0 F--V,, Mr)r r[r@r5rr1r-r/r#r&rJr)rRrpr{)rrrr )rr rr)rr)r$r rr )r$r rr*)rr rr2rr)rr rr6)rArBrrC)F) rKr rLr rMr rNr rOr*rr*)rSr rTr rr*)rSr rTr rrY)r]rrr^)r$r rr )rqrrrsrrrd)r|r}r~rrrb)&__doc__ __future__rr functoolsrtypingrrrrrecurring_ical_events.errorsr (recurring_ical_events.adapters.componentr recurring_ical_events.typesr r r rrr#r)r-r/r1r5r@rJrRrXr[r&rjrpr{r__all__rFrrrs@"""""">>>>>>>>>>>>======KIIIIIIJJJJJJJJJJ :::: ''''WWWW //// 9999 05555AAAA. 2?2?2?2?2?j - - - - HHHH     $   r