o .j& @sdZddlZddlZddlmZmZdeeBdefddZdeeBdefdd Z deeBdeeBdBfd d Z deeBdeeBdBfd d Z d#dede dedefddZ dedefddZdedefddZdedefddZdedefddZedZdeddfd d!Zgd"ZdS)$z-Functions for manipulating strings and bytes.N)DEFAULT_ENCODING to_unicodetextreturncCsNt|ttfs Jt|}|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) isinstancestrbytesrreplacerrL/home/thesage/.local/lib/python3.10/site-packages/icalendar/parser/string.py _escape_char s rcCtjdtddt|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)warningswarnDeprecationWarningrrrrr escape_char.s rcCst|ttfs Jt|tr(|ddddddddddd d St|trG|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) rrrrr r r r r rs\Ns\ns  s\,,s\;;s\\\N)rrrrrrrr_unescape_charTs$    r$cCr)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)rrrr$rrrr unescape_chars r%K linelimitfold_sepc sttsJdvs JzdWn ttfyYnw|fddtdtdDSg}d}D]}t|t}||7}|krS| ||}| |q;d|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). rasciic3s$|] }||dVqdS)Nr).0ir)r(rr s zfoldline..rr,) rrencodeUnicodeEncodeErrorUnicodeDecodeErrorjoinrangelenrappend)r(r)r* ret_chars byte_countchar char_byte_lenrr/rfoldlines(    r=valcC$|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 %5Crr>rrr_escape_strings rFcCr)zEscape backslash sequences to URL-encoded hex values. .. deprecated:: 7.0.0 Use the private :func:`_escape_string` internally. For external use, this function is deprecated. zescape_string is deprecated and will be removed in icalendar 8. If you are using this function externally, please contact the maintainers.rr)rrrrFrErrr escape_string rGcCr?) 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`` -> ``\`` r@r rA:rBr rCrrDrErrr_unescape_strings rJcCr)zUnescape URL-encoded hex values to their original characters. .. deprecated:: 7.0.0 Use the private :func:`_unescape_string` internally. For external use, this function is deprecated. zunescape_string is deprecated and will be removed in icalendar 8. If you are using this function externally, please contact the maintainers.rr)rrrrJrErrrunescape_stringrHrKz[\w.-]+namecCs.t|}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. r,rN)NAMEfindallr7 ValueError)rLmatchrrrvalidate_token's rQ) rrFr$rJrrGr=r%rKrQ)r&r')__doc__rericalendar.parser_toolsrrrrrrr$r%intr=rFrGrJrKcompilerMrQ__all__rrrrs %&-$#