U /jOZ @sddlZddlZddlZddlZddlmZmZddlmZddl m Z dZ dZ e dZed d hZed d d hZed d d d d dddddh Zed d d d hZed d hZedd d dddddhZedd hZeededhZeed edhZGdddeZGdddeZGdddeZGdddeZeedddZ e!e!e"d d!d"Z#e!e$d#d$d%Z%ee!d#d&d'Z&ee$e!fe"d(d)d*Z'ee$e!fe"e"d+d,d-Z(dNe!e"e"d/d0d1Z)e!e"d(d2d3Z*e!e"d(d4d5Z+e!dd(d6d7Z,e!ee"d8d9d:Z-dOe!ee"e"d;dd?Z0e!e$d(d@dAZ1ee!e$e/fe!d(dBdCZ2dPe!e"e"e!dEdFdGZ3dQee!e$e/fe"e"e"e"e$dHdIdJZ4dRee!e$e/fe"e"e"e!dKdLdMZ5dS)SN)OptionalUnion)idnadata)intranges_contain sxn--u [.。．｡]RALANENESCSETONBNNSMLDc@seZdZdZdS) IDNAErrorz5Base exception for all IDNA-encoding related problemsN__name__ __module__ __qualname____doc__rr-/tmp/pip-unpacked-wheel-zg0be5mg/idna/core.pyrsrc@seZdZdZdS) IDNABidiErrorz;Exception when bidirectional requirements are not satisfiedNrrrrrr!src@seZdZdZdS)InvalidCodepointzsr0cCs d|dS)NzU+Z04Xrr/rrr_unotBsr1)labelr cCs t|dkS)uCheck that a label does not exceed the maximum permitted length. Per :rfc:`1035` (and :rfc:`5891` §4.2.4) a DNS label must not exceed 63 octets. The argument may be either a :class:`str` (a U-label, where length is measured in characters) or :class:`bytes` (an A-label, where length is measured in octets). :param label: The label to check. :returns: ``True`` if the label is within the length limit, otherwise ``False``. ?lenr2rrrvalid_label_lengthFs r7)domain trailing_dotr cCst||rdndkS)aCheck that a full domain name does not exceed the maximum length. Per :rfc:`1035`, a domain name is limited to 253 octets when no trailing dot is present, or 254 octets when one is included. :param domain: The full (possibly multi-label) domain name. :param trailing_dot: ``True`` if ``domain`` includes a trailing ``.``. :returns: ``True`` if the domain is within the length limit, otherwise ``False``. r4)r8r9rrrvalid_string_lengthUs r<F)r2 check_ltrr c Cshd}t|dD]>\}}t|}|dkr@tdt|d||tkrd}q|sZ|sZdSt|d}|tkrvd}n"|dkrd}ntd t|d d}d }t|dD]\}}t|}|r|tkrtd |d |tkrd}n |dkrd}|t krT|s |}n||krTtdq|t kr8td |d|t krHd}q|dkrd}q|sdtddS)a!Validate the Bidi Rule from :rfc:`5893` for a single label. The Bidi Rule constrains how bidirectional characters (Hebrew, Arabic, etc.) may appear within a label. By default the check is only applied when the label contains at least one right-to-left character (Unicode bidirectional categories ``R``, ``AL``, or ``AN``); set ``check_ltr`` to ``True`` to apply it to LTR-only labels as well. :param label: The label to validate, as a Unicode string. :param check_ltr: If ``True``, apply the rules even when the label contains no RTL characters. :returns: ``True`` if the label satisfies the Bidi Rule. :raises IDNABidiError: If any of Bidi Rule conditions 1-6 are violated, or if the directional category of a codepoint cannot be determined. Frz Unknown directionality in label at position TrrzFirst codepoint in label z" must be directionality L, R or ALNz,Invalid direction for codepoint at position z in a right-to-left labelrz2Can not mix numeral types in a right-to-left labelz in a left-to-right labelz0Label ends with illegal codepoint directionality) enumerater! bidirectionalrrepr_bidi_rtl_categories_bidi_rtl_first_bidi_rtl_allowed_bidi_rtl_valid_ending_bidi_rtl_numeric_bidi_ltr_allowed_bidi_ltr_valid_ending) r2r= bidi_labelidxr directionrtl valid_ending number_typerrr check_bidicsP       rPcCs"t|dddkrtddS)u^Reject labels that begin with a combining mark. Per :rfc:`5891` §4.2.3.2 a label must not start with a character of Unicode general category ``M`` (Mark). :param label: The label to check. :returns: ``True`` if the first character is not a combining mark. :raises IDNAError: If the label begins with a combining character. rMz0Label begins with an illegal combining characterT)r!categoryrr6rrrcheck_initial_combiners rScCs<|dddkrtd|ddks0|ddkr8tdd S) uValidate the hyphen restrictions for a label. Per :rfc:`5891` §4.2.3.1 a label must not start or end with a hyphen (``U+002D``), and must not have hyphens in both the third and fourth positions (the prefix reserved for A-labels). :param label: The label to check. :returns: ``True`` if the hyphen restrictions are satisfied. :raises IDNAError: If any of the hyphen restrictions are violated. z--z4Label has disallowed hyphens in 3rd and 4th positionr-z)Label must not start or end with a hyphenT)rr6rrrcheck_hyphen_oks rXcCstd||krtddS)zRequire that a label is in Unicode Normalization Form C. :param label: The label to check. :raises IDNAError: If ``label`` differs from its NFC normalisation. NFCz%Label must be in Normalization Form CN)r! normalizerr6rrr check_nfcsr[)r2posr cCs&t||}|dkr|dkr8tt||dtkr8dSd}t|dddD]@}tt||}|tdkrvqLqL|tkrd}qqLqqL|sdSd}t|dt|D]@}tt||}|tdkrqq|t krd}qqqq|S|dkr|dkott||dtkSdSd S) aValidate the CONTEXTJ rules from :rfc:`5892` Appendix A. These rules govern the contextual use of the joiner codepoints ``U+200C`` (ZERO WIDTH NON-JOINER, Appendix A.1) and ``U+200D`` (ZERO WIDTH JOINER, Appendix A.2) within a label. :param label: The label containing the codepoint. :param pos: Index of the joiner codepoint within ``label``. :returns: ``True`` if the codepoint at ``pos`` satisfies its CONTEXTJ rule, ``False`` otherwise (including when the codepoint at ``pos`` is not a recognised joiner). :raises ValueError: If an adjacent codepoint has no Unicode name when determining its combining class. i rrTFrWTi N) r)r'_virama_combining_classranger joining_typesget_bidi_joiner_l_or_dr5_bidi_joiner_r_or_d)r2r\cp_valueoki joining_typerrrvalid_contextjs8     "rh)r2r\ exceptionr cCsrt||}|dkr\d|ko.t|dknoZt||ddkoZt||ddkS|dkr|t|dkrt|dkrt||ddSdS|dks|d kr|dkrt||dd SdS|d kr|D]6}|d krqt|d st|dst|drdSqdSd|kr&dkr>nntdd|D Sd|krVdkrnnntdd|D SdS)aValidate the CONTEXTO rules from :rfc:`5892` Appendix A. Covers the contextual rules for codepoints such as MIDDLE DOT (``U+00B7``), Greek lower numeral sign, Hebrew punctuation, Katakana middle dot, and the Arabic-Indic / Extended Arabic-Indic digit ranges. :param label: The label containing the codepoint. :param pos: Index of the codepoint within ``label``. :param exception: Reserved for forward compatibility; currently unused. :returns: ``True`` if the codepoint at ``pos`` satisfies its CONTEXTO rule, ``False`` otherwise (including when the codepoint is not a recognised CONTEXTO codepoint). rrliuGreekFiiHebrewi0u・HiraganaKatakanaHanT`icss*|]"}dt|kodknVqdS)Nr).0rrrr 4sz!valid_contexto..rsrtcss*|]"}dt|kodknVqdS)rqrrNrurvrrrrx7s)r)r5r+any)r2r\rirdrrrrvalid_contextos. H "rzc Cst|ttfr|d}t|dkr,tdt|dds@tdt|t|t |t |D](\}}t |}t |t jdrq`q`t |t jdrz4t||std t|d |d d t|WnLtk r}z,td t|d|d d t||W5d}~XYnXq`t |t jdrbt||stdt|d |d d t|q`tdt|d|d dt|dq`t|dS)a8Run the full set of IDNA 2008 validity checks on a single label. Applies, in order: NFC normalisation (:func:`check_nfc`), hyphen restrictions (:func:`check_hyphen_ok`), the no-leading-combiner rule (:func:`check_initial_combiner`), per-codepoint validity (PVALID, CONTEXTJ, CONTEXTO classes from :rfc:`5892`), and the Bidi Rule (:func:`check_bidi`). :param label: The label to validate. ``bytes`` or ``bytearray`` input is decoded as UTF-8 first. :raises IDNAError: If the label is empty or fails a structural rule. :raises InvalidCodepoint: If the label contains a DISALLOWED or UNASSIGNED codepoint. :raises InvalidCodepointContext: If a CONTEXTJ or CONTEXTO codepoint is not valid in its context. :raises IDNABidiError: If the Bidi Rule is violated. zutf-8rz Empty LabelTr9Label too longPVALIDCONTEXTJzJoiner  not allowed at position r in z%Unknown codepoint adjacent to joiner r?NCONTEXTO Codepoint z of z not allowed) isinstancebytes bytearraydecoder5rr<r[rXrSr@r)rrcodepoint_classesrhrr1rBr%rzrrP)r2r\rrderrrrr check_label<s@        *rcCsfz(|d}t|t|s$td|WStk r<YnXt|tt|}t|sbtd|S)uConvert a single U-label into its A-label form. The result is the ASCII-Compatible Encoding (ACE) form per :rfc:`5891` §4: the label is validated, Punycode-encoded, and prefixed with ``xn--``. Pure ASCII labels that are already valid IDNA labels are returned unchanged (as :class:`bytes`). :param label: The label to convert, as a Unicode string. :returns: The A-label as ASCII-encoded :class:`bytes`. :raises IDNAError: If the label is invalid or the resulting A-label exceeds 63 octets. asciir|)r.ulabelr7rUnicodeEncodeErrorr_alabel_prefixr0)r2 label_bytesrrralabelus   rc Cst|ttfs@z|d}WqHtk r<t||YSXnt|}|}|tr|t td}|svt d| drt dnt|| dSz| d}Wn,t k r}zt d|W5d}~XYnXt||S)aConvert a single A-label into its U-label form. Performs the inverse of :func:`alabel`: an ``xn--``-prefixed label is Punycode-decoded and validated. Labels that are already Unicode (or plain ASCII without the ACE prefix) are validated and returned as a Unicode string. :param label: The label to convert. ``bytes`` or ``bytearray`` input is treated as ASCII. :returns: The U-label as a Unicode string. :raises IDNAError: If the label is malformed or fails validation. rNz5Malformed A-label, no Punycode eligible content found-z"A-label must not end with a hyphenr-zInvalid A-label)rrrr.rrlower startswithrr5rendswithr UnicodeError)r2rrrrrrs,      rT)r8 std3_rules transitionalr c Cs,ddlm}d}t|D]\}}t|}||dkr8|nt||dfd}|d} d} t|dkrn|d} | d kp| d kr| p| d ko| o| dk} | dk o| d kp| d kr| p| d ko|} | r||7}q| r| dk st|| 7}q| d krqqtdt|d|ddt |qt d|S)uApply the UTS #46 character mapping to a domain string. Implements the mapping table from `UTS #46 §4 `_: each character is kept, replaced, or rejected based on its status (``V``, ``M``, ``D``, ``3``, ``I``). The result is returned in Normalisation Form C. :param domain: The full domain name to remap. :param std3_rules: If ``True``, apply the stricter STD3 ASCII rules (status ``3`` codepoints raise instead of being kept or mapped). :param transitional: If ``True``, use transitional processing (status ``D`` codepoints are mapped instead of kept). Transitional processing has been removed from UTS #46 and this option is retained only for backwards compatibility. :returns: The remapped domain, in Normalisation Form C. :raises InvalidCodepoint: If the domain contains a disallowed codepoint under the chosen rules. r) uts46datar>ZNrTVr3rQIrrrrY) rr@r)bisect bisect_leftr5AssertionErrorrr1rBr!rZ) r8rrroutputr\char code_pointuts46rowstatus replacementZ keep_as_isZuse_replacementrrr uts46_remaps. $ *    (r)r,strictuts46rrr c Cs*|rtjdtddt|ts^zt|d}Wn0ttfk r\}ztd|W5d}~XYnX|rnt|||}t |ddstd d }g}|r| d nt |}|r|d gkrtd |dd kr|d=d}|D]$} t | }|r| |qtdq|r| dd|}t ||s&td |S)aAEncode a Unicode domain name into its ASCII (A-label) form. Splits the input on label separators (only ``U+002E`` if ``strict`` is set; otherwise also IDEOGRAPHIC FULL STOP ``U+3002``, FULLWIDTH FULL STOP ``U+FF0E``, and HALFWIDTH IDEOGRAPHIC FULL STOP ``U+FF61``), encodes each label with :func:`alabel`, and rejoins them with ``.``. Optionally pre-processes the input through :func:`uts46_remap`. :param s: The domain name to encode. :param strict: If ``True``, only ``U+002E`` is recognised as a label separator. :param uts46: If ``True``, apply UTS #46 mapping before encoding. :param std3_rules: Forwarded to :func:`uts46_remap` when ``uts46`` is ``True``. :param transitional: Forwarded to :func:`uts46_remap` when ``uts46`` is ``True``. Deprecated: emits a :class:`DeprecationWarning` and will be removed in a future version. :returns: The encoded domain as ASCII :class:`bytes`. :raises IDNAError: If the domain is empty, contains an invalid label, or exceeds the maximum domain length. zuTransitional processing has been removed from UTS #46. The transitional argument will be removed in a future version.rT) stacklevelrzGshould pass a unicode string to the function rather than a byte string.NTr{Domain too longF.r> Empty domainrW Empty label.)warningswarnDeprecationWarningrstrUnicodeDecodeError TypeErrorrrr<split_unicode_dots_rerappendjoin) r,rrrrrr9resultlabelsr2rrrr.sD         r.)r,rrrr c Cst|tsJzt|d}Wn0ttfk rH}ztd|W5d}~XYnX|rZt||d}t|ddsntdd}g}|r|dnt|}|r|d gkrtd |d s|d =d}|D]$}t |}|r| |qtd q|r| d d |S) aDecode an A-label-encoded domain name back to Unicode. Splits the input on label separators (see :func:`encode` for the rules), decodes each label with :func:`ulabel`, and rejoins them with ``.``. Optionally pre-processes the input through :func:`uts46_remap`. :param s: The domain name to decode. :param strict: If ``True``, only ``U+002E`` is recognised as a label separator. :param uts46: If ``True``, apply UTS #46 mapping before decoding. :param std3_rules: Forwarded to :func:`uts46_remap` when ``uts46`` is ``True``. :returns: The decoded domain as a Unicode string. :raises IDNAError: If the input is not valid ASCII, contains an invalid label, or is empty. rzInvalid ASCII in A-labelNFTr{rrr>rrWr) rrrrrrr<rrrrr) r,rrrrr9rrr2rrrr:s2      r)F)F)TF)FFFF)FFF)6rrer!rtypingrrr>r intrangesrr^rcompiler frozensetrDrCrErFrGrHrIr)rbrcrrrrrintr'rboolr+rr0r1r7r<rPrSrXr[rhrzrrrrrr.rrrrrsx      J 6.9)9  H