\jOZ lddlZddlZddlZddlZddlmZmZddlmZddl m Z dZ dZ ejdZed d hZehd Zehd Zehd ZeddhZehdZeddhZeededhZeed edhZGddeZGddeZGddeZGddeZdedefdZ de!de!de"fdZ#d e!de$fd!Z%d ede!fd"Z&d#ee$e!fde"fd$Z'd%ee$e!fd&e"de"fd'Z(d;d#e!d(e"de"fd)Z)d#e!de"fd*Z*d#e!de"fd+Z+d#e!ddfd,Z,d#e!d-ede"fd.Z-d;d#e!d-ed/e"de"fd0Z.d#ee!e$e/fddfd1Z0d#e!de$fd2Z1d#ee!e$e/fde!fd3Z2dd ee!e$e/fd7e"d8e"d4e"de!f d:Z5y)?N)OptionalUnion)idnadata)intranges_contain sxn--u [.。．｡]RAL>r r AN> r r r BNCSENESETONNSM>r r r rr r>Lr r rrrrrrDceZdZdZy) IDNAErrorz5Base exception for all IDNA-encoding related problemsN__name__ __module__ __qualname____doc__3/root/env/lib/python3.12/site-packages/idna/core.pyrrs?rrceZdZdZy) IDNABidiErrorz;Exception when bidirectional requirements are not satisfiedNrrrrr r !sErr ceZdZdZy)InvalidCodepointz ??rsc$|jdS)Npunycode)encoder4s r _punycoder9>s 88J rcd|dS)NzU+04Xrr8s r_unotr<Bs #w<rlabelct|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``. ?lenr=s rvalid_label_lengthrCFs u: rdomain trailing_dotc*t||rdkSdkS)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``. r@)rDrEs rvalid_string_lengthrIUs v;,3 88C 88r check_ltrcd}t|dD]D\}}tj|}|dk(rtdt |d||t vsCd}F|s|sytj|d}|t vrd}n |dk(rd}ntd t |d d}d }t|dD]\}}tj|}|rH|tvrtd |d |tvrd}n|dk7rd}|tvsO|s|}T||k7sZtd|tvrtd |d|tvrd}|dk7sd}|s tdy)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( bidirectionalr repr_bidi_rtl_categories_bidi_rtl_first_bidi_rtl_allowed_bidi_rtl_valid_ending_bidi_rtl_numeric_bidi_ltr_allowed_bidi_ltr_valid_ending) r=rJ bidi_labelidxr% directionrtl valid_ending number_types r check_bidir^cs"JUA&R--b1 ?"B4;-}]`\a bc c , ,J  i))%(3IO# c 7U }DfghhL!%KUA&%R--b1  11#&RSVRWWp$qrr22# e#$ --""+K"i/+,`aa 11#&RSVRWWp$qrr22# e#$ 7%: NOO rcVtj|dddk(r tdy)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(categoryrrBs rcheck_initial_combinerrbs/E!H%a(C/JKK rc`|dddk(r td|ddk(s|ddk(r tdy ) 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)rrBs rcheck_hyphen_okrhsC QqzTNOO Qx3%)s*CDD rcLtjd||k7r tdy)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( normalizerrBs r check_nfcrls* UE*e3?@@4rposcxt||}|dk(r|dkDr"tt||dz tk(ryd}t|dz ddD]M}t j j t||}|tdk(rA|tvrd}nn|syd}t|dzt|D]O}t j j t||}|tdk(rA|tvrd}|S|S|S|dk(r(|dkDxr!tt||dz tk(Sy) 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 rrTFrgTi ) r1r._virama_combining_classranger joining_typesget_bidi_joiner_l_or_drA_bidi_joiner_r_or_d)r=rmcp_valueoki joining_types rvalid_contextjrzs\5:H6 7'E#'N(;<@WW sQwB' A#11377E!H FLs3x'!44  sQwE + A#11377E!H FLs3x'!44    6Qw[+CcAg,?@D[[[r exceptioncbt||}|dk(rHd|cxkxrt|dz kncxr*t||dz dk(xrt||dzdk(S|dk(r2|t|dz kr t|dkDrt||dzdSy|dk(s|d k(r|dkDrt||dz d Sy|d k(r4|D].}|d k(r t|d st|ds t|ds.yyd|cxkrdkrnntd|D Sd|cxkrdkrnytd|D Sy)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`ic3NK|]}dt|cxkxrdkncyw)Nr1.0r%s r z!valid_contexto..4!BbuB1611B#%rrc3NK|]}dt|cxkxrdkncyw)rrNrrs rrz!valid_contexto..7rr)r1rAr3any)r=rmr{rvr%s rvalid_contextors`5:H63'Ua'kCcAg,?6,IkcRWX[^_X_R`NaekNkk V  Ua CJNeC!Gng6 6 V x61 7eC!Gnh7 7 V  BX~"j)ZJ-G:VXZ_K`    ( #e #BEBBBB ( #e # BEBBBB rc t|ttfr|jd}t |dk(r t dt |ds t dt|t|t|t|D]\}}t|}t|tjdr/t|tjdr7 t||s)t!d t#|d |d zd t%|t|tjdr6t)||rt!dt#|d |d zd t%|t+dt#|d|d zdt%|dt-|y#t&$r/}t d t#|d|d zd t%||d}~wwxYw)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 LabelTrELabel too longPVALIDCONTEXTJzJoiner  not allowed at position r in z%Unknown codepoint adjacent to joiner rMNCONTEXTO Codepoint z of z not allowed) isinstancebytes bytearraydecoderArrIrlrhrbrNr1rrcodepoint_classesrzr$r<rPr,rr"r^)r=rmr%rverrs r check_labelr<s$%%+, W% 5zQ && u4 8()) eE5!U#vRr7 Xx'A'A('K L  x)C)CJ)O P %eS11!%/!22KCRSG9TXY]^cYdXef2x)C)CJ)O P!%-- x 11J3QR7)SWX\]bXcWde#Zh/@ cTUgYVZ[_`e[fZggs#tu u)v,u ;E(O;LMZ]`aZaYbbfgklqgrfst s5F G *GG c |jd}t|t|s td|S#t$rYnwxYwt |t t|z}t|s td|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)r7ulabelrCrUnicodeEncodeErrorr_alabel_prefixr9)r= label_bytess ralabelrus| ll7+ {!+.,- -     9U#33K k *()) s36 AAct|ttfs |jd}n t|}|j }|jtr;|ttd}|s td|jdr'tdt ||jdS |jd}t ||S#t$rt ||cYSwxYw#t$r}td|d}~wwxYw)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 hyphenr6zInvalid A-label)rrrr7rrlower startswithrrArendswithr UnicodeError)r=rrs rrrs eeY/ 0 ,,w/K El ##%Kn-!#n"5"78 ST T    %@A AK !!'**4"":. L-"   L & 4)*34s)C2C,C)(C), D5 DD std3_rules transitionalc ddlm}d}t|D]\}}t|}||dkr|ntj||dfdz }|d} d} t |dk(r|d} | d k(xs| d k(xr| xs| d k(xr | xr| du} | duxr| d k(xs| d k(xr| xs | d k(xr|} | r||z }| r | J|| z }| d k(rt dt|d|dzdt|tjd|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) uts46datarLZNrdVr3r`Irrrrj) rrNr1bisect bisect_leftrAr"r<rPr(rk) rDrrroutputrmchar code_pointuts46rowstatus replacement keep_as_isuse_replacements r uts46_remaprst&% Fv&y TY :+;ZASAST]`jlo_pAqtuAuv!%) x=A "1+K cM fm@L0@ fPSmF~\fXfF~kvz~k~  &T1 cM cfm>J cFcMDbVb   dNF * ** k !F s] "Zj0A/BB[\_bc\c[ddhimntiuhv#wx x7y:   //rstrictuts46c~|rtjdtdt|ts t |d}|r t|||}t|ds td d }g}|r|jd ntj|}|r|d gk(r td |dd k(r|d=d}|D]+} t| }|r|j|"td|r|jddj|}t||s td |S#t t f$r}td|d}~wwxYw)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.rd) stacklevelrzGshould pass a unicode string to the function rather than a byte string.NTrDomain too longF.rL Empty domainrg Empty labelr.)warningswarnDeprecationWarningrstrUnicodeDecodeError TypeErrorrrrIsplit_unicode_dots_rerappendjoin) r4rrrrrrEresultlabelsr=s rr7r7sP8  M   a  pAwA :| 4 qt 4)**L F#QWWS\)9)?)?)BF Vt^'' bzR 2J + 5M MM! M* * +  c &A q, /)** H;#I. peflo o ps DD<+ D77D<c t|ts t|d}|r t ||d}t |ds t dd}g}|r|jdntj|}|r|d gk(r t d |d s|d =d}|D]+}t|}|r|j|"t d |r|jd dj|S#ttf$r}t d|d}~wwxYw) 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-labelNFTrrrrLrrgr) rrrrrrrIrrrrr) r4rrrrrErrr=s rrr:s. a  AAwA :u - qt 4)**L F#QWWS\)9)?)?)BF Vt^'' ": 2J + 5M MM! M* * +  b 88F 1#I. A67S @ As C""D1 C==D)F)TF)FFFF)FFF)6rrer(rtypingrrrLr intrangesrrprcompiler frozensetrRrQrSrTrUrVrWr1rtrurrr r"r$intr.rboolr3rr9r<rCrIr^rbrhrlrzrrrrrrr7rrrrrsB "(2:::;S$K( !23Z["#:;tTl+NO"C;/S3s8 45S3s8 45   I  y  i    @3@@@   SS eE3J/ D  9eSj 1 9 9$ 9GcGdGtGT # $ 34$ASATA3#3C3D3l+#+C+D+T+\6uS%2366r#%>&%UI-.&3&R404040D40UX40r C  S% "#C C  C  C  C  C P 2 S% "#2 2 2 2  2r