i! dZddlZddlZddlmZdeezdeezfdZdeezdeezfdZdeezdeezdzfdZ deezdeezdzfd Z dd ed e dedefdZ dedefdZ dedefdZejdZdeddfdZgdZdS)z-Functions for manipulating strings and bytes.N)DEFAULT_ENCODINGtextreturnc2t|ttfsJ|ddddddddd d dd S) aFormat 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) \N \\\;\;,\, \n isinstancestrbytesreplacers R/root/projects/butler/venv/lib/python3.11/site-packages/icalendar/parser/string.py _escape_charr s0 dS%L ) )))) UD!! v   e   e      u   cXtjdtdt|S)aFormat value according to iCalendar TEXT escaping rules. .. deprecated:: 7.0.0 Use the private :func:`_escape_char` internally. For external use, this function is deprecated. Please use alternative escaping methods or contact the maintainers. 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) zescape_char is deprecated and will be removed in a future version. If you are using this function externally, please contact the maintainers. stacklevel)warningswarnDeprecationWarningrrs r escape_charr!-s9: M U    rc~t|ttfsJt|trz|ddddddddddd d St|trz|d d d dd dddddddSdS)aUnescape 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) rrrrrr r r r r s\Ns\ns  s\,,s\;;s\\\Nrrs r_unescape_charr'Ss , dS%L ) ))))$ LL & & WVT " " WUD ! ! WUC WUC WVT " "  $ LL ( ( WWe $ $ WVU # # WVT " " WVT " " WWe $ $   4rcXtjdtdt|S)aUnescape iCalendar TEXT values. .. deprecated:: 7.0.0 Use the private :func:`_unescape_char` internally. For external use, this function is deprecated. Please use alternative unescaping methods or contact the maintainers. 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) zunescape_char is deprecated and will be removed in a future version. If you are using this function externally, please contact the maintainers.rr)rrr r'rs r unescape_charr)s96 M U  $  rK linelimitfold_sepc ttsJdvsJ d|fdt dt dz DS#t tf$rYnwxYwg}d}D]`}t |t}||z }|kr| ||}| |ad|S)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). rasciic38K|]}||zdz VdS)N).0ir-r,s r zfoldline..sF  ()DQY]" #      rrr2) rrencodejoinrangelenUnicodeEncodeErrorUnicodeDecodeErrorrappend)r,r-r. ret_chars byte_countchar char_byte_lens`` rfoldlinerCsQ dC    t      G}}     -21c$ii-K-K        2 3     IJDKK(899:: m#      X & & &&J 779  sA77B  B valc|ddddddddS) 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: - ``\,`` -> ``%2C`` - ``\:`` -> ``%3A`` - ``\;`` -> ``%3B`` - ``\\`` -> ``%5C`` r%2Cz\:%3Ar %3Br %5CrrDs r escape_stringrLsG. E5!!          rc|ddddddddS) aUnescape 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`` -> ``\`` rFr rG:rHr rIr rJrKs runescape_stringrOsG* E3          rz[\w.-]+namect|}t|dkr||dkrdSt|)a Validate 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. r2rN)NAMEfindallr; ValueError)rPmatchs rvalidate_tokenrVsE LL  E 5zzQ458++ T  r)rr'r!rLrCr)rOrV)r*r+)__doc__rericalendar.parser_toolsrrrrr!r'r)intrCrLrOcompilerRrV__all__r3rrr]s33 333333!sU{!sU{!!!!H#cEk#cEk####L*u*ut);****Z! e ! e d(:! ! ! ! H  3 s 3 S    Fss<<rz*$   r