zSrSSKJr SSKrSSKrSSKrSSKrSSKrSr SSK r SSK r SSKJrJrJrJrJr \R(rSrSrS rS rS r"S S\ R8R:5r"SS\ R8R:5r"SS\ R8R@5r!"SS\ R8R@5r""SS\ R8RF5r$"SS\ R8R@5r%"SS\ R8R:5r&"SS\ R8RF5r'"SS\ R8RF5r("SS \ R8RF5r)"S!S"\ R8RF5r*"S#S$\+5r,"S%S&\,5r-"S'S(\,5r.\/"S)5r0\-"S5r1\-"S5r2\1r3\."SSSS5r4\."SSSS5r5\."SSSS5r6\."SSSS5r7\4r8S3S*jr9S+r:S,r;"S-S.\+5r<\<"S//5r=\<"/5r>\=S4S0jr?\=S4S1jr@S2rAg!\ a Sr GN/f=f!\a" SS\R,"S 5--S -S- rGN7f=f)4z DNS Names. )BytesIONTF)long binary_type text_typeunichr maybe_decodePc\rSrSrSrSrg) EmptyLabel9zA DNS label is empty.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__rlib/third_party/dns/name.pyrr9srrc\rSrSrSrSrg) BadEscape=z8An escaped code in a text format of DNS name is invalid.rNrrrrrr=sBrrc\rSrSrSrSrg) BadPointerAz=A DNS compression pointer points forward instead of backward.rNrrrrr r AsGrr c\rSrSrSrSrg) BadLabelTypeEz2The label type in DNS name wire format is unknown.rNrrrrr#r#Es 255 octets long.rNrrrrr)r)N*rr)c\rSrSrSrSrg) LabelTooLongRz A DNS label is > 63 octets long.rNrrrrr-r-Rr+rr-c\rSrSrSrSrg)AbsoluteConcatenationVzYAn attempt was made to append anything other than the empty name to an absolute DNS name.rNrrrrr0r0Vs+rr0c\rSrSrSrSrg)NoParent[zIAn attempt was made to get the parent of the root name or the empty name.rNrrrrr3r3[srr3c\rSrSrSrSrg) NoIDNA2008_zHIDNA 2008 processing was requested but the idna module is not available.rNrrrrr6r6_srr6c"\rSrSrSrS1rSrSrg) IDNAExceptiondz$IDNA processing raised an exception.idna_exceptionz+IDNA processing exception: {idna_exception}rN)rrrrr supp_kwargsfmtrrrrr9r9ds.#$K 7Crr9c*\rSrSrSrSrSrSrSrg) IDNACodeckz.Abstract base class for IDNA encoder/decoders.cgNrselfs r__init__IDNACodec.__init__ns rc[erB)NotImplementedErrorrDlabels rencodeIDNACodec.encodeqs!!rcUR5nURS5(aUSSRS5nO [ U5n[ US5$![an[ US9eSnAff=f)Nsxn--rpunycoder;T)lower startswithdecode Exceptionr9r _escapify)rDrJ downcasedes rrRIDNACodec.decodetsoKKM    ( ( 6!!" ,,Z8!'E%%  6#155 6sA A, A''A,rN) rrrrrrErKrRrrrrr?r?ks8 " &rr?cB^\rSrSrSrSU4SjjrSrU4SjrSrU=r $) IDNA2003CodeczIDNA 2003 encoder/decoder.c6>[[U] 5 Xlg)zInitialize the IDNA 2003 encoder/decoder. *strict_decode* is a ``bool``. If `True`, then IDNA2003 checking is done when decoding. This can cause failures if the name was encoded with IDNA2008. The default is `False`. N)superrYrE strict_decode)rDr] __class__s rrEIDNA2003Codec.__init__s mT+-*rcxUS:Xag[RRU5$![a [ef=f)zEncode *label*.r) encodingsidnaToASCII UnicodeErrorr-rIs rrKIDNA2003Codec.encodes= B; >>))%0 0   s(9c>UR(d[[U]U5$US:Xag[ [ R RU5S5$![an[US9eSnAff=f)zDecode *label*.rraTrON) r]r\rYrRrTrbrc ToUnicoderSr9rDrJrVr^s rrRIDNA2003Codec.decodesd!!4U; ; C< 2Y^^55e[[U] 5 XlX lX0lX@lg)z)Initialize the IDNA 2008 encoder/decoder.N)r\rorEuts_46 transitionalallow_pure_asciir])rDrrrsrtr]r^s rrEIDNA2008Codec.__init__s) mT+- ( 0*rc8UHn[U5S:dM g g)NFT)ord)rDrJcs r is_all_asciiIDNA2008Codec.is_all_asciisA1v}rcUS:XagUR(a'URU5(aURS5$[(d[eUR (a"[ R"USUR5n[ R"U5$![ Ran[US9eSnAff=f)NrarasciiFrO) rtrzrKhave_idna_2008r6rrrc uts46_remaprsalabel IDNAErrorr9)rDrJrVs rrKIDNA2008Codec.encodes B;  T%6%6u%=%=<<( (~  2{{((t7H7HI;;u% %~~ 2q1 1 2sABB=/ B88B=cZ>UR(d[[U]U5$US:Xag[(d[ eUR (a[R"USS5n[[R"U5S5$![Ran[US9eSnAff=f)NrraFTrO) r]r\rorRr~r6rrrcrrTulabelrr9ris rrRIDNA2008Codec.decodes!!4U; ; C<~  2{{((u=T[[/6 6~~ 2q1 1 2sABB* B%%B*)rtr]rsrr)FFFF) rrrrrrErzrKrRrrlrms@rroros) .387<+ 2 2 2rros"().;\@$cU(dSn[U[5(aUR5n[U5HDnU[;aUS[ U5-- nM US:aUS:aU[ U5- nM<USU-- nMF UR5$Sn[U[ 5(aUR5nUH2nUS:a US:aX#- nMUS:aX#- nM!US[U5-- nM4 U$)zEscape the characters in label which need it. @param unicode_mode: escapify only special and whitespace (<= 0x20) characters @returns: the escaped string @rtype: stringra\ rwz\%03d ) isinstancerrK bytearray_escapedchrrrRrx)rJ unicode_modetextrys rrTrTs  eY ' 'LLNE5!AH}s1v %Ta$hA1 $ "{{} D%%%   w;1w; IDG|  CF** Krc[U5nSnSnSnUH4n[U5nX&S-- nUS:a[eUS:aUS:XaUnUS- nM6 US:a[eUS:aX1S- :wa[egg)a@Check for empty labels in the middle of a label sequence, labels that are too long, and for too many labels. Raises ``dns.name.NameTooLong`` if the name as a whole is too long. Raises ``dns.name.EmptyLabel`` if a label is empty (i.e. the root label) and appears in a position other than the end of the label sequence rr?rN)lenr-r)r)labelsltotalijrJlls r_validate_labelsrs F A E A A Z a 7  q5Uc\A Q s{Av!1u*vrc[U[5(aU$[U[5(aUR5$[e)z^If label is ``text``, convert it to ``binary``. If it is already ``binary`` just return it. )rrrrK ValueError)rJs r_maybe_convert_to_binaryr1s5 %%% %##||~ rc^\rSrSrSrS/rU4SjrSrSrSr Sr U4S jr S r S r S rS rSrSrSrSrSrSrSrSrSrSrSrS(SjrS)SjrS*SjrS+SjrSrSr Sr!S r"S!r#S"r$S#r%S$r&S,S%jr'S&r(S'r)U=r*$)-Namei>zA DNS name. The dns.name.Name class represents a DNS name as a tuple of labels. Each label is a `binary` in DNS wire format. Instances of the class are immutable. rc>UVs/sHn[U5PM nn[[U]S[ U55 [ UR 5 gs snf)zJ*labels* is any iterable whose values are ``text`` or ``binary``. rN)rr\r __setattr__tuplerr)rDrxr^s rrE Name.__init__IsE8>>v!*1-v> dD%hf >%?sAc[S5e)Nz+object doesn't support attribute assignment) TypeError)rDnamevalues rrName.__setattr__QsEFFrc,[UR5$rB)rrrCs r__copy__ Name.__copy__UsDKK  rcV[[R"URU55$rB)rcopydeepcopyr)rDmemos r __deepcopy__Name.__deepcopy__XsDMM$++t455rcSUR0$NrrrCs r __getstate__Name.__getstate__[s$++&&rc^>[[U] SUS5 [UR5 gr)r\rrrr)rDstater^s r __setstate__Name.__setstate___s$ dD%hh@%rcd[UR5S:=(a URSS:H$)zPIs the most significant label of this name the root label? Returns a ``bool``. rrrrrrCs r is_absoluteName.is_absolutecs* 4;;!#> B3(>>rcd[UR5S:=(a URSS:H$)zTIs this name wild? (I.e. Is the least significant label '*'?) Returns a ``bool``. r*rrCs ris_wild Name.is_wildks* 4;;!#> A$(>>rc[S5nURH-n[UR55H nXS-U-- nM M/ [ U[ -5$)zAReturn a case-insensitive hash of the name. Returns an ``int``. rr )rrrrPintmaxint)rDhrJrys r__hash__ Name.__hash__ssP G[[Eu{{}-1f\!.!1v:rcdUR5nUR5nX#:waU(a [SS4$[SS4$[UR5n[UR5nXE- nUS:aUnOUnSnSn [n US:aUS-nUS-nUS-nURUR 5n URUR 5n X:aSnU S:a[ n XU 4$X:aSnU S:a[ n XU 4$U S- n US:aMUnUS:a[ n OUS:a[n O[n XU 4$)a Compare two names, returning a 3-tuple ``(relation, order, nlabels)``. *relation* describes the relation ship between the names, and is one of: ``dns.name.NAMERELN_NONE``, ``dns.name.NAMERELN_SUPERDOMAIN``, ``dns.name.NAMERELN_SUBDOMAIN``, ``dns.name.NAMERELN_EQUAL``, or ``dns.name.NAMERELN_COMMONANCESTOR``. *order* is < 0 if *self* < *other*, > 0 if *self* > *other*, and == 0 if *self* == *other*. A relative name is always less than an absolute name. If both names have the same relativity, then the DNSSEC order relation is used to order them. *nlabels* is the number of significant labels that the two names have in common. Here are some examples. Names ending in "." are absolute names, those not ending in "." are relative names. ============= ============= =========== ===== ======= self other relation order nlabels ============= ============= =========== ===== ======= www.example. www.example. equal 0 3 www.example. example. subdomain > 0 2 example. www.example. superdomain < 0 2 example1.com. example2.com. common anc. < 0 2 example1 example2. none < 0 0 example1. example2 none > 0 0 ============= ============= =========== ===== ======= rrr) r NAMERELN_NONErrrPNAMERELN_COMMONANCESTORNAMERELN_SUPERDOMAINNAMERELN_SUBDOMAINNAMERELN_EQUAL) rDothersabsoabsl1l2ldiffrordernlabelsnamerelnlabel1label2s r fullcompareName.fullcomparesX@!  " <%q!,,%r1--     19AA !e FA !GB !GB[[_**,F\\"%++-FQ;6H 11Q;6H 11 qLG!!e" 19+H QY)H%H))rcVURU5up#nU[:Xd U[:Xagg)zIs self a subdomain of other? Note that the notion of subdomain includes equality, e.g. "dnpython.org" is a subdomain of itself. Returns a ``bool``. TF)rrrrDrnronls r is_subdomainName.is_subdomains.&&u-  # #r^';rcVURU5up#nU[:Xd U[:Xagg)zIs self a superdomain of other? Note that the notion of superdomain includes equality, e.g. "dnpython.org" is a superdomain of itself. Returns a ``bool``. TF)rrrrs ris_superdomainName.is_superdomains.&&u-  % %~)=rcr[URVs/sHoR5PM sn5$s snf)zSReturn a name which is equal to the current name, but is in DNSSEC canonical form. )rrrP)rDrs r canonicalizeName.canonicalizes)  4 1WWY 4554s4c\[U[5(aURU5SS:H$g)NrrFrrrrDrs r__eq__ Name.__eq__s- eT " "##E*1-2 2rc\[U[5(aURU5SS:g$g)NrrTrrs r__ne__ Name.__ne__s- eT " "##E*1-2 2rcf[U[5(aURU5SS:$[$NrrrrrNotImplementedrs r__lt__ Name.__lt__0 eT " "##E*1-1 1! !rcf[U[5(aURU5SS:*$[$rrrs r__le__ Name.__le__0 eT " "##E*1-2 2! !rcf[U[5(aURU5SS:$[$rrrs r__ge__ Name.__ge__rrcf[U[5(aURU5SS:$[$rrrs r__gt__ Name.__gt__ rrc.SUR5-S-$)Nz )__str__rCs r__repr__ Name.__repr__sdlln,s22rc$URS5$)NF)to_textrCs rr Name.__str__s||E""rc|[UR5S:Xa [S5$[UR5S:XaURSS:Xa [S5$U(a%UR5(aURSSnO URnSR [ [ U55n[U5$)zConvert name to DNS text format. *omit_final_dot* is a ``bool``. If True, don't emit the final dot (denoting the root label) for absolute names. The default is False. Returns a ``text``. r@rr.Nr)rrr rjoinmaprT)rDomit_final_dotrss rr  Name.to_texts t{{ q % % t{{ q T[[^s%:% % d..00 CR A A IIc)Q' (Arc|[UR5S:Xag[UR5S:XaURSS:XagU(a%UR5(aURSSnO URnUc[nSR UVs/sHoBR U5PM sn5$s snf)aConvert name to Unicode text format. IDN ACE labels are converted to Unicode. *omit_final_dot* is a ``bool``. If True, don't emit the final dot (denoting the root label) for absolute names. The default is False. *idna_codec* specifies the IDNA encoder/decoder. If None, the dns.name.IDNA_2003_Practical encoder/decoder is used. The IDNA_2003_Practical decoder does not impose any policy, it just decodes punycode, so if you don't want checking for compliance, you can use this decoder for IDNA2008 as well. Returns a ``text``. r@rr.Nr)rrrIDNA_2003_PracticalrrR)rDr idna_codecrrs r to_unicodeName.to_unicode-s$ t{{ q  t{{ q T[[^s%: d..00 CR A A  ,Jyy:1++A.:;;:sB9c UR5(dXUbUR5(d[e[UR5nUR [UR55 O URnUVs/sH>n[ R "S[U5-[U5UR55PM@ nnSRU5$s snf)aConvert name to a format suitable for digesting in hashes. The name is canonicalized and converted to uncompressed wire format. All names in wire format are absolute. If the name is a relative name, then an origin must be supplied. *origin* is a ``dns.name.Name`` or ``None``. If the name is relative and origin is not ``None``, then origin will be appended to the name. Raises ``dns.name.NeedAbsoluteNameOrOrigin`` if the name is relative and no origin was provided. Returns a ``binary``. z!B%dsr) rr&listrextendstructpackrrPr)rDoriginrrdlabelss r to_digestableName.to_digestableKs"!!~V%7%7%9%9..$++&F MM$v}}- .[[F"$"q;;wQ/QC" $xx  $s>ACcUc [5nSnOSnUR5(dXUbUR5(d[e[UR5nUR [UR55 O URnSnUHn[ XVS5nUS- nUbURU5n OSn U b/SU -n [R"SU 5n URU 5 OzUb)[U5S:aUR5n U S::aXU'[U5n UR[R"S U 55 U S:dMURU5 M U(aUR5$g) aVConvert name to wire format, possibly compressing it. *file* is the file where the name is emitted (typically a BytesIO file). If ``None`` (the default), a ``binary`` containing the wire name will be returned. *compress*, a ``dict``, is the compression table to use. If ``None`` (the default), names will not be compressed. *origin* is a ``dns.name.Name`` or ``None``. If the name is relative and origin is not ``None``, then *origin* will be appended to it. Raises ``dns.name.NeedAbsoluteNameOrOrigin`` if the name is relative and no origin was provided. Returns a ``binary`` or ``None``. NTFrriz!Hi?!B)rrr&rrrrgetrr writertellgetvalue) rDfilecompressr! want_returnrrrJnposrrrs rto_wire Name.to_wiregsJ( <9DKK!!~V%7%7%9%9..$++&F MM$v}}- .[[F EVBZ A FA#ll1o KKe, 1 'CFQJ))+Cf}&) J 6;;tQ/0q5JJu%)* ==? " rc,[UR5$)z9The length of the name (in labels). Returns an ``int``. rrCs r__len__ Name.__len__s 4;;rc URU$rBr)rDindexs r __getitem__Name.__getitem__s{{5!!rc$URU5$rB) concatenaters r__add__ Name.__add__s&&rc$URU5$rB) relativizers r__sub__ Name.__sub__su%%rc[UR5nUS:XaU[RR4$X:Xa[RRU4$US:dX:a [ S5e[ USU*5[ X*S54$)aSplit a name into a prefix and suffix names at the specified depth. *depth* is an ``int`` specifying the number of labels in the suffix Raises ``ValueError`` if *depth* was not >= 0 and <= the length of the name. Returns the tuple ``(prefix, suffix)``. rz0depth must be >= 0 and <= the length of the nameN)rrdnsremptyrr)rDdepthrs rsplit Name.splits   A:#((..) ) ZHHNND) ) QY%)BD DT(UF^$d4=&9::rcUR5(a[U5S:a[e[UR5nUR [UR55 [ U5$)zReturn a new name which is the concatenation of self and other. Raises ``dns.name.AbsoluteConcatenation`` if the name is absolute and *other* is not the empty name. Returns a ``dns.name.Name``. r)rrr0rrrr)rDrrs rr:Name.concatenatesP     #e*q.' 'dkk" d5<<()F|rchUb.URU5(a[US[U5*5$U$)aQIf the name is a subdomain of *origin*, return a new name which is the name relative to origin. Otherwise return the name. For example, relativizing ``www.dnspython.org.`` to origin ``dnspython.org.`` returns the name ``www``. Relativizing ``example.`` to origin ``dnspython.org.`` returns ``example.``. Returns a ``dns.name.Name``. N)rrrrDr!s rr>Name.relativizes7  $"3"3F";";^F |,- -KrcRUR5(dURU5$U$)aZIf the name is a relative name, return a new name which is the concatenation of the name and origin. Otherwise return the name. For example, derelativizing ``www`` to origin ``dnspython.org.`` returns the name ``www.dnspython.org.``. Derelativizing ``example.`` to origin ``dnspython.org.`` returns ``example.``. Returns a ``dns.name.Name``. )rr:rJs r derelativizeName.derelativizes)!!##F+ +KrcfU(a)U(aURU5$URU5$U$)aReturn a name with the relativity desired by the caller. If *origin* is ``None``, then the name is returned. Otherwise, if *relativize* is ``True`` the name is relativized, and if *relativize* is ``False`` the name is derelativized. Returns a ``dns.name.Name``. )r>rM)rDr!r>s rchoose_relativityName.choose_relativitys/ v..((00KrcfU[:Xd U[:Xa[e[URSS5$)zReturn the parent of the name. For example, the parent of ``www.dnspython.org.`` is ``dnspython.org``. Raises ``dns.name.NoParent`` if the name is either the root name or the empty name, and thus has no parent. Returns a ``dns.name.Name``. rN)rootrCr3rrrCs rparent Name.parent s+ 4<45=NDKKO$$rrrk)FNrB)NNN)NT)+rrrrr __slots__rErrrrrrrrrrrrrrrrrrrrr rr#r0r3r7r;r?rEr:r>rMrPrTrrlrms@rrr>s I&G!6'&?? J*X  6  " " " " 3#*<<!88#t "'&;*   & % %rrrc[U[5(d [S5eUb [U[5(d [S5e/nSnSnSnSnUc[nUS:XaSnU(GaCUS:Xa [S/5$UHnU(aUS:Xa/UR 5(a[ U5nUS - nM7XH- nSnM?UR 5(d[eUS -nU[ U5- nUS - nUS :XaSnU[U5- nMMUS ;a9[U5S:Xa[eURURU55 SnMUS :XaSnSnSnMXH- nM U(a[e[U5S:a!URURU55 OURS5 [U5S:Xd USS:wa'Ub$UR[UR55 [U5$)aConvert unicode text into a Name object. Labels are encoded in IDN ACE form according to rules specified by the IDNA codec. *text*, a ``text``, is the text to convert into a name. *origin*, a ``dns.name.Name``, specifies the origin to append to non-absolute names. The default is the root name. *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder is used. Returns a ``dns.name.Name``. z0input to from_unicode() must be a unicode stringorigin must be a Name or NoneraFrrrrr r )ru。u．u｡rTr)rrrr IDNA_2003isdigitrrrrrappendrKrrr) rr!rrrJescapingedigitsrrys r from_unicoder_s$ dI & &KLL Nj66899 F EHG E  t| 4<; Aa<yy{{ #A1  #(99;;'RKESVOEqLG!|#(.$==u:?$$ j//67e 9: O u:> MM*++E2 3 MM#  F qF2J#-63E d6==)* <rc4[U[5(a [XU5$[U[5(d [ S5eUb [U[ 5(d [ S5e/nSnSnSnSnUS:XaSnU(GaQUS:Xa [ S/5$[ U5Hn[R"SU5n U(aUS:Xa/U R5(a[U 5nUS - nMNXI- nSnMVU R5(d[eUS -nU[U 5- nUS - nUS :XaSnU[R"SU5- nMMU S:Xa*[U5S:Xa[eURU5 SnMU S :XaS nSnSnMXI- nM U(a[e[U5S:aURU5 OURS5 [U5S:Xd USS:wa'Ub$UR[!UR"55 [ U5$)awConvert text into a Name object. *text*, a ``text``, is the text to convert into a name. *origin*, a ``dns.name.Name``, specifies the origin to append to non-absolute names. The default is the root name. *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder is used. Returns a ``dns.name.Name``. z%input to from_text() must be a stringrXrFrrrr&rrYr \Tr)rrr_rrrrrr r[rrrrr\rrr) rr!rrrJr]r^rrybyte_s r from_textrcis$ ""D*55 dK ( (@AA Nj66899 F EHG E t| 4<; 4AKKa(Ea<}} #E 1 #( ==??'RKESZ'EqLG!|#(T5!99$$u:?$$ e$%;!< O u:> MM% MM#  F qF2J#-63E d6==)* <rc[U[5(d [S5e[RR U5n/nUnSnXnUS- nSnUS:waUS:a2UR XX-R55 X- nUS:XaXe- nO7US:a+US-S-X-nUS:XaUS- nX:a[eUnUS- nO[eXnUS- nUS:XaUS- nUS:waMUR S5 [U5U4$) a3Convert possibly compressed wire format into a Name. *message* is a ``binary`` containing an entire DNS message in DNS wire form. *current*, an ``int``, is the offset of the beginning of the name from the start of the message Raises ``dns.name.BadPointer`` if a compression pointer did not point backwards in the message. Raises ``dns.name.BadLabelType`` if an invalid label type was encountered. Returns a ``(dns.name.Name, int)`` tuple consisting of the name that was read and the number of bytes of the wire format message which were consumed reading it. z*input to from_wire() must be a byte stringrr@rra) rrrrBwiredata maybe_wrapr\unwrapr r#r)messagecurrentrbiggest_pointerhopscountcuseds r from_wirerqs+& g{ + +EFFll%%g.G FO D  E qLG E 1* 2: MM'7?;BBD E  Gqy c\t|s*W-==Gqy )  %O AID  1  19 QJE' 1*( MM" L%  rrk)Briorrsysrencodings.idnarbrcr~ ImportError dns.exceptionrB dns.wiredata_compatrrrrr rAttributeErrorcalcsizerrrrr exception SyntaxErrorrr FormErrorr r# DNSExceptionr&r)r-r0r3r6r9objectr?rYrorrrIDNA_2003_StrictrZIDNA_2008_PracticalIDNA_2008_UTS_46IDNA_2008_StrictIDNA_2008_Transitional IDNA_2008rTrrrrSrCr_rcrqrrrrs$ NGG8 ZZF  ** C ))CH((H=3==**=Ds}}99D +#--))++3==,,++CMM66+ s}}))++ 8CMM..8&&,!2I!2HA2IA2F \ "#E* &  #D%u= ueU; ud;&tT5%@  @< X%6X%v SE{ R"tHV DEP1!iN8A,,-! 3a 7F8s"I III$I;:I;