/usr/lib/rads/venv/lib/python3.13/site-packages/dns/__pycache__
Edit: /usr/lib/rads/venv/lib/python3.13/site-packages/dns/__pycache__/name.cpython-313.pyc (49060B)
j
n S r SSKrSSKrSSKrSSKrSSKJrJrJ r J
r
J r J r J
r
SSKrSSKrSSKrSSKrSSKr\R( R+ S5 ( a SSKrSrOSr\ S\4 r " S S \R4 R6 5 r \ R: r \ R> r \ RB r"\ RF r$\ RJ r& " S
S \RN RP 5 r) " S S
\RN RP 5 r* " S S\RN RV 5 r, " S S\RN RV 5 r- " S S\RN R\ 5 r/ " S S\RN RV 5 r0 " S S\RN RP 5 r1 " S S\RN R\ 5 r2 " S S\RN R\ 5 r3 " S S \RN R\ 5 r4 " S S \RN R\ 5 r5 " S S!\RN R\ 5 r6S"r7S#r8S$\
\9\:4 S%\:4S& jr; " S' S(5 r< " S) S*\<5 r= " S+ S,\<5 r>\=" S5 r?\=" S5 r@\?rA\>" SSSS5 rB\>" SSSS5 rC\>" SSSS5 rD\>" SSSS5 rE\BrFS-\ \9S.4 S%S4S/ jrGS$\
\9\:4 S%\94S0 jrH\R R " S1 S5 5 rJ\J" S2/5 rK\J" / 5 rL\KS4S3\:S4\ \J S5\ \< S%\J4S6 jjrMS3\:S%\N4S7 jrO\KS4S3\
\9\:4 S4\ \J S5\ \< S%\J4S8 jjrPS9S:S%\J4S; jrQS<\9S=\S%\ \J\4 4S> jrRS?rS\T" \S5 rU\J" \S/5 rVS@rW\T" \W5 rX\T" SA5 rY\T" SB5 rZSC r[SD r\SE r]SF\JS4\JSG\NS%\J4SH jr^SF\JS4\JSG\NS%\J4SI jr_SJ\\J\J\N/\J4 SF\JS4\JSG\NS%\J4
SK jr`g)Lz DNS Names.
N)AnyCallableDictIterableOptionalTupleUnionidnaTFNamec L \ rS rSrSrSrSrSrSrSr \
S 5 r \
S 5 r S
r
g ) NameRelation+ z(Name relation result from fullcompare().r c U R $ N)COMMONANCESTORclss ;/usr/lib/rads/venv/lib/python3.13/site-packages/dns/name.py_maximumNameRelation._maximum< s !!! c U R $ r )__name__r s r _short_nameNameRelation._short_name@ s ||r N)r
__module__ __qualname____firstlineno____doc__NONE SUPERDOMAIN SUBDOMAINEQUALr classmethodr r __static_attributes__r r r r
r
+ sF 2
DKI
EN" " r r
c \ rS rSrSrSrg)
EmptyLabelM zA DNS label is empty.r Nr r! r" r# r$ r* r r r r, r, M s r r, c \ rS rSrSrSrg) BadEscapeQ z8An escaped code in a text format of DNS name is invalid.r Nr. r r r r0 r0 Q s Br r0 c \ rS rSrSrSrg)
BadPointerU z=A DNS compression pointer points forward instead of backward.r Nr. r r r r3 r3 U s Gr r3 c \ rS rSrSrSrg) BadLabelTypeY z2The label type in DNS name wire format is unknown.r Nr. r r r r6 r6 Y s
255 octets long.r Nr. r r r r< r< b *r r< c \ rS rSrSrSrg) LabelTooLongf z A DNS label is > 63 octets long.r Nr. r r r r@ r@ f r> r r@ c \ rS rSrSrSrg)AbsoluteConcatenationj zYAn attempt was made to append anything other than the
empty name to an absolute DNS name.r Nr. r r r rC rC j s +r rC c \ rS rSrSrSrg)NoParento zIAn attempt was made to get the parent of the root name
or the empty name.r Nr. r r r rF rF o s r rF c \ rS rSrSrSrg)
NoIDNA2008t zHIDNA 2008 processing was requested but the idna module is not
available.r Nr. r r r rI rI t s r rI c 6 ^ \ rS rSrSrS1rSrU 4S jrSrU =r $ )
IDNAExceptiony z$IDNA processing raised an exception.idna_exceptionz+IDNA processing exception: {idna_exception}c & > [ TU ] " U0 UD6 g r )super__init__)selfargskwargs __class__s r rQ IDNAException.__init__ s
$)&)r r )
r r! r" r# r$ supp_kwargsfmtrQ r*
__classcell__rU s @r rL rL y s .#$K
7C* *r rL c \ rS rSrSrSrg)NeedSubdomainOfOrigin zNAn absolute name was provided that is not a subdomain of the specified origin.r Nr. r r r r\ r\ s Xr r\ s "().;\@$z"().;\@$labelreturnc D [ U [ 5 ( aN SnU HD nU[ ; a US[ U5 - -
nM US: a US: a U[ U5 -
nM< USU- -
nMF U$ SnU H4 nU[ ; a
USU- -
nM US:: a US[ U5 - -
nM0 X-
nM6 U$ )zYEscape the characters in label which need it.
@returns: the escaped string
@rtype: string \ z\%03d )
isinstancebytes_escapedchr
_escaped_textord)r^ textcucs r _escapifyro s % AH}s1v
%Ta$hA1 $
D
D2I D
6\ Hs2w& &D JD
Kr c T \ rS rSrSrS rS\S\4S jrS\ S\4S jr
S\S\ 4S jr S r g
) IDNACodec z.Abstract base class for IDNA encoder/decoders.c g r r rR s r rQ IDNACodec.__init__ s r r^ r_ c @ UR 5 R S5 $ )Ns xn--)lower
startswithrR r^ s r is_idnaIDNACodec.is_idna s {{}''00r c [ er )NotImplementedErrorry s r encodeIDNACodec.encode s !!r c U R U5 ( a USS R S5 n[ U5 $ [ U5 $ ! [ a n[ US9eS nAff = f)Nr punycoderN )rz decodero ExceptionrL )rR r^ slabeles r r IDNACodec.decode sa <<
6 qr))*5 (( U# #
6#155
6s A
A AAr N)
r r! r" r# r$ rQ rg boolrz strr~ r r* r r r rq rq sC 8
1U 1t 1"C "E " $E $c $r rq c b ^ \ rS rSrSrS
S\4U 4S jjjrS\S\4S jr S\S\4U 4S jjr
S r U =r $ )
IDNA2003Codec zIDNA 2003 encoder/decoder.
strict_decodec . > [ TU ] 5 Xl g)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)rP rQ r )rR r rU s r rQ IDNA2003Codec.__init__ s *r r^ r_ c x US:X a g [ R R U5 $ ! [ a [ ef = f)zEncode *label*.ra r ) encodingsr
ToASCII UnicodeErrorr@ ry s r r~ IDNA2003Codec.encode s= B; >>))%0 0 s ( 9c > U R ( d [ TU ] U5 $ US:X a g [ [ R
R
U5 5 $ ! [ a n[ US9eSnAff = f)zDecode *label*.r ra r N) r rP r ro r r
ToUnicoder rL )rR r^ r rU s r r IDNA2003Codec.decode s_ !!7>%( ( C< 2 Y^^ 5 5e <= = 2 q1 1 2s 'A
A* A%%A*)r F
r r! r" r# r$ r rQ r rg r~ r r* rY rZ s @r r r sB $ +d + + C E 2E 2c 2 2r r c v ^ \ rS rSrSr S
S\S\S\S\4U 4S jjjrS\S \4S
jr S\S \4U 4S jjr
S r U =r $ )
IDNA2008Codec zIDNA 2008 encoder/decoder.uts_46 transitionalallow_pure_asciir c R > [ TU ] 5 Xl X l X0l X@l g)a Initialize the IDNA 2008 encoder/decoder.
*uts_46* is a ``bool``. If True, apply Unicode IDNA
compatibility processing as described in Unicode Technical
Standard #46 (https://unicode.org/reports/tr46/).
If False, do not apply the mapping. The default is False.
*transitional* is a ``bool``: If True, use the
"transitional" mode described in Unicode Technical Standard
#46. The default is False.
*allow_pure_ascii* is a ``bool``. If True, then a label which
consists of only ASCII characters is allowed. This is less
strict than regular IDNA 2008, but is also necessary for mixed
names, e.g. a name with starting with "_sip._tcp." and ending
in an IDN suffix which would otherwise be disallowed. The
default is False.
*strict_decode* is a ``bool``: If True, then IDNA2008 checking
is done when decoding. This can cause failures if the name
was encoded with IDNA2003. The default is False.
N)rP rQ r r r r )rR r r r r rU s r rQ IDNA2008Codec.__init__ s' : ( 0 *r r^ r_ c US:X a gU R ( a8 [ U5 ( a( UR S5 n[ U5 S: a [ eU$ [
( d [ e U R ( a" [ R " USU R 5 n[ R " U5 $ ! [ R a' nUR S S:X a [ e[ US9eS nAff = f) Nra r ascii? Fr zLabel too longr )r is_all_asciir~ lenr@ have_idna_2008rI r r
uts46_remapr alabel IDNAErrorrS rL )rR r^ encodedr s r r~ IDNA2008Codec.encode s B; \%%8%8ll7+G7|b ""N ~ 6{{ ((t7H7HI;;u% %~~ 6vvay ,,""#155 6s #AB, ,C' "C""C'c t > U R ( d [ TU ] U5 $ US:X a g[ ( d [ e [
R " U5 nU R ( a" [
R " USU R 5 n[ U5 $ ! [
R [ 4 a n[ US9eS nAff = f)Nr ra Fr )r rP r r rI r
ulabelr r r ro r r rL )rR r^ r r rU s r r IDNA2008Codec.decode! s !!7>%( ( C< ~ 2[['F{{ ))&%9J9JK V$ $ - 2 q1 1 2s AB B7) B22B7)r r r r )FFFFr rZ s @r r r sp $ "!& # !+!+ !+ !+
!+ !+F6C 6E 6*
2E
2c
2
2r r labels.c [ U 5 nSnSnSnU H4 n[ U5 nX&S- -
nUS: a [ eUS: a US:X a UnUS-
nM6 US: a [ eUS: a X1S-
:w a [ 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
r r r r N)r r@ r< r, )r ltotalijr^ lls r _validate_labelsr ; s F A
E
A A
Z
a
7 q5Uc\A Q
s{Av!1u* vr c [ U [ 5 ( a U $ [ U [ 5 ( a U R 5 $ [ e)z[If label is ``str``, convert it to ``bytes``. If it is already
``bytes`` just return it.
)rf rg r r~
ValueError)r^ s r _maybe_convert_to_binaryr Y s5 % % ||~
r c T ^ \ rS rSrSrS/rS\\\\ 4 4S jr
S r S r S r
U 4S jrS \4S
jrS \4S jrS \4S jrS
S S \\\\4 4S jrS
S S \4S jrS
S S \4S jrS5S jrS rS rS r S r S r S r S r S r!S6S\S \ 4S jjr" S7S\S \#\$ S \ 4S jjr%S8S \#S S \4S jjr& S9S \#\' S!\#\( S \#S S"\S \#\ 4
S# jjr)S \4S$ jr*S% r+S& r,S' r-S(\S \S) 4S* jr.S:S+ jr/S;S, jr0S;S- jr1 Sr if zA DNS name.
The dns.name.Name class represents a DNS name as a tuple of
labels. Each label is a ``bytes`` in DNS wire format. Instances
of the class are immutable.
r c U Vs/ s H n[ U5 PM nn[ U5 U l [ U R 5 gs snf )z?*labels* is any iterable whose values are ``str`` or ``bytes``.N)r tupler r )rR r xblabelss r rQ
Name.__init__q s; 9??1+A.?Gn % @s Ac , [ U R 5 $ r )r r rt s r __copy__
Name.__copy__x s DKK r c V [ [ R " U R U5 5 $ r )r copydeepcopyr )rR memos r __deepcopy__Name.__deepcopy__{ s DMM$++t455r c SU R 0$ Nr r rt s r __getstate__Name.__getstate__~ s $++&&r c V > [ TU ] SUS 5 [ U R 5 g r )rP __setattr__r r )rR staterU s r __setstate__Name.__setstate__ s"
HeHo6%r r_ c d [ U R 5 S: =( a U R S S:H $ )zPIs the most significant label of this name the root label?
Returns a ``bool``.
r r r r r rt s r is_absoluteName.is_absolute s* 4;; !#> B3(>>r c d [ U R 5 S: =( a U R S S:H $ )zTIs this name wild? (I.e. Is the least significant label '*'?)
Returns a ``bool``.
r *r rt s r is_wild Name.is_wild s* 4;; !#> A$(>>r c r SnU R H$ nUR 5 H
nXS- U- -
nM M& U$ )zAReturn a case-insensitive hash of the name.
Returns an ``int``.
r r )r rw )rR hr^ rm s r __hash__
Name.__hash__ s>
[[E[[]1f\! # ! r otherc U R 5 nUR 5 nX#:w a- U( a [ R SS4$ [ R SS4$ [ U R 5 n[ UR 5 nXE-
nUS: a UnOUnSnSn [ R n
US: a US- nUS- nUS- nU R U R 5 n UR U R 5 n X: a SnU S: a [ R n
XU 4$ X: a SnU S: a [ R n
XU 4$ U S-
n US: a M UnUS: a [ R n
O'US: a [ R n
O[ R 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.NameRelation.NONE``,
``dns.name.NameRelation.SUPERDOMAIN``, ``dns.name.NameRelation.SUBDOMAIN``,
``dns.name.NameRelation.EQUAL``, or ``dns.name.NameRelation.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
============= ============= =========== ===== =======
r r r )
r r
r% r r rw r r& r' r( )
rR r sabsoabsl1l2ldiffr ordernlabelsnamerelnlabel1label2s
r fullcompareName.fullcompare s @ ! " <$))1a00$))2q11
19AA $$!e
FA !GB !GB[[_**,F\\"%++-FQ; + : :H 11 Q; + : :H 11 qLG! !e" 19#//H
QY#--H#))H))r c U R U5 u n nU[ R :X d U[ R :X a gg)zIs self a subdomain of other?
Note that the notion of subdomain includes equality, e.g.
"dnspython.org" is a subdomain of itself.
Returns a ``bool``.
TF)r r
r' r( rR r nr_s r is_subdomainName.is_subdomain s; %%e,
Q
'' '2 1C1C+Cr c U R U5 u n nU[ R :X d U[ R :X a gg)zIs self a superdomain of other?
Note that the notion of superdomain includes equality, e.g.
"dnspython.org" is a superdomain of itself.
Returns a ``bool``.
TF)r r
r& r( r s r is_superdomainName.is_superdomain s; %%e,
Q
)) )R<3E3E-Er c r [ U R Vs/ s H oR 5 PM sn5 $ s snf )zSReturn a name which is equal to the current name, but is in
DNSSEC canonical form.
)r r rw )rR r s r canonicalizeName.canonicalize
s)
4 1WWY 4554s 4c \ [ U[ 5 ( a U R U5 S S:H $ g)Nr r Frf r r rR r s r __eq__ Name.__eq__ s- eT " "##E*1-2 2r c \ [ U[ 5 ( a U R U5 S S:g $ g)Nr r Tr r s r __ne__ Name.__ne__ s- eT " "##E*1-2 2r c f [ U[ 5 ( a U R U5 S S: $ [ $ Nr r rf r r NotImplementedr s r __lt__ Name.__lt__ 0 eT " "##E*1-1 1! !r c f [ U[ 5 ( a U R U5 S S:* $ [ $ r r r s r __le__ Name.__le__# 0 eT " "##E*1-2 2! !r c f [ U[ 5 ( a U R U5 S S: $ [ $ r r r s r __ge__ Name.__ge__) r r c f [ U[ 5 ( a U R U5 S S: $ [ $ r r r s r __gt__ Name.__gt__/ r
r c . SU R 5 - S- $ )Nz
)__str__rt s r __repr__
Name.__repr__5 s dlln,s22r c $ U R S5 $ )NF)to_textrt s r r Name.__str__8 s ||E""r omit_final_dotc B [ U R 5 S:X a g[ U R 5 S:X a U R S S:X a gU( a% U R 5 ( a U R SS nO U R nSR [ [
U5 5 nU$ )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 ``str``.
r @r r .Nr )r r r joinmapro )rR r r ss r r Name.to_text; s t{{ q t{{ q T[[^s%: d . . 0 0 CR A A HHSA& 'r
idna_codecc | [ U R 5 S:X a g[ U R 5 S:X a U R S S:X a gU( a% U R 5 ( a U R SS nO U R nUc [ nSR U Vs/ s H oBR U5 PM sn5 $ s snf )a Convert 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 ``str``.
r r r r r Nr )r r r IDNA_2003_Practicalr! r )rR r r% r r s r
to_unicodeName.to_unicodeP s ( t{{ q t{{ q T[[^s%: d . . 0 0 CR A A ,Jxxq9q!**1-q9::9s B9originc 0 U R USS9nUc eU$ )a Convert 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 ``bytes``.
T)r* r )to_wire)rR r* digests r
to_digestableName.to_digestablep s' " V$ ?!!!
r filecompressr c Uc [ 5 nU R H< nUR [ U5 5 U( a XVR 5 -
nM8 XV-
nM> U R 5 ( dj Ub UR 5 ( d [ eUR H< nUR [ U5 5 U( a XVR 5 -
nM8 XV-
nM> [ U5 $ U R 5 ( dX Ub UR 5 ( d [ e[ U R 5 nUR [ UR 5 5 O U R nSnU H n[ XxS 5 n US-
nUb UR U 5 n
OSn
U
b/ SU
- n [ R " SU 5 n UR U 5 gUb) [ U 5 S: a UR 5 n
U
S:: a XU ' [ U5 n
UR [ R " SU
5 5 U
S: d M U( a! UR UR 5 5 M UR U5 M g)a Convert name to wire format, possibly compressing it.
*file* is the file where the name is emitted (typically an
io.BytesIO file). If ``None`` (the default), a ``bytes``
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. Note that
the compression code assumes that compression offset 0 is the
start of *file*, and thus compression will not be correct
if this is not the case.
*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.
*canonicalize*, a ``bool``, indicates whether the name should
be canonicalized; that is, converted to a format suitable for
digesting in hashes.
Raises ``dns.name.NeedAbsoluteNameOrOrigin`` if the name is
relative and no origin was provided.
Returns a ``bytes`` or ``None``.
Nr r i z!Hi? !B) bytearrayr appendr rw r r9 rg listextendr getstructpackwritetell)rR r0 r1 r* r outr^ r r nposvaluer# r s r r, Name.to_wire s B <+C
3u:& ;;=(CLC % ##%%>););)=)=22 #]]EJJs5z*#{{}, + : !!~V%7%7%9%9..$++&F MM$v}}- .[[F
EVBZ A
FA# ll1o KKe,
1
'CFQJ ))+Cf}&) J
6;;tQ/0q5#
5;;=1
5)/ 0 r c , [ U R 5 $ )z9The length of the name (in labels).
Returns an ``int``.
r rt s r __len__ Name.__len__ s 4;; r c U R U $ r r )rR indexs r __getitem__Name.__getitem__ s {{5!!r c $ U R U5 $ r ) concatenater s r __add__ Name.__add__ s &&r c $ U R U5 $ r )
relativizer s r __sub__ Name.__sub__ s u%%r depth)r r c [ U R 5 nUS:X a U [ R R 4$ X:X a [ R R U 4$ US: d X: a [ S5 e[
U SU* 5 [
X* S 5 4$ )a Split 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)``.
r z0depth must be >= 0 and <= the length of the nameN)r r dnsnameemptyr r )rR rQ r s r split
Name.split s~
A:#((..) )
ZHHNND) )
QY%) OP PT'E6]#T$vw-%899r c U R 5 ( a [ U5 S: a [ e[ U R 5 nUR [ UR 5 5 [
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 )r r rC r6 r r7 r )rR r r s r rJ Name.concatenate sP #e*q.' 'dkk"
d5<<()F|r c h Ub. U R U5 ( a [ U S[ U5 * 5 $ U $ )aQ If 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)r r r rR r* s r rN Name.relativize s7 $"3"3F";";^F |,- -Kr c R U R 5 ( d U R U5 $ U $ )aZ If 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``.
)r rJ r[ s r derelativizeName.derelativize s) !!##F+ +Kr rN c f U( a) U( a U R U5 $ U R U5 $ U $ )a Return 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``.
)rN r^ )rR r* rN s r choose_relativityName.choose_relativity0 s/ v..((00Kr c f U [ :X d
U [ :X a [ e[ U R SS 5 $ )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``.
r N)rootrU rF r r rt s r parent Name.parentE s+ 4<45=NDKKO$$r prefix_okc $ [ [ XU5 $ )a Return the maximal predecessor of *name* in the DNSSEC ordering in the zone
whose origin is *origin*, or return the longest name under *origin* if the
name is origin (i.e. wrap around to the longest name, which may still be
*origin* due to length considerations.
The relativity of the name is preserved, so if this name is relative
then the method will return a relative name, and likewise if this name
is absolute then the predecessor will be absolute.
*prefix_ok* indicates if prefixing labels is allowed, and
defaults to ``True``. Normally it is good to allow this, but if computing
a maximal predecessor at a zone cut point then ``False`` must be specified.
)_handle_relativity_and_call_absolute_predecessorrR r* rg s r predecessorName.predecessorT s + !4
r c $ [ [ XU5 $ )a Return the minimal successor of *name* in the DNSSEC ordering in the zone
whose origin is *origin*, or return *origin* if the successor cannot be
computed due to name length limitations.
Note that *origin* is returned in the "too long" cases because wrapping
around to the origin is how NSEC records express "end of the zone".
The relativity of the name is preserved, so if this name is relative
then the method will return a relative name, and likewise if this name
is absolute then the successor will be absolute.
*prefix_ok* indicates if prefixing a new minimal label is allowed, and
defaults to ``True``. Normally it is good to allow this, but if computing
a minimal successor at a zone cut point then ``False`` must be specified.
)ri _absolute_successorrk s r successorName.successorf s ++>iXXr r )r_ r r )FNr )NNNF)r r r_ r )r* r r_ r )NT)T)8r r! r" r# r$ __slots__r r rg r rQ r r r r r r r intr r r
r r r r r r r r r r r r r r rq r( r. r CompressTyper, rC rG rK rO rV rJ rN r^ ra re rl rp r* rY rZ s @r r r f s8
I&xeSj(9 : &!6'&?T ?? ?
#
J* J*E,S2H,I J*X & T F t 6 " " " " 3#d s , OS ; " ;8@8K ; ;@HV$4 . #+/#' " UsmU <(U U
U
%
Un "'&:3 :5 #8 :(
" CG v&;? *
%
&
T
V
$Y Y4 Y6 Y Yr r rl r* r% c [ U [ 5 ( d [ S5 eUb [ U[ 5 ( d [ S5 e/ nSnSnSnSnUc [ nU S:X a Sn U ( GaC U S; a [ S/5 $ U H nU( a US:X a/ UR 5 ( a [
U5 nUS -
nM7 XH-
nSnM? UR 5 ( d [ eUS
- nU[
U5 -
nUS -
nUS :X a SnU[ U5 -
nM M US; a9 [ U5 S:X a [ eUR UR U5 5 SnM US :X a S
nSnSnM XH-
nM U( a [ e[ U5 S: a! UR UR U5 5 OUR S5 [ U5 S:X d US S:w a' Ub$ UR [ UR 5 5 [ U5 $ )a Convert unicode text into a Name object.
Labels are encoded in IDN ACE form according to rules specified by
the IDNA codec.
*text*, a ``str``, 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 string origin must be a Name or Nonera Fr r )r u 。u ．u ｡r r
r rb Tr )rf r r r IDNA_2003isdigitrs r0 ri r r, r5 r~ r7 r6 r ) rl r* r% r r^ escapingedigitsr rm s r from_unicoder| s ( dC KLL Nj 6 6899
F EHG
E
s{ 6 6; Aa<yy{{ #A 1
#( 99;; 'RKESVOEqLG !|#( U+ $ 99u:?$$
j / / 67d
9 : O u:> MM*++E2 3 MM# F qF2J# -63E
d6==)* <r c 8 U H n[ U5 S: d M g g)Nrd FT)rk )rl rm s r r r s
q6D= r c d [ U [ 5 ( a- [ U 5 ( d [ XU5 $ U R S5 n [ U [
5 ( d [
S5 eUb [ U[ 5 ( d [
S5 e/ nSnSnSnSnU S:X a Sn U ( GaH U S:X a [ S/5 $ U H n[ R " S U5 n U( a US:X a/ U R 5 ( a [ U 5 nUS
-
nMN XI-
nSnMV U R 5 ( d [ eUS - nU[ U 5 -
nUS
-
nUS :X a SnU[ R " S U5 -
nM M U S:X a* [ U5 S:X a [ eUR U5 SnM U S
:X a SnSnSnM XI-
nM U( a [ e[ U5 S: a UR U5 OUR S5 [ U5 S:X d US S:w a' Ub$ UR! [# UR$ 5 5 [ U5 $ )a Convert text into a Name object.
*text*, a ``bytes`` or ``str``, 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``.
r z%input to from_text() must be a stringrv r Fr @ .r3 r rw r \Tr )rf r r r| r~ rg r r r9 r: ry rs r0 r r, r5 r7 r6 r )
rl r* r% r r^ rz r{ r rm byte_s
r from_textr s & $ D!! j9 9 {{7# dE " "@AA Nj 6 6899
F EHG
E t| 4<; AKKa(Ea< }} #E
1 #( ==?? 'RKESZ'EqLG !|#( T5!99 $ $ u:?$$
e$% ; < O u:> MM% MM# F qF2J# -63E
d6==)* <r parserzdns.wire.Parserc / nU R nU R 5 U R 5 nUS:w a US: a! UR U R U5 5 ODUS: a8 US- S- U R 5 - nXB: a [
eUnU R
U5 O[ eU R 5 nUS:w a M UR S5 SSS5 [ U5 $ ! , ( d f N= f)a Convert possibly compressed wire format into a Name.
*parser* is a dns.wire.Parser.
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``
r @ r r N) currentrestore_furthest get_uint8r5 get_bytesr3 seekr6 r )r r biggest_pointercountr s r from_wire_parserr . s F nnO " "qjrz
f . .u 56# 4<3.1A1A1CC-$$") G$""$$&E qj
c
# <
# "s BC 9C
C+messager c [ U [ 5 ( d [ S5 e[ R R X5 n[
U5 nX2R U-
4$ )a2 Convert possibly compressed wire format into a Name.
*message* is a ``bytes`` 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 string)rf rg r rS wireParserr r )r r r rT s r from_wirer O sK & gu % %EFF
XX__W
.F F #D ..7* ++r r [c 4 [ R " S U S5 $ )Nc $ U [ U5 - S- $ )Nr )r )vr s r _wire_length..u s SVa r r ) functoolsreducer s r _wire_lengthr t s 7 CCr c B S[ U R 5 -
n/ nUS: a% UR [ S- 5 US- nUS: a M% US: a UR [ US-
- 5 [ [ U5 5 nUR
U R 5 [ U5 $ )Nr r r r r )r r r5 _MAXIMAL_OCTETr6 reversedr7 r )rT needed
new_labelss r _pad_to_max_namer x s
< ,
,FJ
2+.2-." 2+ {.FQJ78 hz*+Jdkk"
r c [ U 5 nS[ U5 -
U-
S-
nUS:: a U $ [ SU-
U5 nU [ U- - $ )Nr r r r )r r minr )r^
suffix_labelslength remainingr s r _pad_to_max_labelr sP
ZFl=11F:Q>IA~
fi
(F >F* **r rT rg c X:X a [ U 5 $ U S nU[ :X a U R 5 $ US nU R SS nU[ :X a US S /nOA[ U5 nUS nU[ :X a [ nOUS- nXS' [ U5 n[ X55 /nUR U5 [ U5 n U( a [ U 5 $ U $ )Nr r r ) r _MINIMAL_OCTETre r _MINIMAL_OCTET_VALUEr4 _LEFT_SQUARE_BRACKET_VALUE_AT_SIGN_VALUErg r r7 r ) rT r* rg least_significant_label least_octetr r octetsoctets r rj rj s ~ %% "1g .0{{} )"-KKKOM**-cr23
23r
. ."E QJEr
"'- '(?OP
m$
D %% r c U( a [ R U 5 $ X:w Ga U S n[ U5 S: aH U[ - /nUR U R SS 5 [ R R U5 $ [ U5 n[ [ U5 S-
SS5 Hh nXV nU[ :X a M U[ :X a [ nOUS-
nXuU' [ US US- 5 /nUR U R SS 5 [ U5 s $ U R! 5 n X:w a GM U$ ! [ a GNf = f! [ R R a Nf = f)Nr r r r )_SUCCESSOR_PREFIXrJ r< r r r7 r rS rT r r4 range_MAXIMAL_OCTET_VALUEr r rg re )rT r* rg r r r r r s r ro ro sb $006 6 ."&q' & '" , 2NBCJ dkk!"o .
xx}}Z00
23 s6{QB/AIE,, &2
1I wQ01J dkk!"o .
# #+ 00 {{}W .^ Mc 88''
s# D* ! D; *
D87D8; E E functionc UR 5 ( d [ eUR 5 ( + nU( a UR U5 nO UR U5 ( d [ eU " XU5 nU( a UR U5 nU$ r )r r9 r^ r r\ rN )r rT r* rg relative result_names r ri ri sy &&##%%H (
v
&
&##43K!,,V4 r )ar$ r encodings.idnar r r9 typingr r r r r r r
dns._featuresrS dns.enum
dns.exception
dns.immutabledns.wire _featureshaver
r rs rt enumIntEnumr
r%
NAMERELN_NONEr& NAMERELN_SUPERDOMAINr' NAMERELN_SUBDOMAINr( NAMERELN_EQUALr NAMERELN_COMMONANCESTOR exception SyntaxErrorr, r0 FormErrorr3 r6 DNSExceptionr9 r< r@ rC rF rI rL r\ rh rj rg r ro rq r r r' IDNA_2003_Strictrx IDNA_2008_PracticalIDNA_2008_UTS_46IDNA_2008_StrictIDNA_2008_Transitional IDNA_2008r r immutabler rd rU r| r r r r r r rk r r r r r r r r r rj ro ri r r r r s $
H H H ==f NNFCK 388## 6 !!
#// !++ ##&55 ** C
)) CH (( H=3==** =Ds}} 9 9 D
+#--)) ++3==,, ++CMM 6 6 +
s}}))
++
*CMM.. *YCMM 6 6 Y
U5#:& 3 :$ $0!2I !2HH2I H2V $E* & #D%u= ueU; ud; &tT5%@ U5#: . 4 <
E%*$5
%
OY OY OYf SE{
R )-PTJ
J ~J:B9:MJ JZs t "&*T
s
T TNT #T
Tt . 4 B,u ,s ,uT3Y/? ,8 >* .)* >* S X D
+ d t B;d ;D ;T ;d ;|dD)4/0
r