iR!dZddlmZmZmZddlmZmZddlmZddl m Z ddl m Z ddl mZddlmZmZd d lmZd d lmZd d lmZGd deZdgZdS)z&PERIOD property type from :rfc:`5545`.)datedatetime timedelta)AnyClassVar)Self)JCalParsingError) Parameters)tzp) is_datetimenormalize_pytz)TimeBase) vDatetime) vDurationceZdZUdZdZeeed<eed<e ed<e ed<e ed<e ed< dd e e e e zfde eefd zfd Zd Zd ZeddZdZedZddlmZedeefdZddlmZdedefdZedeezde e e fe e e fzfdZededefdZ d S)vPerioda Period of Time Value Name: PERIOD Purpose: This value type is used to identify values that contain a precise period of time. Format Definition: This value type is defined by the following notation: .. code-block:: text period = period-explicit / period-start period-explicit = date-time "/" date-time ; [ISO.8601.2004] complete representation basic format for a ; period of time consisting of a start and end. The start MUST ; be before the end. period-start = date-time "/" dur-value ; [ISO.8601.2004] complete representation basic format for a ; period of time consisting of a start and positive duration ; of time. Description: If the property permits, multiple "period" values are specified by a COMMA-separated list of values. There are two forms of a period of time. First, a period of time is identified by its start and its end. This format is based on the [ISO.8601.2004] complete representation, basic format for "DATE- TIME" start of the period, followed by a SOLIDUS character followed by the "DATE-TIME" of the end of the period. The start of the period MUST be before the end of the period. Second, a period of time can also be defined by a start and a positive duration of time. The format is based on the [ISO.8601.2004] complete representation, basic format for the "DATE-TIME" start of the period, followed by a SOLIDUS character, followed by the [ISO.8601.2004] basic format for "DURATION" of the period. Example: The period starting at 18:00:00 UTC, on January 1, 1997 and ending at 07:00:00 UTC on January 2, 1997 would be: .. code-block:: ics 19970101T180000Z/19970102T070000Z The period start at 18:00:00 on January 1, 1997 and lasting 5 hours and 30 minutes would be: .. code-block:: ics 19970101T180000Z/PT5H30M .. code-block:: pycon >>> from icalendar.prop import vPeriod >>> period = vPeriod.from_ical('19970101T180000Z/19970102T070000Z') >>> period = vPeriod.from_ical('19970101T180000Z/PT5H30M') PERIOD default_valueparams by_durationstartenddurationNperc|\}}t|ttfstdt|tttfstdt|t}|r|}t ||z}n|}t ||z }||krt dt|pddi|_|j |||_ ||_ ||_ ||_ dS)Nz/Start value MUST be a datetime or date instancez>end_or_duration MUST be a datetime, date or timedelta instancez#Start time is greater than end timevaluer) isinstancerr TypeErrorrr ValueErrorr rupdate_tzid_fromrrrr)selfrrrend_or_durationrrrs S/root/projects/butler/venv/lib/python3.11/site-packages/icalendar/prop/dt/period.py__init__zvPeriod.__init__Xs "%58T"233 OMNN N?XtY,GHH P !)<<  3&H !122CC!C%cEk22H 3;;BCC C !>GX+>??  $$U+++ &  c|j|jkr||S|j|jcxko |jkncSN)roverlapsr)r"others r$r)zvPeriod.overlapsxsK : # #>>$'' 'zU[33334833333r&cP|jrPt|jdzt |jzSt|jdzt|jzS)N/)rrrto_icalrrrr"s r$r-zvPeriod.to_ical}s   $*%%--//DM**22445  $$,,..5 $(8K8K8S8S8U8UUUr&cddlm} |d\}}|||}|||}n%#t$r}t d||d}~wwxYw||fS)Nr) vDDDTypes/)timezonezExpected period format, got: )icalendar.prop.dt.typesr0split from_ical Exceptionr )icalr2r0rr#es r$r5zvPeriod.from_icals555555 L%)ZZ__ "E?'''AAE'11/H1UUOO L L LCTCCDD! K L''sAA A1A,,A1cT|jr|j|jfn |j|jf}d|dS)NzvPeriod())rrrr)r"ps r$__repr__zvPeriod.__repr__s7+/+; WTZ ' '$*dhAW !    r&c:|j|jr|jn|jfS)z-Make this cooperate with the other vDDDTypes.)rrrrr.s r$dtz vPeriod.dts! d.>LT]]DHNNr&r)FBTYPEreturnc ttdddddtddfttdddddtdddd d fgS) zExamples of vPeriod.i #r)hoursminutes)rrr)clss r$exampleszvPeriod.examplessm XdBB33YQPR5S5S5ST U U XdBB33XdBBPQ5R5RS T T  r&)VALUEnamect|j|dg}|jrA|t |j|dn@|t|j|d||jd|j |gS)zBThe jCal representation of this property according to :rfc:`7265`.T) exclude_utc) rrto_jcalrappendrrrrrMlower)r"rNrs r$rRzvPeriod.to_jcals4:&&..t44R89   @ LL4=1199$??C D D D D LL48,,44T::2> ? ? ?dk))d);;TZ=M=M=O=OQVWWr&jcalct|trd|vr|d}t|trt |dkrt d||t jd5tj|d}dddn #1swxYwYt jd5t j |dt||d drtj|d}nG tj|d}n+#t $r}t d ||d|d}~wwxYwdddn #1swxYwY||fS) zParse a jCal value. Raises: ~error.JCalParsingError: If the period is not a list with exactly two items, or it can't parse a date-time or duration. r1z-A period must be a list with exactly 2 items.)rrNr)Pz-Pz+Pz#Cannot parse date-time or duration.) rstrr4listlenr reraise_with_path_addedrparse_jcal_valuevalidate_value_type startswithr)rKrUrr#r8s r$r]zvPeriod.parse_jcal_values dC  #SD[[::c??D$%% Ta"?D  5a 8 8 8 8.tAw77E 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8  5a 8 8    0a#s C C CAw!!"344 "+">>  5a 8 8 L L%(%9%9-:J%K%K "E? L L L L L L L L L L L L L L L.}=={  FL--E?++ F"%,"E"EsE?+F;;;;sAAAr()!__name__ __module__ __qualname____doc__rrrY__annotations__r boolrrtupledictrr%r)r- staticmethodr5r<propertyr>icalendar.paramr? classmethodrZrrLrMrRr]rgr&r$rrs==~$,M8C=+++  OOO MMM )-!! 8X 11 2!S#X%!!!!@444 VVV ( ( (\ (!!!OOXO'&&&&& d   [ &%%%%%XCXDXXXX&:& x! "U8Y+>%? ?&&&[&Br}s,,.......... ((((((,,,,,,''''''""""""77777777V<V<V<V<V