idZddlmZddlZddlmZddlmZmZm Z m Z ddl m Z erddl mZddlmZmZmZd@d ZdAdZdBdZdCdZdDdZdDdZdDdZdEdZdFd Z dGdHd'ZdId*ZdJd,ZdDd-ZdKd1Z dLd3Z!dMd7Z"dNdOd>Z#gd?Z$dS)PzUtility functions.) annotationsN)wraps) TYPE_CHECKINGCallableOptionalSequence)PeriodEndBeforeStart)ComponentAdapter) RecurrenceIDsTime Timestampdtdatetime.datetimereturnr c*|S)z#Return the time stamp of a datetime) timestamp)rs U/root/projects/butler/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/<< < KrdatesSequence[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..`s$ @ @ @$ f - - @ @ @r)r-r1r)r6 all_datesrrs @rmake_comparabler?Qsu 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: )r?r )r@rArBrCrDs rtime_span_contains_eventrGcsM,  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.r?rHrIs rcompare_greaterrMs!"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 rKrLs rcmprPs,#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)rVvaluerRname not_founds rcached_propertyz(cached_property..cached_propertysE !!$ 22 I  *.$t** 4DM$ % r)rVrW)__name__rWrSr)rRr_r]r^s` @@rr_r_sg %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_idsres| 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)rfrhs rwith_highest_sequencerps'  J J   r dictionarydictkeysSequence[object]defaultrWc@|}|D]}|||}|S)z)Get any item from the keys and return it.)r[)rqrsruresultrns rget_anyrxs0 F--V,, Mr)r rPr5rxr1r-r/r#r&r?r)rGrerp)rrrr )rr rr)rr)r$r rr )r$r rr*)rr rr2rr)r6r7rr8)F) r@r rAr rBr rCr rDr*rr*)rHr rIr rr*)rHr rIr rrN)rRrrrS)r$r rr )rfrgrhrgrY)rqrrrsrtrurW)%__doc__ __future__rr functoolsrtypingrrrrrecurring_ical_events.errorsr (recurring_ical_events.adapters.componentr recurring_ical_events.typesr r r rrr#r)r-r/r1r5r?rGrMrPr&r_rerprx__all__r;rrrs,"""""">>>>>>>>>>>>======KIIIIIIJJJJJJJJJJ :::: ''''WWWW //// 9999 0AAAA. 2?2?2?2?2?j - - - - HHHH     $   r