+ j"H*Rt^RIHt^RIt^RIt^RIt^RIHtHt^RIH t H t H t ^RI H t ^RIHt^RIHt^RIHtHt^R IHt] 'd^R IHtHt^R IHt^R IHt!R R] 4tR&RRllt]P@!R4t!]P@!R4t"R'RRllt#]P@!R4t$R&RRllt%R(RRllt&R)RRllt'R*RRllt(!RR] 4t)]P@!R 4t*R!R"lt+]P@!R#4t,R$R%lt-.R+Ot.R#),z!Functions for parsing parameters.) annotationsN)datetimetime) TYPE_CHECKINGAnyProtocol) CaselessDict)JCalParsingError)validate_token)DEFAULT_ENCODINGSEQUENCE_TYPES) tzid_from_dt)CallableSequence)VALUE) VPROPERTYc&]tRt^tRtRRltRtR#) HasToIcalz+Protocol for objects with a to_ical method.cV^8dQhRR/#)returnbytes)formats"Y/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/parser/parameter.py __annotate__HasToIcal.__annotate__s   c R#)zConvert to iCalendar format.Nrselfs&rto_icalHasToIcal.to_icals rrN)__name__ __module__ __qualname____firstlineno____doc__r!__static_attributes__rrrrrs5  rrc$V^8dQhRRRRRR/#)rvaluezSequence[str] | str | HasToIcal always_quoteboolrstrr)rs"rrr#s)MM *M:>MMrc&\V\4'd\\\V4VR7#\V\ 4'd\ \ V4VR7#\ \ VP4P\444#)aConvert a parameter value to its iCalendar representation. Applies :rfc:`6868` escaping and optionally quotes the value according to :rfc:`5545` parameter value formatting rules. Parameters: value: The parameter value to convert. Can be a sequence, string, or object with a ``to_ical()`` method. always_quote: If ``True``, always enclose the value in double quotes. Defaults to ``False`` (only quote when necessary). Returns: The formatted parameter value, escaped and quoted as needed. r+) isinstancer q_joinmaprfc_6868_escaper-dquoter!decoder )r*r+s&&r param_valuer6#sf"%((c/51 MM%oe,<HH /%--/"8"89I"JK LLrz [- -",:;]z [- -"]c$V^8dQhRRRRRR/#)rr*r-quotedr,rNoner)rs"rrrBs!   T T rcrV'd\M\pVPV4'd \V4hR#)aValidate a parameter value for unsafe characters. Checks parameter values for characters that are not allowed according to :rfc:`5545`. Uses different validation rules for quoted and unquoted values. Parameters: value: The parameter value to validate. quoted: If ``True``, validate as a quoted value (allows more characters). If ``False``, validate as an unquoted value (stricter). Defaults to ``True``. Raises: ValueError: If the value contains unsafe characters for its quote state. N) QUNSAFE_CHAR UNSAFE_CHARfindall ValueError)r*r8 validators&& rvalidate_param_valuer@Bs.!' KI ru[,;:’]c$V^8dQhRRRRRR/#)rvalr-r+r,rr)rs"rrr!4Crc|VPRR4p\PV4'g V'dRV R2#V#)a;Enclose parameter values in double quotes when needed. Parameter values containing special characters ``,``, ``;``, ``:`` or ``'`` must be enclosed in double quotes according to :rfc:`5545`. Double-quote characters in the value are replaced with single quotes since they're forbidden in parameter values. Parameters: val: The parameter value to quote. always_quote: If ``True``, always enclose in quotes regardless of content. Defaults to ``False`` (only quote when necessary). Returns: The value, enclosed in double quotes if needed or requested. "')replaceQUOTABLEsearch)rBr+s&&rr4r4[s8& ++c3 Cs|3%qz Jrc(V^8dQhRRRRRRRR/#)rstr-sepmaxsplitintrz list[str]r)rs"rrrus(---#-s-I-rc>V^8XdV.#.p^p\V4p^p^p\V4FpwrV R8XdV'*pV'g,W8Xd&VPWV4V^,pV^, pV^,V8Xg Wr8XgK\VPWR4V# V#)aSplit a string on a separator, respecting double quotes. Splits the string on the separator character, but ignores separators that appear inside double-quoted sections. This is needed for parsing parameter values that may contain quoted strings. Parameters: st: The string to split. sep: The separator character. Defaults to ``,``. maxsplit: Maximum number of splits to perform. If ``-1`` (default), then perform all possible splits. Returns: The split string parts. Examples: .. code-block:: pycon >>> from icalendar.parser import q_split >>> q_split('a,b,c') ['a', 'b', 'c'] >>> q_split('a,"b,c",d') ['a', '"b,c"', 'd'] >>> q_split('a;b;c', sep=';') ['a', 'b', 'c'] rDN)len enumerateappend) rJrKrLresultcursorlengthinquotesplitsichs &&& rq_splitrYus61}t F F WFG F2 9!kG29 MM"A, 'UF aKF q5F?f0 MM"W+ &  M Mrc(V^8dQhRRRRRRRR/#)rlstz Sequence[str]rKr-r+r,rr)rs"rrrs.KK KCKTKcKrc:aVPV3RlV44#)aJoin a list with a separator, quoting items as needed. Joins list items with the separator, applying :func:`dquote` to each item to add double quotes when they contain special characters. Parameters: lst: The list of items to join. sep: The separator to use. Defaults to ``,``. always_quote: If ``True``, always quote all items. Defaults to ``False`` (only quote when necessary). Returns: The joined string with items quoted as needed. Examples: .. code-block:: pycon >>> from icalendar.parser import q_join >>> q_join(['a', 'b', 'c']) 'a,b,c' >>> q_join(['plain', 'has,comma']) 'plain,"has,comma"' c3><"TFp\VSR7xK R#5i)r/N)r4).0itmr+s& r q_join..sJcsF3\::cs)join)r[rKr+s&&frr1r1s0 88JcJ JJrcV^8dQhRR/#)rfunczCallable | Noner)rs"rrrs((/(rc,aV3RlpVfV#V!V4#)aCreate a parameter getter/setter for a single string parameter. Parameters: upper: Convert the value to uppercase func: The function to decorate. Returns: The property for the parameter or a decorator for the parameter if func is ``None``. c<aaVPo\P!V4RVV3Rll4pRVVV3RllpRV3Rllo\WSVPR7#)cV^8dQhRR/#rr Parametersr)rs"rr@single_string_parameter..decorator..__annotate__s  z rcb<VPS4pVeS'dVP4pV#)zGet the value.)getupper)r r*namerms& rfget8single_string_parameter..decorator..fgets*HHTNE U Lrc V^8dQhRRRR/#)rr rir* str | Noner)rs"rrrjs # #z #* #rc\<Vf S!V4R#S'dVP4pWS&R#)z Set the valueNrm)r r*fdelrnrms&&rfset8single_string_parameter..decorator..fsets$}T !KKME"T rcV^8dQhRR/#rhr)rs"rrrjs ! !z !rc,<VPSR4R#)zDelete the value.N)pop)r rns&rru8single_string_parameter..decorator..fdels HHT4 r)doc)r# functoolswrapspropertyr')rdrorvrurnrms& @@r decorator*single_string_parameter..decoratorsU}}       # # ! !Ddll;;rr)rdrmrs&f rsingle_string_parameterrs<4 | T?rca]tRt^tRtRV3RlltRtRR/tRtRRR llt ] RR l4t ] !RR 7R R l4t RRltRRRllt] RRl4tRRltRRlt] RRl4t] RRl4tRtV;t#) riaParser and generator of Property parameter strings. It knows nothing of datatypes. Its main concern is textual structure. Examples: Modify parameters: .. code-block:: pycon >>> from icalendar import Parameters >>> params = Parameters() >>> params['VALUE'] = 'TEXT' >>> params.value 'TEXT' >>> params Parameters({'VALUE': 'TEXT'}) Create new parameters: .. code-block:: pycon >>> params = Parameters(value="BINARY") >>> params.value 'BINARY' Set a default: .. code-block:: pycon >>> params = Parameters(value="BINARY", default_value="TEXT") >>> params Parameters({'VALUE': 'BINARY'}) c$V^8dQhRRRRRR/#)rargsrkwargsrr9r)rs"rrParameters.__annotate__s! ( (c (S (T (rc <V'dV^,f VR,p\VP44Uu/uFCpVP4PR4'gK*VR,VP V4bKE pp\ SV`!V/VBVP4Fwr5VPW54K R#uupi)zCreate new parameters.N:NNdefault_:NN) listkeyslower startswithrzsuper__init__items setdefault)r rrkeydefaultsr* __class__s&*, rrParameters.__init__s DGO8DFKKM* *yy{%%j1 %CGVZZ_ $*  $)&)"..*JC OOC '+  s 'C%CCNz 'c "VP4#)z`In RFC 5545 keys are called parameters, so this is to be consitent with the naming conventions. )rrs&rparamsParameters.params3syy{rTcV^8dQhRR/#)rsortedr,r)rs"rrr9s!!d!rc a .p\VP44pV'dVP4VEFwpo VR8Xd S R8XdKVP4pVPP VP44pWPP 9;'gET;'d;\;QJdV 3RlV4F 'gK RM RM!V 3RlV44p\S VR7p\V\4'dVP\4pVPVP\4R,V,4EK RPV4#) zReturns an :rfc:`5545` representation of the parameters. Parameters: sorted (bool): Sort the parameters before encoding. exclude_utc (bool): Exclude TZID if it is set to ``"UTC"`` TZIDUTCc3,<"TF qS9xK R#5iNr)r^cr*s& rr`%Parameters.to_ical..NsG,FqU ,FsTFr/=;)rrsortrm quote_alsorl always_quotedanyr6r0r-encoder rQrb) r rrRrr upper_keycheck_quoteable_charactersr+ quoted_valuer*s && @rr!Parameters.to_ical9sTZZ\"  JJLJCf}% I)-)<)) clsrJstrictrRparamrrBvalsvv2excs &&& r from_icalParameters.from_icalWs- R%E "5#:s# c*A||C((QZZ__WWS\,R= $5b$9:,Qu=! KK(9!'')(DE KK(9!(<=+"%3KY!^"&q'FK"&3K/&8   iA#G s1AE3BEEE7E E$ EE$rtcV^8dQhRR/#)rrzVALUE | str | Noner)rs"rrr|s  ) rc R#)aThe VALUE parameter from :rfc:`5545`. Description: This parameter specifies the value type and format of the property value. The property values MUST be of a single value type. For example, a "RDATE" property cannot have a combination of DATE-TIME and TIME value types. If the property's value is the default value type, then this parameter need not be specified. However, if the property's default value type is overridden by some other allowable value type, then this parameter MUST be specified. Applications MUST preserve the value data for x-name and iana- token values that they don't recognize without attempting to interpret or parse the value data. For convenience, using this property, the value will be converted to an uppercase string. .. code-block:: pycon >>> from icalendar import Parameters >>> params = Parameters() >>> params.value = "unknown" >>> params Parameters({'VALUE': 'UNKNOWN'}) Nrrs&rr*Parameters.value{rc V^8dQhRRRR/#)rr*zstr | float | list | VPROPERTYrz7str | int | float | list[str] | list[int] | list[float]r)rs"rrrs  3 @ rc \V\4'd!VUu.uFq PV4NK up#\VR4'd3VP 4p\ V4^8Xd V^,#VR,#\ \\3Fp\W4'gKV!V4u# \R\V4 RV: 24huupi)zConvert a parameter value to jCal format. Parameters: value: The parameter value Returns: The jCal representation of the parameter value to_jcal:NNz6Unsupported parameter value type for jCal conversion:  ) r0r_parameter_value_to_jcalhasattrrrOrMfloatr- TypeErrortype)r r*rjcalts&& rr#Parameters._parameter_value_to_jcals eT " ">CDe11!4eD D 5) $ $==?D4yA~Aw8Ouc"A%##x# DE{m1UI '  EsC cV^8dQhRR/#)rrzdict[str, str]r)rs"rrrs  N rc VP4UUu/uF<wr#VP4R8wgKVP4VPV4bK> pppV'dVPR4R8XdVRV#uuppi)zReturn the jCal representation of the parameters. Parameters: exclude_utc (bool): Exclude the TZID parameter if it is UTC r*tzidr)rrrrl)r exclude_utckrrs&& rrParameters.to_jcalsx  $wwyG# 8AGGIt44Q7 7$  488F+u4V   s A<$A<cV^8dQhRR/#)rrrrr)rs"rrrs33j3rc R#)z$The TZID parameter from :rfc:`5545`.Nrrs&rrParameters.tzidrrcV^8dQhRR/#)rrr,r)rs"rrrs"""rc VPR8H#)z"Whether the TZID parameter is UTC.rrrs&ris_utcParameters.is_utcsyyE!!rc V^8dQhRRRR/#)rdtzdatetime | time | Anyrr9r)rs"rrrs ! !#8 !T !rc v\V\\34'd\V4pVR8wd W nR#R#R#)zUpdate the TZID parameter from a datetime object. This sets the TZID parameter or deletes it according to the datetime. :rfc:`5545#section-3.2.19` prohibits TZID on UTC datetimes, which use the ``Z`` suffix instead. rN)r0rrr r)r rrs&& rupdate_tzid_fromParameters.update_tzid_froms6 b8T* + +#Du}  ,rcV^8dQhRR/#)rrzdict[str:str | list[str]]r)rs"rrrs8rc \V\4'g \RV4hVP4Fwr#\V\4'g\RWR7h\P !VRV4\V\ 4'dE\;QJdRV4F 'dK RM RM !RV44'd V'dK\V\\\34'dK\RVVVR7h V!V4#) zParse jCal parameters.z!The parameters must be a mapping.z$All parameter names must be strings.)r*zparameter namec3X"TF p\V\\\34xK" R#5ir)r0r-rMr)r^rs& rr`'Parameters.from_jcal..s!LeJq3U*;< 8 33" !6rriz \^\^|\^n|\^'c V^8dQhRRRR/#rr6r-rr)rs"rrrs33rcdaRRR\PRR/o\PV3RlV4#)zvTake care of :rfc:`6868` unescaping. - ^^ -> ^ - ^n -> system specific newline - ^' -> " - ^ with others stay intact ^^^^n^'rDcd<SPVP^4VP^44#rlgroupm replacementss&r#rfc_6868_unescape..",""1771:qwwqz:r)oslinesepRFC_6868_UNESCAPE_REGEXsubr6r s&@rrrs9 c bjj cL # & &:K rz\^|\r\n|\r|\n|"c V^8dQhRRRR/#rr)rs"rrr$src PaRRRRRRRRRR/o\PV3R lV4#) zHTake care of :rfc:`6868` escaping. - ^ -> ^^ - " -> ^' - newline -> ^n rr r z rDrcd<SPVP^4VP^44#rrrs&rr !rfc_6868_escape..3r r)RFC_6868_ESCAPE_REGEXrrs&@rr3r3$s? T d d T L ! $ $:K rrr)r)rF)NF)rir4r6r1rYr3rr@)/r' __future__rr}rrerrtypingrrricalendar.caselessdictricalendar.errorr icalendar.parser.stringr icalendar.parser_toolsr r icalendar.timezone.tzidr collections.abcrricalendar.enumsricalendar.proprrr6compiler<r;r@rGr4rYr1rrirrrr3__all__rrrr(s'" #///,212%(  M6jj78 zz56  , ::j !4-`K6(V^^B **_5$ #56& r