+ j"Rt^RIt^RIHt^RIHtHtRRlt]!]4tRRlt ]!] 4t RRR llt ]!] 4t R R lt ]!] 4tR R lt]!]4t]P"!R4tRRlt.ROtR#)z-Functions for manipulating strings and bytes.N)deprecate_for_version_8)DEFAULT_ENCODING to_unicodecFV^8dQhR\\,R\/#)textreturnstrbytes)formats"V/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/parser/string.py __annotate__r s**sU{*s*c8\V\\34'gQh\V4pVP RR4P RR4P RR4P RR4P R R 4P RR 4P R R 4#) aKFormat value according to iCalendar TEXT escaping rules. Escapes special characters in text values according to :rfc:`5545#section-3.3.11` rules. The order of replacements matters to avoid double-escaping. Parameters: text: The text to escape. Returns: The escaped text with special characters escaped. Note: The replacement order is critical: 1. ``\N`` -> ``\n`` (normalize newlines to lowercase) 2. ``\`` -> ``\\`` (escape backslashes) 3. ``;`` -> ``\;`` (escape semicolons) 4. ``,`` -> ``\,`` (escape commas) 5. ``\r\n`` -> ``\n`` (normalize line endings) 6. ``"\n"`` -> ``r"\n"`` (transform a newline character to a literal, or raw, newline character) 7. ``"\r"`` -> ``r"\n"`` (transform a lone carriage return to a literal newline character) Steps 5 to 7 normalize ``\r\n``, ``\n``, or a lone ``\r`` to ``\n``. The line-ending normalization is an implementation convenience, not part of :rfc:`5545`, which only defines ``\n`` or ``\N`` for an intentional line break, and doesn't give an escape form for a lone ``\r``. \N \\\;\;,\, \n ) isinstancer r rreplacers&r _escape_charr s> dS%L ) )) ) d D UD! v  e  e    u  u rcjV^8dQhR\\,R\\,R,/#)rrrNr )r s"r rr@s'**u*ut);*rc"\V\\34'gQh\V\4'dcVPRR4PRR4PRR4PRR4PRR4PR R 4#\V\4'dcVPR R 4PR R4PR R4PRR4PRR4PRR4#R#)axUnescape iCalendar TEXT values. Reverses the escaping applied by :func:`_escape_char` according to :rfc:`5545#section-3.3.11` TEXT escaping rules. Parameters: text: The escaped text. Returns: The unescaped text, or ``None`` if ``text`` is neither ``str`` nor ``bytes``. Note: The replacement order is critical to avoid double-unescaping: 1. ``\N`` -> ``\n`` (intermediate step) 2. ``\r\n`` -> ``\n`` (normalize line endings) 3. ``\n`` -> newline (unescape newlines) 4. ``\,`` -> ``,`` (unescape commas) 5. ``\;`` -> ``;`` (unescape semicolons) 6. ``\\`` -> ``\`` (unescape backslashes last) rrrrrrrrrrs\Ns\ns  s\,,s\;;s\\\N)rr r rrs&r _unescape_charr&@s, dS%L ) )) )$ LL & WVT " WUD ! WUC WUC WVT "  $ LL ( WWe $ WVU # WVT " WVT " WWe $   rcHV^8dQhR\R\R\R\/#)rlinelimitfold_sepr)r int)r s"r rrws(%'%'C%'%'C%'c%'rc\V\4'gQhRV9gQh.p.p^pVFp\VP\44pV'dWW,V8d\V4^8daVR,R9dSVP 4pVP RPV44V.p\VP\44pM$VP RPV44.p^pVP V4WW, pK V'd!VP RPV44VPV4#)aMake a string folded as defined in RFC5545. Lines of text SHOULD NOT be longer than 75 octets, excluding the line break. Long content lines SHOULD be split into a multiple line representations using a line "folding" technique. That is, a long line can be split between any two characters by inserting a CRLF immediately followed by a single linear white-space character (i.e., SPACE or HTAB). rz\^)rr lenencoderpopappendjoin) r(r)r* folded_lines current_chars byte_countchar char_byte_lenescaped_prefixs &&& r _foldliner:ws dC  t   L!MJDKK(89: Z75@=!A%-*;u*D!.!2!2!4##BGGM$:;!/ 0  !6!67G!HI ##BGGM$:; "  T"# !$BGGM23 == &&rc0V^8dQhR\R\/#rvalrr )r s"r rrs!!!!rcVPRR4PRR4PRR4PRR4PR R 4#) aEscape backslash sequences to URL-encoded hex values. Converts backslash-escaped characters to their percent-encoded hex equivalents. This is used for parameter parsing to preserve escaped characters during processing. Parameters: val: The string with backslash escapes. Returns: The string with backslash escapes converted to percent encoding. Note: Conversions: - ``%`` -> ``%25`` - ``\,`` -> ``%2C`` - ``\:`` -> ``%3A`` - ``\;`` -> ``%3B`` - ``\\`` -> ``%5C`` A literal ``%`` is escaped first so that percent sequences already in the value (e.g. ``%2C`` in a URI) are not confused with the markers introduced here. :func:`_unescape_string` reverses it. %%25r%2Cz\:%3Ar%3Br%5Crr=s&r _escape_stringrHsG8 C         rc0V^8dQhR\R\/#r<r>)r s"r rrs##rcVPRR4PRR4PRR4PRR4PR R 4#) aoUnescape URL-encoded hex values to their original characters. Reverses :func:`_escape_string` by converting percent-encoded hex values back to their original characters. This is used for parameter parsing. Parameters: val: The string with percent-encoded values. Returns: The string with percent encoding converted to characters. Note: Conversions: - ``%2C`` -> ``,`` - ``%3A`` -> ``:`` - ``%3B`` -> ``;`` - ``%5C`` -> ``\`` - ``%25`` -> ``%`` ``%25`` is restored last so a literal ``%`` that :func:`_escape_string` protected does not re-trigger the marker replacements above. rBrrC:rDrrErrAr@rFrGs&r _unescape_stringrLsG2 E3         rz[\w.-]+c(V^8dQhR\RR/#)rnamerNr>)r s"r rrsrc\PV4p\V4^8XdW^,8XdR#\V4h)aValidate that a name is a valid iCalendar token. Checks if the name matches the :rfc:`5545` token syntax using the NAME regex pattern (``[\w.-]+``). Parameters: name: The token name to validate. Raises: ValueError: If the name is not a valid token. N)NAMEfindallr/ ValueError)rNmatchs& r validate_tokenrTs4 LL E 5zQ48+ T r)Kz ) rrHr:r&rL escape_char escape_stringfoldline unescape_charunescape_stringrT)__doc__reicalendar.compatibilityricalendar.parser_toolsrrrrVr&rYr:rXrHrWrLrZcompilerPrT__all__rr rbs3 ;?*Z&l3 *Z(7 %'P #9 -!H(7 B**:; zz*$ r