i dZddlmZddlZddlmZddlmZddlmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZddlmZddlmZd d lmZer dd l m!Z!dd lm"Z"Gd deZ#dgZ$dS)zeThis implements the sub-component "AVAILABLE" of "VAVAILABILITY". This is specified in :rfc:`7953`. ) annotationsN)datetime) TYPE_CHECKING)CONCEPTS_TYPE_SETTERLINKS_TYPE_SETTERRELATED_TO_TYPE_SETTERcategories_propertycontacts_propertydescription_propertyduration_propertyexdates_propertylocation_propertyrdates_propertyrfc_7953_dtend_propertyrfc_7953_dtstart_propertyrfc_7953_duration_propertyrfc_7953_end_propertyrrules_propertysequence_propertysummary_property uid_property) get_example)InvalidCalendar) Component)Sequence)dateceZdZdZdZeZeZe Z e Z e ZeZeZeZeZeZddlmZexZZeZe dZ!e"Z#e$Z%e& d*d+fd$ Z'e&d,d-d)Z(xZ)S). AvailableaSub-component of "VAVAILABILITY from :rfc:`7953`. Description: "AVAILABLE" subcomponents are used to indicate periods of free time within the time range of the enclosing "VAVAILABILITY" component. "AVAILABLE" subcomponents MAY include recurrence properties to specify recurring periods of time, which can be overridden using normal iCalendar recurrence behavior (i.e., use of the "RECURRENCE-ID" property). Examples: This is a recurring "AVAILABLE" subcomponent: .. code-block:: ics BEGIN:AVAILABLE UID:57DD4AAF-3835-46B5-8A39-B3B253157F01 SUMMARY:Monday to Friday from 9:00 to 17:00 DTSTART;TZID=America/Denver:20111023T090000 DTEND;TZID=America/Denver:20111023T170000 RRULE:FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR LOCATION:Denver END:AVAILABLE You can get the same example from :meth:`example`: .. code-block: pycon >>> from icalendar import Available >>> a = Available.example() >>> str(a.summary) 'Monday to Friday from 9:00 to 17:00' AVAILABLEr) RECURRENCE_IDN categories Sequence[str]commentslist[str] | str | Noneconceptsrcontactscreated date | None description str | Noneenddatetime | None last_modifiedlinksrlocation recurrence_iddate | datetime | Nonerefids related_torsequence int | Nonestampstartsummaryuidstr | uuid.UUID | Nonec &t||n||||| | | |}||_||_||nt j|_||_||_ | |_ ||_ | |_ |j rn|+t|tr|jt#dt|tr|jt#d|||||_||_|S)a Create a new Available component with all required properties. This creates a new Available component in accordance with :rfc:`7953`. Parameters: categories: The :attr:`categories` of the Available component. comments: The :attr:`~icalendar.Component.comments` of the Available component. concepts: The :attr:`~icalendar.Component.concepts` of the Available component. contacts: The :attr:`contacts` of the Available component. created: The :attr:`~icalendar.Component.created` of the Available component. description: The :attr:`description` of the Available component. end: The :attr:`end` of the Available component. last_modified: The :attr:`~icalendar.Component.last_modified` of the Available component. links: The :attr:`~icalendar.Component.links` of the Available component. location: The :attr:`location` of the Available component. recurrence_id: The :attr:`RECURRENCE_ID` of the Available component. refids: :attr:`~icalendar.Component.refids` of the Available component. related_to: :attr:`~icalendar.Component.related_to` of the Available component. sequence: The :attr:`sequence` of the Available component. stamp: The :attr:`~icalendar.Component.stamp` of the Available component. If None, this is set to the current time. start: The :attr:`start` of the Available component. summary: The :attr:`summary` of the Available component. uid: The :attr:`uid` of the Available component. If None, this is set to a new :func:`uuid.uuid4`. Returns: :class:`Available` Raises: ~error.InvalidCalendar: If the content is not valid according to :rfc:`7953`. .. warning:: As time progresses, we will be stricter with the validation. N)r8r)r/r%r0r5r4r'z0Available end must be a datetime with a timezonez2Available start must be a datetime with a timezone)supernew_utc_nowr:r+uuiduuid4r;r6r#r1r(r! _validate_new isinstancertzinfor_validate_start_and_endr9r-)clsr#r%r'r(r)r+r-r/r0r1r2r4r5r6r8r9r:r; available __class__s R/root/projects/butler/venv/lib/python3.11/site-packages/icalendar/cal/available.pyr?z Available.newbs5~ %ww{{ ,%%#,,..'! + $  + "DJLL % ) % % "/    :sH--141C%FeX.. %,2F%H  - -eS 9 9 9   rfc_7953_1namestrreturnc^|td|jdS)z0Return the calendar example with the given name.availabilitiesr) from_icalrrH)rGrMs rJexamplezAvailable.examples)}}[)94@@AAKANNrK)r"NNNNNNNNNNNNNNNNN)$r#r$r%r&r'rr(r&r)r*r+r,r-r.r/r*r0rr1r,r2r3r4r&r5rr6r7r8r*r9r.r:r,r;r<)rL)rMrNrOr)*__name__ __module__ __qualname____doc__rMrr:r r+rr6r r#rr;rr1r r(r exdatesrrdatesrrrulesicalendar.attrr!rr9DTSTARTrDTENDr DURATIONrdurationrr- classmethodr?rS __classcell__)rIs@rJrr*s9!!F DG&K H$J C H HG F F,,,,,,//EG #E  --H)H C%'+/)-+/#"&#%)#'#04)--1#!!%"&*)______[_BOOOO[OOOOOrKr)%rW __future__rrArtypingrr[rrrr r r r r rrrrrrrrrricalendar.cal.examplesricalendar.errorr componentrcollections.abcrrr__all__r"rKrJris #"""""  (/.....++++++ ((((((]O]O]O]O]O ]O]O]O@ -rK