o .j@"@sdZddlmZmZmZddlmZmZddlmZddl m Z ddl m Z ddl mZddlmZmZd d lmZd d lmZd d lmZGd ddeZdgZdS)z&PERIOD property type from :rfc:`5545`.)datedatetime timedelta)AnyClassVar)Self)JCalParsingError) Parameters)tzp) is_datetimenormalize_pytz)TimeBase) vDatetime) vDurationc@sLeZdZUdZdZeeed<eed<e ed<e ed<e ed<e ed< d(d e e e e Bfde eefd Bfd d Zd dZddZed(ddZddZeddZede e e e BffddZddlmZedeefddZddlmZdedefd d!Zed"eeBde e e fe e e fBfd#d$Z ed%edefd&d'Z!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_durationstartenddurationNpercCs|\}}t|ttfstdt|tttfstdt|t}|r+|}t||}n|}t||}||kr;tdt|pAddi|_|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_durationrrrr!M/home/thesage/.local/lib/python3.10/site-packages/icalendar/prop/dt/period.py__init__Xs*    zvPeriod.__init__cCs4|j|jkr ||S|j|jko|jkSSN)roverlapsr)rotherr!r!r"r%xs  zvPeriod.overlapscCsF|jrt|jdt|jSt|jdt|jS)N/)rrrto_icalrrrrr!r!r"r(}s   zvPeriod.to_icalc Csjddlm}z|d\}}|j||d}|j||d}W||fSty4}ztd||d}~ww)Nr) vDDDTypes/)timezonezExpected period format, got: )icalendar.prop.dt.typesr*split from_ical Exceptionr)icalr,r*rr er!r!r"r/s zvPeriod.from_icalcCs*|jr |j|jfn|j|jf}d|dS)NzvPeriod())rrrr)rpr!r!r"__repr__s zvPeriod.__repr__cCs|j|jr |jfS|jfS)z-Make this cooperate with the other vDDDTypes.)rrrrr)r!r!r"dtsz vPeriod.dtreturncCs|jS)zv Returns the period as a tuple of its start datetime and either its end datetime or duration. )r6r)r!r!r" ical_valueszvPeriod.ical_valuer)FBTYPEc CsDttdddddtdddfttdddddtdddd d fgS) zExamples of vPeriod.i #r )hoursminutes)rrr)clsr!r!r"exampless"zvPeriod.examples)VALUEnamecCsnt|j|dg}|jr|t|j|dn |t|j|d||jjdd|j |gS)zBThe jCal representation of this property according to :rfc:`7265`.T) exclude_utc) rrto_jcalrappendrrrrrElower)rrFrr!r!r"rIs zvPeriod.to_jcaljcalc Cs4t|trd|vr|d}t|trt|dkr td||dtdt|d}Wdn1s7wYtdMt |dt||d drZt |d}n z t|d}Wn tyy}z td ||dd|d}~wwWd||fSWd||fS1swY||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. r+z-A period must be a list with exactly 2 items.)rrNr )Pz-Pz+Pz#Cannot parse date-time or duration.) rstrr.listlenrreraise_with_path_addedrparse_jcal_valuevalidate_value_type startswithr)rCrLrr r2r!r!r"rSsB        zvPeriod.parse_jcal_value jcal_propertycCst||td||d\}}Wdn1swYt|}|j}|r>t||}t |r>t||}|||f|dS)zParse jCal from :rfc:`7265`. Parameters: jcal_property: The jCal property to parse. Raises: ~error.JCalParsingError: If the provided jCal is invalid. N)r) rvalidate_propertyrRrSr from_jcal_propertytzidr localizer )rCrVrr rrZr!r!r" from_jcals    zvPeriod.from_jcalr$)"__name__ __module__ __qualname____doc__rrrO__annotations__r boolrrtupledictrr#r%r( staticmethodr/r5propertyr6r8icalendar.paramr9 classmethodrPrrDrErIrSr\r!r!r!r"rsH ?         !rN)r`rrrtypingrricalendar.compatibilityricalendar.errorricalendar.parserr icalendar.timezoner icalendar.toolsr r baserrrrr__all__r!r!r!r"s        b