+ jïRt^RIHt^RIt^RIHt^RIHt^RIH t HtH t H t H t ^RI Ht^RIHtHtHtHtHt^RIHtHtHtHtHtHtHtHtHtHt^R I H!t!^R I"H#t#^R I$H%t%H&t&^R I'H(t(H)t)H*t*H+t+H,t,^R I-H.t.^RI/H0t0^RI1H2t2H3t3H4t4H5t5H6t6^RI7H8t8^RI9H:t:]'d ^RI;Ht>.t?]!RR44t@!RR]#4tARRltBR.tCR#)z$The base for :rfc:`5545` components.) annotationsN)deepcopy) dataclass)datedatetimetime timedeltatimezone)Path) TYPE_CHECKINGAnyClassVarLiteraloverload) CONCEPTS_TYPE_SETTERLINKS_TYPE_SETTERRELATED_TO_TYPE_SETTERcomments_propertyconcepts_propertylinks_propertyrefids_propertyrelated_to_propertysingle_utc_property uid_property)ComponentFactory) CaselessDict)InvalidCalendarJCalParsingError) Contentline Contentlines Parametersq_joinq_split)ComponentIcalParser)DEFAULT_ENCODING) VPROPERTY TypesFactory vDDDListsvTextvUnknown)tzpis_date)Iterable)SelfcZ]tRt^0t$RtR]R&R]R&RtR]R&^tR]R &^tR]R &R t R#) _ComponentEqFramezwA pending component-equality comparison on the iterative stack. See ``Component.__eq__`` for how the fields are used. ComponentabNz list | None unmatchedinta_indexcandidate_index) __name__ __module__ __qualname____firstlineno____doc____annotations__r4r6r7__static_attributes__r8V/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/cal/component.pyr0r00s3 LL"I{!GSOSr@r0ca]tRt^Ct$RtRtR]R&RqtR]R&RqtR]R&Rqt R]R&Rqt R]R &Rqt R ]R &R t R ]R&] P!4tR]R&RtR]R&R]R&]RRl4t]RRl4t]RRl4t]RRl4tRV3RlltRR ltR!V3R"lltRrR#R$lltR%R&lt]RsR'l4tRtR)R*lltR+R,lt]3R-R.llt RuR/lt!RuR0lt"R1R2lt#R3R4lt$RR53R6R7llt%R8R9lt&RvR:R;llt'](]RwR<R=ll44t)](]R>R?l44t)]R@RAl4t*]RwRBRCll4t)]RxRDl4t+RyRERFllt,RyRGRHllt-RyRIRJllt.RKRLlt/RMRNlt0]1!RORP4;t2t3]1!RQRR4t4]5RSRTl4t6]6PnRU4t6]6PpRV4t6]5RWRXl4t9]9PnRY4t9]9PpRZ4t9R[R\lt:]R]R^l4t;]t?]@tA]BtC]DtE]FtG]1!R_R`4tHR(tI]Ra4tJ]RzRbRcll4tKRdReltLRfRgltM]RhRil4tNRwRjV3RkllltORlRmltPRnRoltQRptRV;tS#){r1zBase class for calendar components. Component is the base object for calendar, Event and the other components defined in :rfc:`5545`. Normally you will not use this class directly, but rather one of the subclasses. NzClassVar[str | None]namezClassVar[tuple[()]]required singletonsmultiple exclusivez-ClassVar[tuple[str] | tuple[tuple[str, str]]] inclusiveFzClassVar[bool]ignore_exceptionszClassVar[TypesFactory] types_factoryz!ClassVar[ComponentFactory | None]_components_factorylist[Component] subcomponentscV^8dQhRR/#)returnrr8)formats"rA __annotate__Component.__annotate__s'''7'r@c TVPf\4VnVP#)zGet the component factory.)rKr)clss&rA_get_component_factory Component._get_component_factorys'  " " *&6&8C #&&&r@c V^8dQhRRRR/#)rOrCstrrPtype[Component]r8)rQs"rArRrSsFFsFFr@c @VP4PV4#)zdReturn a component with this name. Parameters: name: Name of the component, i.e. ``VCALENDAR`` )rVget_component_class)rUrCs&&rAr\Component.get_component_classs))+??EEr@c V^8dQhRRRR/#)rOcomponent_classrZrPNoner8)rQs"rArRrSs#?#?#?4#?r@c "\VR4'dVPf\V R24hVP4pVP VP4pVe!W1Jd\RVP RV 24hVP V4R#)auRegister a custom component class. Parameters: component_class: Component subclass to register. Must have a ``name`` attribute. Raises: ValueError: If ``component_class`` has no ``name`` attribute. ValueError: If a component with this name is already registered. Examples: Create a custom icalendar component with the name ``X-EXAMPLE``: .. code-block:: pycon >>> from icalendar import Component >>> class XExample(Component): ... name = "X-EXAMPLE" ... def custom_method(self): ... return "custom" >>> Component.register(XExample) rCNz must have a 'name' attributez Component 'z' is already registered as )hasattrrC ValueErrorrVgetadd_component_class)rUr_component_factoryexistings&& rAregisterComponent.registers0//?3G3G3O00MNO O 668$(()=)=>  H$Co2234j"  --o>r@c V^8dQhRRRR/#)rOvaluez1date | datetime | timedelta | time | tuple | listrP str | Noner8)rQs"rArRrSs@ r@c \V\4'dV'gR#\;QJdRV4F 'dK RM RM !RV44'dR#\;QJdRV4F 'dK RM RM !RV44'dR#R#\V4'dR#\V\4'dR#R#)aInfer the ``VALUE`` parameter from a Python type. Parameters: value: Python native type, one of :class:`datetime.date`, :class:`datetime.datetime`, :class:`datetime.timedelta`, :class:`datetime.time`, :class:`tuple`, or :class:`list`. Returns: str or None: The ``VALUE`` parameter string, for example, "DATE", "TIME", or other string, or ``None`` if no specific ``VALUE`` is needed. Nc38"TFp\V4xK R#5iNr+.0items& rA .Component._infer_value_type..s3UT74==UsFTDATEc3B"TFp\V\4xK R#5iro) isinstancerrps& rArsrts> eT " "r@c$V^8dQhRRRRRR/#)rOargsr kwargsrPr`r8)rQs"rArRrSs!cSTr@c D<\SV`!V/VB.Vn.VnR#)z#Set keys to upper for initial dict.N)super__init__rMerrors)selfrr __class__s&*,rArComponent.__init__s) $)&).0  r@cV^8dQhRR/#rOrPboolr8)rQs"rArRrSs$r@c R#)zAReturns True, CaselessDict would return False if it had no items.Tr8rs&rA__bool__Component.__bool__sr@cV^8dQhRR/#)rOrPr%r8)rQs"rArRrSs(()(r@c "<\SV`V4#)z1Get property value from the component dictionary.)r __getitem__)rkeyrs&&rArComponent.__getitem__sw"3''r@cV^8dQhRR/#)rOrPr r8)rQs"rArRrSsr@c :W,# \dTu#i;i)z Get property value with default.)KeyError)rrdefaults&&&rArd Component.gets# 9  N s  cV^8dQhRR/#rr8)rQs"rArRrSsBB$Br@c r\\VP44VP,'*4#)zDReturns True if Component has no items or subcomponents, else False.)rrzvaluesrMrs&rAis_emptyComponent.is_emptys&T[[]+d.@.@@@AAr@c rV'gV#\W PP4'dTpMRpV'dRV9d VR,pMQ\W PP4'g-VPV4pV'dTpVf/pRV9dWsR&VPP W4pV!V4pV'dn\ VR4'g\ 4VnVP4F8wrV f"WP9dVPV K(K*WPV &K: V#)aEncode values to icalendar property values. :param name: Name of the property. :type name: string :param value: Value of the property. Either of a basic Python type of any of the icalendar's own property types. :type value: Python native type or icalendar property type. :param parameters: Property parameter dictionary for the value. Only available, if encode is set to True. :type parameters: Dictionary :param encode: True, if the value should be encoded to one of icalendar's own property types (Fallback is "vText") or False, if not. :type encode: Boolean :returns: icalendar property value NVALUEparams) rwrJ all_typesr} for_propertyrbr ritems) rUrCrk parametersencodeobj value_paraminferredklassrrrs &&&&& rA_encodeComponent._encodes ,L e..88 9 9CKg3(1 '8'8'B'BCC007"*K!)%' j0.67+%%224EE,C 3))'\ '--/ <jj(JJsO)'+JJsO 0  r@Tc(V^8dQhRRRRRRRR/#) rOrCrYrzdict[str, str] | ParametersrrrPr`r8)rQs"rArRrS0s8HHH0 H  H  Hr@c  \V\4'd,VP4R9d\P!V4pV'dM\V\ 4'd7VP4R9d"VUu.uFqPP WW44NK ppMVP WW44pW9dUW,p\V\ 4'd4\V\ 4'd Wb,pMVPV4TpMWb.pW V&R#uupi)aAdd a property to this component. If the property already exists, the new value is appended so the property carries a list of values rather than replacing the previous one. When ``name`` is ``DTSTAMP``, ``CREATED``, or ``LAST-MODIFIED`` and ``value`` is a ``datetime``, the value is converted to UTC as the RFC requires. Parameters: name: Name of the property. value: Value of the property. Either a basic Python type or any of icalendar's own property types. parameters: Property parameter dictionary for the value. Only consulted when ``encode`` is ``True``. encode: ``True`` if the value should be encoded to one of icalendar's own property types (fallback is ``vText``); ``False`` to store the value as-is. Returns: ``None`` Example: >>> from icalendar import Event >>> event = Event() >>> event.add("summary", "Team sync") >>> event["summary"] vText(b'Team sync') N)dtstampcreatedz last-modified)rdateexdate categories)rwrlowerr* localize_utcrzrappend)rrCrkrrvoldvals&&&&& rAadd Component.add0sP eX & &4::<< , $$U+E 5$'' $EEINN1\\$:>ENELLjAE <ZF&$''eT**"NEMM%("ET !Os9Dc V^8dQhRRRR/#)rOrCrYrkr%r8)rQs"rArRrSzsC r@c \VR4'd VP#\V\4'dV#VPP W4p\V\ \34'dVP\4pV#)z&Internal for decoding property values. ical_value) rbrrwr'rJ from_icalr(r)rr$)rrCrkdecodeds&&& rA_decodeComponent._decodezsm 5, ' '## # eY ' 'L$$..t; gx0 1 1nn%56Gr@c$V^8dQhRRRRRR/#)rOrCrYrr rPr8)rQs"rArRrSs!  C # C r@c W9dPW,p\V\4'd!VUu.uFq@PW4NK up#VPW4#V\Jd \ V4hV#uupi)zReturns decoded value of property. A component maps keys to icalendar property value types. This function returns values compatible to native Python types. )rwrzr_markerr)rrCrrkrs&&& rArComponent.decodedsd <JE%&&7<=u! T-u==<<, , g 4.  >sA-c \W,4Uu.uFq3PR4NK ppV'd!VUu.uFqPPW4NK up#V#uupiuupi)z*Returns a list of values (split on comma).z" )r"stripr)rrCdecodervalsvals&&& rA get_inlineComponent.get_inlinesQ'.tz':;':! ':; 7;Component.sr@c$V^8dQhRRRRRR/#rr8)rQs"rArRrSs((((,(  (r@c LVeVP4pVPW4#)arRecursively traverses component and subcomponents. Returns sequence of same. If name is passed, only components with name will be returned. :param name: The name of the component or None such as ``VEVENT``. :param select: A function that takes the component as first argument and returns True/False. :returns: A list of components that match. :rtype: list[Component] )upperr)rrCrs&&&rAwalkComponent.walks$  ::.s !%%3,r@)r)r)rrs&frAwith_uidComponent.with_uidsyy 6y77r@c$V^8dQhRRRRRR/#)rO recursiversortedrPzlist[tuple[str, object]]r8)rQs"rArRrSs()))) " )r@c .pVPR,pVR3.pV'EdMVP4wrgV'd4VPRV!VP4P 434KVVPRV!VP4P 434V'dVP 4MVP 4pVFPp Wi,p \V \4'dV Fp VPW34K K>VPW34KR VPVR34V'gEK#\VP4Fp VPV R34K EKUV#)zoReturns properties in this component and subcomponents as a list. The list contains ``(name, value)`` tuples. textFENDBEGINT) rJrrrCto_ical sorted_keyskeysrwrzrrM) rrrrv_textrcompis_endproperty_namesrCrrk subcomponents &&& rAproperty_itemsComponent.property_itemss$##F+e 99;LD ufTYY&7&?&?&ABC wtyy(9(A(A(CDE7=!1!1!3499;*D!ZF!&$//%+E"MM4-8&, tn5+ dD\*9(01C1C(D  lE%:;)E r@c$V^8dQhRRRRRR/#)rOst str | bytesrFzLiteral[False]rPr1r8)rQs"rArRrSs$(6 r@c R#ror8rUrrFs&&&rArComponent.from_icalsr@c$V^8dQhRRRRRR/#)rOrrrFz Literal[True]rPrLr8)rQs"rArRrSsXX;X-XOXr@c R#ror8rs&&&rArr sUXr@c V^8dQhRRRR/#)rOrrrPr#r8)rQs"rArRrSsXX+X2EXr@c J\WP4VP4#)z/Get the iCal parser for the given input string.)r#rVrJ)rUrs&&rA_get_ical_parserComponent._get_ical_parsers #2'A'A'CSEVEVWWr@c$V^8dQhRRRRRR/#)rOrzstr | bytes | PathrFrrPzComponent | list[Component]r8)rQs"rArRrSs$44#4/34 $4r@c T\V\4'dVP4pM_\V\4'dJRV9dCRV9d<\V4P 4pV'd\V4P4pVPV4pVP4pV'dV#\V4^8d\ VPRV44h\V4^8d\ VPRV44hV^,# \ \ 3dRpLi;i)aParse iCalendar data into component instances. Handles standard and custom components (``X-*``, IANA-registered). Parameters: st: iCalendar data as bytes or string, or a path to an iCalendar file as :class:`pathlib.Path` or string. multiple: If ``True``, returns list. If ``False``, returns single component. Returns: Component or list of components See Also: :doc:`/how-to/custom-components` for examples of parsing custom components   Fz3Found multiple components where only one is allowedz1Found no components where exactly one is required) rwr read_bytesrYis_fileOSErrorrcrparselen _format_error)rUrrFrparser componentss&&& rArr s & b$  B C T^B  r(**,"X((*%%b)\\^   z?Q !!I2  z?Q !!G  !}1Z(    s DD'&D'c ^ap\V4\V4,\V4,V8d0V\V4, \V4, pV RVRV RV 2#V RV 2#)dz: N )r)error_description bad_inputelipsismax_error_length truncate_tos&&& rArComponent._format_errorUsv#  !C N 2S\ ADT T*S1B-CCc'lRK'(9\k+B*C1WIN N#$Byk22r@cV^8dQhRR/#rOrrr8)rQs"rArRrS^sJJJr@c \\VR\44p\P!WW#R7#)z!Returns property as content line.rr)getattrr r from_parts)rrCrkrrs&&&& rA content_lineComponent.content_line^s%*,7%%dEIIr@cV^8dQhRR/#r&r8)rQs"rArRrScsDr@c \4pVPVR7F)wr4VPW4VR7pVPV4K+ VPR4V#)zB    #> Br@cV^8dQhRR/#r&r8)rQs"rArRrSls''d'r@c FVPVR7pVP4#)ze :param sorted: Whether parameters and properties should be lexicographically sorted. r()r2r)rrr2s&& rArComponent.to_icalls& **&*9 $$&&r@cV^8dQhRR/#rOrPrYr8)rQs"rArRrSus++#+r@c .pRV3.pV'EdBVP4pV^,pVR8XdVPR4K<VR8XdVPR4KVV^,p\V\4'dTPVP;'g\ V4P R\V4 24VPpV'dKVPR4\V4F'pVPRV34VPR 4K) EKVPR4EK-VP\V44EKJRPV4#) aString representation of class with all of its subcomponents. Implemented iteratively rather than recursively so that calendars with deeply nested subcomponents do not raise ``RecursionError``. A pathological ``.ics`` payload of only ~13 KB can otherwise nest ``BEGIN:VEVENT`` ~500 levels and crash any caller that performs ``repr()``/``str()``/``f"{cal}"`` on the parsed calendar (e.g. logging, error reporting, debug pages). opencommaz, close)(r/)r<)r;) rrrwr1rCtyper9dictrMrrYjoin)routrframekindnodesubssubs& rA__repr__Component.__repr__us%tn-eIIKE8Dw 4  3QxdI..JJ$))"B"BtDz/B/B!C1T$ZLQR--D  Z0#+D>C!LL&#7!LL4$2 3JJs4y)wws|r@c V^8dQhRRRR/#)rOotherr1rPrr8)rQs"rArRrSs66I6$6r@c b\V\4'g\#\W4.pRpV'EdVR,pVPf\ VP P4\ VPP48wg2\P!VP VP4'gVP4RpK\VPP4VnM_Ve\V'd9VPVPV;P^, un^Vn MV;P^, un RpVP\ VP P48dVP4RpEKmVP\ VP48dVP4RpEKVP\VP PVP,VPVP,44EKV#)NFT)rwr1NotImplementedr0r4rr2rMr3r__eq__rrzr7r6r)rrKr child_resultrCs&& rArOComponent.__eq__s%++! !&#4/0 e"IE&uww,,-UWW5J5J1KK ''99IIK#(L"&uww'<'<"=)(=(=>MMQ&M,-E)))Q.)# }}EGG$9$9 :: # &&#eoo*>> $  %--emm<(=(=> r@DTSTAMPa The UTC datetime stamp recording when this component instance was created or last revised. This property is defined in :rfc:`5545#section-3.8.7.2`. It's required in ``VEVENT``, ``VTODO``, ``VJOURNAL``, and ``VFREEBUSY`` components. When the calendar object carries a ``METHOD`` property, such as for scheduling, this value is the creation time of *this particular revision*. Without a ``METHOD`` property, it's equivalent to :attr:`LAST_MODIFIED`. The value is always in UTC. It's also accessible as :attr:`stamp`. Example: .. code-block:: pycon >>> from datetime import timezone, datetime >>> from icalendar import Event >>> event = Event() >>> event.DTSTAMP = datetime(2024, 6, 1, 12, 0, 0, tzinfo=timezone.utc) >>> event.DTSTAMP datetime.datetime(2024, 6, 1, 12, 0, tzinfo=ZoneInfo(key='UTC')) See also: :attr:`CREATED`, :attr:`DTSTAMP`, :attr:`LAST_MODIFIED`, :attr:`created`, :attr:`stamp`, :attr:`last_modified` z LAST-MODIFIEDaThe UTC datetime when this component's information was last revised, per :rfc:`5545#section-3.8.7.3`. It's analogous to a file's modification timestamp. This property is optional. When it's absent, :attr:`last_modified` falls back to :attr:`DTSTAMP`. This property is applicable to ``VEVENT``, ``VTODO``, ``VJOURNAL``, and ``VTIMEZONE`` components. The value is always in UTC. Example: .. code-block:: pycon >>> from datetime import timezone, datetime >>> from icalendar import Event >>> event = Event() >>> event.LAST_MODIFIED = datetime(2024, 6, 1, 9, 0, 0, tzinfo=timezone.utc) >>> event.LAST_MODIFIED datetime.datetime(2024, 6, 1, 9, 0, tzinfo=ZoneInfo(key='UTC')) See also: :attr:`CREATED`, :attr:`DTSTAMP`, :attr:`LAST_MODIFIED`, :attr:`created`, :attr:`stamp`, :attr:`last_modified` cV^8dQhRR/#rOrPrr8)rQs"rArRrSs22x2r@c BVP;'g VP#)zDatetime when the information associated with the component was last revised. Since :attr:`LAST_MODIFIED` is an optional property, this returns :attr:`DTSTAMP` if :attr:`LAST_MODIFIED` is not set. ) LAST_MODIFIEDrRrs&rA last_modifiedComponent.last_modifieds!!11T\\1r@c WnR#rorVrrks&&rArWrXs"r@c V=R#rorZrs&rArWrXs  r@cV^8dQhRR/#rTr8)rQs"rArRrS#s,,,r@c BVP;'g VP#)zDatetime when the information associated with the component was created. Since :attr:`CREATED` is an optional property, this returns :attr:`DTSTAMP` if :attr:`CREATED` is not set. )CREATEDrRrs&rArComponent.created"s||++t||+r@c WnR#ror_r[s&&rArr`+s r@c V=R#rorbrs&rArr`/s Lr@cV^8dQhRR/#rr8)rQs"rArRrS3sFFFr@c \;QJd*RVP44F 'gK R# R#!RVP444#)zXWhether this component has attributes that indicate that Mozilla Thunderbird created it.c3B"TFqPR4xK R#5i)zX-MOZ-N) startswith)rqattrs& rArs+Component.is_thunderbird..5sE??8,,rxTF)anyrrs&rAis_thunderbirdComponent.is_thunderbird3s7sEEssEsEsEEEEr@cV^8dQhRR/#rTr8)rQs"rArRrS8s**h*r@c J\P!\P4#)zReturn now as UTC value.)rnowr utcr8r@rA_utc_nowComponent._utc_now7s||HLL))r@r_aThe UTC datetime when this calendar component was first created, per :rfc:`5545#section-3.8.7.1`. This property records when the calendar user agent originally stored the component. This property is optional. When it's absent, :attr:`created` falls back to :attr:`DTSTAMP`. This property is applicable to ``VEVENT``, ``VTODO``, and ``VJOURNAL`` components. The value is always in UTC. Example: .. code-block:: pycon >>> from datetime import timezone, datetime >>> from icalendar import Event >>> event = Event() >>> event.CREATED = datetime(2024, 1, 1, 8, 0, 0, tzinfo=timezone.utc) >>> event.CREATED datetime.datetime(2024, 1, 1, 8, 0, tzinfo=ZoneInfo(key='UTC')) See also: :attr:`CREATED`, :attr:`DTSTAMP`, :attr:`LAST_MODIFIED`, :attr:`created`, :attr:`stamp`, :attr:`last_modified` c <VeVfR#W8d \R4hR#)zcThis validates start and end. Raises: ~error.InvalidCalendar: If the information is not valid Nzend must be after start)r)startends&&rA_validate_start_and_end!Component._validate_start_and_end`s& =CK  ;!";< < r@c@V^8dQhRRRRRRRRRR R RR R R RRRRR/ #)rOrz date | Nonecommentszlist[str] | str | NoneconceptsrrWlinksrrefids related_torstamprMzIterable[Component] | NonerPr.r8)rQs"rArRrSmsn...).' . # . ! .'.+..2. .r@c  V!4p WnWnWJnW*nWZnWznW:nWjnV e)\V \4'dT M \V 4V n V #)aCreate a new component. Parameters: comments: The :attr:`comments` of the component. concepts: The :attr:`concepts` of the component. created: The :attr:`created` of the component. last_modified: The :attr:`last_modified` of the component. links: The :attr:`links` of the component. related_to: The :attr:`related_to` of the component. stamp: The :attr:`DTSTAMP` of the component. subcomponents: The subcomponents of the component. Raises: ~error.InvalidCalendar: If the content is not valid according to :rfc:`5545`. .. warning:: As time progresses, we will be stricter with the validation. ) rRrrWryr{r}rzr|rwrzrM) rUrryrzrWr{r|r}r~rMrs &&&&&&&&&& rAnew Component.newlsm@E !#"/%)%!  $mT22-(  # r@cV^8dQhRR/#)rOrPrzr8)rQs"rArRrSs---r@c RRlpV!V4pW3.pV'd\VP4wrEV^,pVPF.pV!V4pVPV4VPWx34K0 KcV#)aConvert this component to a jCal object. Returns: jCal object See also :attr:`to_json`. In this example, we create a simple VEVENT component and convert it to jCal: .. code-block:: pycon >>> from icalendar import Event >>> from datetime import date >>> from pprint import pprint >>> event = Event.new(summary="My Event", start=date(2025, 11, 22)) >>> pprint(event.to_jcal()) ['vevent', [['dtstamp', {}, 'date-time', '2025-05-17T08:06:12Z'], ['summary', {}, 'text', 'My Event'], ['uid', {}, 'text', 'd755cef5-2311-46ed-a0e1-6733c9e15c63'], ['dtstart', {}, 'date', '2025-11-22']], []] c V^8dQhRRRR/#)rOrr1rPrzr8)rQs"rArR'Component.to_jcal..__annotate__s 7 7I 7$ 7r@c VP4UUUu.uFFwr\V\4'dTMV.F"pVPVP 44NK$ KH ppppVP P 4V..#uupppiro)rrwrzto_jcalrrC)rrrkrr propertiess& rA make_node$Component.to_jcal..make_nodesz#'**,".JC&0&=&=UE7JD SYY[)J*".  IIOO%z26 6 sA B)rrMr) rr root_noderrrEchildrenr child_nodes & rArComponent.to_jcalss6 7dO 04/@.AJDAwH $ 2 2 &|4  + l78!3r@cV^8dQhRR/#r8r8)rQs"rArRrSs***r@c J\P!VP44#)zbReturn this component as a jCal JSON string. Returns: JSON string See also :attr:`to_jcal`. )jsondumpsrrs&rAto_jsonComponent.to_jsonszz$,,.))r@c V^8dQhRRRR/#)rOjcalz str | listrPr1r8)rQs"rArRrSsCCZCICr@c  \V\4'd\P!V4p\ W4wr#W#.3.pV'dVP 4wrVp\ V4Fxwr.VO^NVNp \P!V !;_uu_4\ V \V44wrRRR4VPPX 4VPV X V 34Kz KV# +'giLG;i)aCreate a component from a jCal list. Parameters: jcal: jCal list or JSON string according to :rfc:`7265`. Raises: ~error.JCalParsingError: If the jCal provided is invalid. ~json.JSONDecodeError: If the provided string is not valid JSON. This reverses :func:`to_json` and :func:`to_jcal`. The following code parses an example from :rfc:`7265`: .. code-block:: pycon >>> from icalendar import Component >>> jcal = ["vcalendar", ... [ ... ["calscale", {}, "text", "GREGORIAN"], ... ["prodid", {}, "text", "-//Example Inc.//Example Calendar//EN"], ... ["version", {}, "text", "2.0"] ... ], ... [ ... ["vevent", ... [ ... ["dtstamp", {}, "date-time", "2008-02-05T19:12:24Z"], ... ["dtstart", {}, "date", "2008-10-06"], ... ["summary", {}, "text", "Planning meeting"], ... ["uid", {}, "text", "4088E990AD89CB3DBB484909"] ... ], ... [] ... ] ... ] ... ] >>> calendar = Component.from_jcal(jcal) >>> print(calendar.name) VCALENDAR >>> print(calendar.prodid) -//Example Inc.//Example Calendar//EN >>> event = calendar.events[0] >>> print(event.summary) Planning meeting N) rwrYrloads_node_from_jcalr enumeraterreraise_with_path_addedr?rMr) rUrrootroot_subcomponentsrparentrMprefixir child_prefixchildchild_subcomponentss && rA from_jcalComponent.from_jcals\ dC ::d#D $34#= 6:PR5S4T,1IIK )F6#,]#;.A &==|LL1@$d6l2.EM$$++E2 e%8,GH$< MLs C%% C5 c V^8dQhRRRR/#)rOrrrPr.r8)rQs"rArRrSs33d3t3r@c F<V'd \V4#\SV` 4#)aCopy the component. Parameters: recursive: If ``True``, this creates copies of the component, its subcomponents, and all its properties. If ``False``, this only creates a shallow copy of the component. Returns: A copy of the component. Examples: Create a shallow copy of a component: .. code-block:: pycon >>> from icalendar import Event >>> event = Event.new(description="Event to be copied") >>> event_copy = event.copy() >>> str(event_copy.description) 'Event to be copied' Shallow copies lose their subcomponents: .. code-block:: pycon >>> from icalendar import Calendar >>> calendar = Calendar.example() >>> len(calendar.subcomponents) 3 >>> calendar_copy = calendar.copy() >>> len(calendar_copy.subcomponents) 0 A recursive copy also copies all the subcomponents: .. code-block:: pycon >>> full_calendar_copy = calendar.copy(recursive=True) >>> len(full_calendar_copy.subcomponents) 3 >>> full_calendar_copy.events[0] == calendar.events[0] True >>> full_calendar_copy.events[0] is calendar.events[0] False )rrcopy)rrrs&&rArComponent.copysb D> !w|~r@cV^8dQhRR/#rr8)rQs"rArRrSQsr@c R#)zThis component is fully parsed.Fr8rs&rAis_lazyComponent.is_lazyQsr@cV^8dQhRR/#)rOrPr.r8)rQs"rArRrSUstr@c V#)zReturn the fully parsed component. For non-lazy components, this returns self. For lazy components, this parses the component and returns the result. r8rs&rArComponent.parseUs  r@)r_rVrrMr8ro)N)NT)r)TT)F)z[...]r) NNNNNNNNN)Tr9r:r;r<r=rCr>rDrErFrGrHrIr&instancerJrK classmethodrVr\rh staticmethodr}rrrrdrrrrrrrrrrrrrrrrrr+r2rrHrOrrRr~rVpropertyrWsetterdeleterrrkrqrrrryrr{rr}rrzrr|r_ _validate_newrvrrrrrrrr? __classcell__)rs@rAr1r1Csm"&D % %'H!&(&(J#(1$&H!&4%'I"'2ACI>C ).~- -9,A,A,CM)C=A:A"".'' FF#?#?JB((B44lHT(18 &B-  .<($ 8)VXXXX44l33J '+Z6p* Ge:( M422##,, ^^ __F** C H E$J H F! G6M = =..`-^*CCJ33jr@r1c V^8dQhRRRR/#)rO starting_clsrZrPztuple[Component, list]r8)rQs"rArRrR^sL$L$L$\V\4'd\V4^8wd\RWR7hVwr#p\V\4'g\RV^.VR7hVP 4VP 8wd!VPVP 44pMTpV!4p\V\4'g\RV^VR7h\V4EFwrx\P!W^V.R7V^,p V^,p VPPW4p \P!^V4;_uu_4V PV4p RRR4VPPV 4p \V \4'd.V P4RV 39dV P 4X nMR X P"9dV =VP%W4EK \V\4'g\R V^VR7hWd3# +'giL;i) a9Parse a single jCal component without recursing into subcomponents. Module-level helper for :meth:`Component.from_jcal`: it has no ties to a class or instance (the relevant class is passed in as ``starting_cls``), so it is a plain function rather than a (static) method. Parameters: jcal: The jCal list for one component. starting_cls: The class used as the parser for structural validation before the component type is resolved from its name (the entry class for the root, the parent's resolved class for a child). Returns: A ``(component, raw_subcomponents)`` tuple. The raw subcomponents are returned for the caller to walk iteratively. Raises: ~error.JCalParsingError: If this component node is invalid. The path is relative to this node; callers prepend the nesting path. z(A component must be a list with 3 items.r|zThe name must be a string.)pathrkzThe properties must be a list.)rNunknownrz!The subcomponents must be a list.)rwrzrrrYrrCr\rvalidate_propertyrJrrrdefault_value_typerrrr)rrrCrrM component_clsrrprop prop_name prop_valueprop_clsv_prop default_types&& rArr^s* dD ! !SY!^ 6   '+#Dm dC  (,aS   zz||((($88F $ I j$ ' ' ,    Z(**4aVLG !W $1$?$?$L$L %  5 5a ; ;''-F<%22EEiP j# & &:+;+;+=  F , &++-FL  %  i(3)4 mT * * /      ##5< ;s H  H )Dr= __future__rrrr dataclassesrrrrrr pathlibr typingr r r rricalendar.attrrrrrrrrrrricalendar.cal.component_factoryricalendar.caselessdictricalendar.errorrricalendar.parserrrr r!r"icalendar.parser.ical.componentr#icalendar.parser_toolsr$icalendar.propr%r&r'r(r)icalendar.timezoner*icalendar.toolsr,collections.abcr-icalendar.compatibilityr.rr0r1r__all__r8r@rArs*" !>>BB   =/=@3NN"#(,   $X Xv L$^ -r@