/usr/lib/rads/venv/lib/python3.13/site-packages/dns/__pycache__
Edit: /usr/lib/rads/venv/lib/python3.13/site-packages/dns/__pycache__/zone.cpython-313.pyc (66218B)
jv S r SSKrSSKrSSKrSSKrSSKJrJrJrJ r J
r
J r J r J
r
JrJr SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK rSSK rSSK rSSK rSSK rSSK!J"r"J#r#J$r$ " S S\RJ RL 5 r' " S S\'5 r( " S S
\'5 r) " S S \'5 r* " S
S\RJ RL 5 r+ " S S\RJ RL 5 r, " S S\RJ RL 5 r- " S S\RJ RL 5 r.S\R^ R` S\ \R^ R` S\1S\R^ R` 4S jr2 " S S\Rf Rh 5 r5 " S S \Rl Rn 5 r8\Rr Rr " S S \85 5 r: " S S!5 r; " S" S#\;5 r<\Rr Rr " S$ S%\;5 5 r= " S& S'\Rf R| 5 r>S\R~ R S(\5SS)S(SS(4 S*\S\ \\R^ R` \A4 S+\R~ R S\1S,\S-\ \A S.\1S/\1S0\ \R^ R S1\\1\\A 4 S\54S2 jjrDS\R~ R S(\5SS)S(SS(4 S*\AS\ \\R^ R` \A4 S+\R~ R S\1S,\S-\ \A S.\1S/\1S0\ \R^ R S1\\1\\A 4 S\54S3 jjrES\R~ R S(\5SS(S(SS(4 S4\S\ \\R^ R` \A4 S+\R~ R S\1S,\S-\ \A S.\1S/\1S0\ \R^ R S1\\1\\A 4 S\54S5 jjrF\5S(S(4S6\S,\S\1S/\1S\54
S7 jjrGg)8z
DNS Zones. N)
AnyCallableIterableIteratorListMutableMappingOptionalSetTupleUnion)DigestHashAlgorithm DigestScheme_digest_hashersc \ rS rSrSrSrg)BadZone8 zThe DNS zone is malformed. N__name__
__module__ __qualname____firstlineno____doc____static_attributes__r ;/usr/lib/rads/venv/lib/python3.13/site-packages/dns/zone.pyr r 8 s $r r c \ rS rSrSrSrg)NoSOA< z)The DNS zone has no SOA RR at its origin.r Nr r r r r r < s 3r r c \ rS rSrSrSrg)NoNS@ z+The DNS zone has no NS RRset at its origin.r Nr r r r r! r! @ s 5r r! c \ rS rSrSrSrg)
UnknownOriginD z!The DNS zone's origin is unknown.r Nr r r r r$ r$ D s +r r$ c \ rS rSrSrSrg)UnsupportedDigestSchemeH z(The zone digest's scheme is unsupported.r Nr r r r r' r' H 2r r' c \ rS rSrSrSrg) UnsupportedDigestHashAlgorithmL z(The zone digest's origin is unsupported.r Nr r r r r+ r+ L r) r r+ c \ rS rSrSrSrg)NoDigestP z/The DNS zone has no ZONEMD RRset at its origin.r Nr r r r r. r. P s 9r r. c \ rS rSrSrSrg)DigestVerificationFailureT z#The ZONEMD digest failed to verify.r Nr r r r r1 r1 T s -r r1 nameorigin
relativizereturnc R Uc [ S5 eU R 5 ( a; U R U5 ( d [ S5 eU( a U R U5 n U $ U R U5 nU( d Un U $ ! [
R R a [ S5 ef = f)Nzno zone origin is definedz5name parameter must be a subdomain of the zone originz relative name too long for zone)KeyError is_absolute is_subdomainr5 derelativizednsr3 NameTooLong)r3 r4 r5 abs_names r _validate_namer? X s ~ 233 ((RS S ??6*D K >((0H
D K xx## > <= = >s A< <*B&c \ rS rSr% Sr\R R r\ / \R R 4 \
S' \ r \ / \
\R R \R R 4 4 \
S' Sr\\ / S4 \
S' Sr\\ / S4 \
S ' / S
Qr\R( R* S 4S \\\R R \4 S
\R( R0 S\4S jjrS rS r S\\R R \4 S\R R 4S jr S r S r S r S r!S r"S r#S r$S r%S r& SHS\\R R \4 S \S\R R 4S jjr' SHS\\R R \4 S \S\\R R 4S! jjr(S\\R R \4 SS4S" jr)\RT RV S 4S\\R R \4 S#\\RT RX \4 S$\\RT RX \4 S \S\RZ R\ 4
S% jjr/\RT RV S 4S\\R R \4 S#\\RT RX \4 S$\\RT RX \4 S \S\\RZ R\ 4
S& jjr0\RT RV 4S\\R R \4 S#\\RT RX \4 S$\\RT RX \4 SS4S' jjr1S\\R R \4 S(\RZ R\ SS4S) jr2\RT RV 4S\\R R \4 S#\\RT RX \4 S$\\RT RX \4 S\Rf Rh 4S* jjr5\RT RV 4S\\R R \4 S#\\RT RX \4 S$\\RT RX \4 S\\Rf Rh 4S+ jjr6\RT Rn \RT RV 4S#\\RT RX \4 S$\\RT RX \4 S\8\9\R R \RZ R\ 4 4S, jjr:\RT Rn \RT RV 4S#\\RT RX \4 S$\\RT RX \4 S\8\9\R R \;\Rx Rz 4 4S- jjr> SIS.\?S/\S\S0\\ S1\S2\SS4S3 jjr@ SIS/\S\S0\\ S1\S2\S\4 S4 jjrASJS5 jrB SKS6\\R R S\R Rn R R 4S7 jjrG\HR 4S8\JS9\HS\K4S: jjrL\HR 4S8\JS9\HS\R Rn R R 4S; jjrN SKS<\\R Rn R R SS4S= jjrOSLS? jrPSHS(\SS>4S@ jjrQS\9\\R R \\\R R 4 4SA jrRSB rSSC rTSD rUSE rVSF rWSGrXg)MZonex a^ A DNS zone.
A ``Zone`` is a mapping from names to nodes. The zone object may be
treated like a Python dictionary, e.g. ``zone[name]`` will retrieve
the node associated with that name. The *name* may be a
``dns.name.Name object``, or it may be a string. In either case,
if the name is relative it is treated as relative to the origin of
the zone.
node_factory map_factoryNWritableVersionwritable_version_factoryImmutableVersionimmutable_version_factory)rdclassr4 nodesr5 Tr4 rI r5 c j Ub [ U[ 5 ( a [ R R U5 nO4[ U[ R R
5 ( d [
S5 eUR 5 ( d [
S5 eXl X l U R 5 U l X0l g)a Initialize a zone object.
*origin* is the origin of the zone. It may be a ``dns.name.Name``,
a ``str``, or ``None``. If ``None``, then the zone's origin will
be set by the first ``$ORIGIN`` line in a zone file.
*rdclass*, an ``int``, the zone's rdata class; the default is class IN.
*relativize*, a ``bool``, determine's whether domain names are
relativized to the zone's origin. The default is ``True``.
Nz2origin parameter must be convertible to a DNS namez)origin parameter must be an absolute name)
isinstancestrr< r3 from_textName
ValueErrorr9 r4 rI rD rJ r5 )selfr4 rI r5 s r __init__
Zone.__init__ s $ &#&& ++F3
66 !UVV%%'' !LMM CGCSCSCU
$r c [ U[ 5 ( d gU R UR :w d4 U R UR :w d U R UR :w a gg)zYTwo zones are equal if they have the same origin, class, and
nodes.
Returns a ``bool``.
FT)rL rA rI r4 rJ rQ others r __eq__ Zone.__eq__ sJ %&& LLEMM ){{ell*zzU[[(r c . U R U5 ( + $ )z.Are two zones not equal?
Returns a ``bool``.
)rW rU s r __ne__ Zone.__ne__ s ;;u%%%r r3 r6 c [ U[ 5 ( a! [ R R US 5 nO4[ U[ R R
5 ( d [
S5 e[ XR U R 5 $ )Nz0name parameter must be convertible to a DNS name)
rL rM r< r3 rN rO r8 r? r4 r5 rQ r3 s r r? Zone._validate_name s] dC 88%%dD1DD#((--00MN N dKK AAr c B U R U5 nU R U $ Nr? rJ rQ keys r __getitem__Zone.__getitem__ s !!#&zz# r c B U R U5 nX R U' g r` ra )rQ rc values r __setitem__Zone.__setitem__ s !!#&
3r c @ U R U5 nU R U g r` ra rb s r __delitem__Zone.__delitem__ s !!#& JJsOr c 6 U R R 5 $ r` )rJ __iter__rQ s r rn
Zone.__iter__ s zz""$$r c 6 U R R 5 $ r` rJ keysro s r rs Zone.keys zz r c 6 U R R 5 $ r` )rJ valuesro s r rw Zone.values s zz ""r c 6 U R R 5 $ r` rJ itemsro s r r{
Zone.items zz !!r c Z U R U5 nU R R U5 $ r` r? rJ getrb s r r Zone.get s% !!#&zz~~c""r c @ U R U5 nXR ; $ r` ra rb s r __contains__Zone.__contains__ s !!#&jj r Fcreatec U R U5 nU R R U5 nUc+ U( d [ eU R 5 nX0R U' U$ )a Find a node in the zone, possibly creating it.
*name*: the name of the node to find.
The value may be a ``dns.name.Name`` or a ``str``. If absolute, the
name must be a subdomain of the zone's origin. If ``zone.relativize``
is ``True``, then the name will be relativized.
*create*, a ``bool``. If true, the node will be created if it does
not exist.
Raises ``KeyError`` if the name is not known and create was
not specified, or if the name was not a subdomain of the origin.
Returns a ``dns.node.Node``.
)r? rJ r r8 rC rQ r3 r nodes r find_nodeZone.find_node sR & ""4(zz~~d# < $$&D #JJt r c P U R X5 nU$ ! [ a Sn U$ f = f)a( Get a node in the zone, possibly creating it.
This method is like ``find_node()``, except it returns None instead
of raising an exception if the node does not exist and creation
has not been requested.
*name*: the name of the node to find.
The value may be a ``dns.name.Name`` or a ``str``. If absolute, the
name must be a subdomain of the zone's origin. If ``zone.relativize``
is ``True``, then the name will be relativized.
*create*, a ``bool``. If true, the node will be created if it does
not exist.
Returns a ``dns.node.Node`` or ``None``.
N)r r8 r s r get_node
Zone.get_node s7 ( >>$/D D s %%c ` U R U5 nXR ; a U R U gg)a; Delete the specified node if it exists.
*name*: the name of the node to find.
The value may be a ``dns.name.Name`` or a ``str``. If absolute, the
name must be a subdomain of the zone's origin. If ``zone.relativize``
is ``True``, then the name will be relativized.
It is not an error if the node does not exist.
Nra r] s r delete_nodeZone.delete_node s/ ""4( ::
4 r rdtypecoversc $ U R U5 n[ R R R U5 n[ R R R U5 nU R X5 nUR
U R X#U5 $ )a Look for an rdataset with the specified name and type in the zone,
and return an rdataset encapsulating it.
The rdataset returned is not a copy; changes to it will change
the zone.
KeyError is raised if the name or type are not found.
*name*: the name of the node to find.
The value may be a ``dns.name.Name`` or a ``str``. If absolute, the
name must be a subdomain of the zone's origin. If ``zone.relativize``
is ``True``, then the name will be relativized.
*rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired.
*covers*, a ``dns.rdatatype.RdataType`` or ``str`` the covered type.
Usually this value is ``dns.rdatatype.NONE``, but if the
rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
then the covers value will be the rdata type the SIG/RRSIG
covers. The library treats the SIG and RRSIG types as if they
were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA).
This makes RRSIGs much easier to work with than if RRSIGs
covering different rdata types were aggregated into a single
RRSIG rdataset.
*create*, a ``bool``. If true, the node will be created if it does
not exist.
Raises ``KeyError`` if the name is not known and create was
not specified, or if the name was not a subdomain of the origin.
Returns a ``dns.rdataset.Rdataset``.
)r? r< rdatatype RdataTypemaker
find_rdatasetrI )rQ r3 r r r r s r r Zone.find_rdataset/ sp R ""4( ((--f5 ((--f5~~d+!!$,,GGr c R U R XX45 nU$ ! [ a Sn U$ f = f)a] Look for an rdataset with the specified name and type in the zone.
This method is like ``find_rdataset()``, except it returns None instead
of raising an exception if the rdataset does not exist and creation
has not been requested.
The rdataset returned is not a copy; changes to it will change
the zone.
*name*: the name of the node to find.
The value may be a ``dns.name.Name`` or a ``str``. If absolute, the
name must be a subdomain of the zone's origin. If ``zone.relativize``
is ``True``, then the name will be relativized.
*rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired.
*covers*, a ``dns.rdatatype.RdataType`` or ``str``, the covered type.
Usually this value is ``dns.rdatatype.NONE``, but if the
rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
then the covers value will be the rdata type the SIG/RRSIG
covers. The library treats the SIG and RRSIG types as if they
were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA).
This makes RRSIGs much easier to work with than if RRSIGs
covering different rdata types were aggregated into a single
RRSIG rdataset.
*create*, a ``bool``. If true, the node will be created if it does
not exist.
Raises ``KeyError`` if the name is not known and create was
not specified, or if the name was not a subdomain of the origin.
Returns a ``dns.rdataset.Rdataset`` or ``None``.
N)r r8 )rQ r3 r r r rdatasets r get_rdatasetZone.get_rdataset^ s< T ))$GH H &&c n U R U5 n[ R R R U5 n[ R R R U5 nU R U5 nUb> UR
U R X#5 [ U5 S:X a U R U5 ggg)aG Delete the rdataset matching *rdtype* and *covers*, if it
exists at the node specified by *name*.
It is not an error if the node does not exist, or if there is no matching
rdataset at the node.
If the node has no rdatasets after the deletion, it will itself be deleted.
*name*: the name of the node to find. The value may be a ``dns.name.Name`` or a
``str``. If absolute, the name must be a subdomain of the zone's origin. If
``zone.relativize`` is ``True``, then the name will be relativized.
*rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired.
*covers*, a ``dns.rdatatype.RdataType`` or ``str`` or ``None``, the covered
type. Usually this value is ``dns.rdatatype.NONE``, but if the rdtype is
``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, then the covers value will be
the rdata type the SIG/RRSIG covers. The library treats the SIG and RRSIG types
as if they were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). This
makes RRSIGs much easier to work with than if RRSIGs covering different rdata
types were aggregated into a single RRSIG rdataset.
Nr )
r? r< r r r r delete_rdatasetrI lenr rQ r3 r r r s r r Zone.delete_rdataset s : ""4( ((--f5 ((--f5}}T" v >4yA~ & r replacementc UR U R :w a [ S5 eU R US5 nUR U5 g)ak Replace an rdataset at name.
It is not an error if there is no rdataset matching I{replacement}.
Ownership of the *replacement* object is transferred to the zone;
in other words, this method does not store a copy of *replacement*
at the node, it stores *replacement* itself.
If the node does not exist, it is created.
*name*: the name of the node to find.
The value may be a ``dns.name.Name`` or a ``str``. If absolute, the
name must be a subdomain of the zone's origin. If ``zone.relativize``
is ``True``, then the name will be relativized.
*replacement*, a ``dns.rdataset.Rdataset``, the replacement rdataset.
z#replacement.rdclass != zone.rdclassTN)rI rP r replace_rdataset)rQ r3 r r s r r Zone.replace_rdataset s@ * $,, . BC C~~dD) k*r c U R U5 n[ R R R U5 n[ R R R U5 nU R
U R
U R X#5 n[ R R X@R X#5 nUR U5 U$ )a Look for an rdataset with the specified name and type in the zone,
and return an RRset encapsulating it.
This method is less efficient than the similar
``find_rdataset()`` because it creates an RRset instead of
returning the matching rdataset. It may be more convenient
for some uses since it returns an object which binds the owner
name to the rdataset.
This method may not be used to create new nodes or rdatasets;
use ``find_rdataset`` instead.
*name*: the name of the node to find.
The value may be a ``dns.name.Name`` or a ``str``. If absolute, the
name must be a subdomain of the zone's origin. If ``zone.relativize``
is ``True``, then the name will be relativized.
*rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired.
*covers*, a ``dns.rdatatype.RdataType`` or ``str``, the covered type.
Usually this value is ``dns.rdatatype.NONE``, but if the
rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
then the covers value will be the rdata type the SIG/RRSIG
covers. The library treats the SIG and RRSIG types as if they
were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA).
This makes RRSIGs much easier to work with than if RRSIGs
covering different rdata types were aggregated into a single
RRSIG rdataset.
*create*, a ``bool``. If true, the node will be created if it does
not exist.
Raises ``KeyError`` if the name is not known and create was
not specified, or if the name was not a subdomain of the origin.
Returns a ``dns.rrset.RRset`` or ``None``.
) r? r< r r r rJ r rI rrsetRRsetupdate)rQ r3 r r vnamer r s r
find_rrsetZone.find_rrset s X ##D) ((--f5 ((--f5::e$224<<P ||VD
X r c R U R XU5 nU$ ! [ a Sn U$ f = f)af Look for an rdataset with the specified name and type in the zone,
and return an RRset encapsulating it.
This method is less efficient than the similar ``get_rdataset()``
because it creates an RRset instead of returning the matching
rdataset. It may be more convenient for some uses since it
returns an object which binds the owner name to the rdataset.
This method may not be used to create new nodes or rdatasets;
use ``get_rdataset()`` instead.
*name*: the name of the node to find.
The value may be a ``dns.name.Name`` or a ``str``. If absolute, the
name must be a subdomain of the zone's origin. If ``zone.relativize``
is ``True``, then the name will be relativized.
*rdtype*, a ``dns.rdataset.Rdataset`` or ``str``, the rdata type desired.
*covers*, a ``dns.rdataset.Rdataset`` or ``str``, the covered type.
Usually this value is ``dns.rdatatype.NONE``, but if the
rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
then the covers value will be the rdata type the SIG/RRSIG
covers. The library treats the SIG and RRSIG types as if they
were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA).
This makes RRSIGs much easier to work with than if RRSIGs
covering different rdata types were aggregated into a single
RRSIG rdataset.
*create*, a ``bool``. If true, the node will be created if it does
not exist.
Returns a ``dns.rrset.RRset`` or ``None``.
N)r r8 )rQ r3 r r r s r get_rrsetZone.get_rrset s: P OOD&9E E r c # # [ R R R U5 n[ R R R U5 nU R 5 HU u p4U HJ nU[ R R
:X d$ UR U:X d M3 UR U:X d ME X54v ML MW g7f)a" Return a generator which yields (name, rdataset) tuples for
all rdatasets in the zone which have the specified *rdtype*
and *covers*. If *rdtype* is ``dns.rdatatype.ANY``, the default,
then all rdatasets will be matched.
*rdtype*, a ``dns.rdataset.Rdataset`` or ``str``, the rdata type desired.
*covers*, a ``dns.rdataset.Rdataset`` or ``str``, the covered type.
Usually this value is ``dns.rdatatype.NONE``, but if the
rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
then the covers value will be the rdata type the SIG/RRSIG
covers. The library treats the SIG and RRSIG types as if they
were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA).
This makes RRSIGs much easier to work with than if RRSIGs
covering different rdata types were aggregated into a single
RRSIG rdataset.
N)r< r r r r{ ANYr r )rQ r r r3 r rdss r iterate_rdatasetsZone.iterate_rdatasets0 s . ((--f5 ((--f5 **,JDS]] . ..JJ&(SZZ6-A +% 's BB? B?1B?c # # [ R R R U5 n[ R R R U5 nU R 5 Hi u p4U H^ nU[ R R
:X d$ UR U:X d M3 UR U:X d ME U H nX5R U4v M M` Mk g7f)a Return a generator which yields (name, ttl, rdata) tuples for
all rdatas in the zone which have the specified *rdtype*
and *covers*. If *rdtype* is ``dns.rdatatype.ANY``, the default,
then all rdatas will be matched.
*rdtype*, a ``dns.rdataset.Rdataset`` or ``str``, the rdata type desired.
*covers*, a ``dns.rdataset.Rdataset`` or ``str``, the covered type.
Usually this value is ``dns.rdatatype.NONE``, but if the
rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
then the covers value will be the rdata type the SIG/RRSIG
covers. The library treats the SIG and RRSIG types as if they
were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA).
This makes RRSIGs much easier to work with than if RRSIGs
covering different rdata types were aggregated into a single
RRSIG rdataset.
N) r< r r r r{ r r r ttl)rQ r r r3 r r rdatas r iterate_rdatasZone.iterate_rdatasP s . ((--f5 ((--f5 **,JDS]] . ..JJ&(SZZ6-A!$ #WWe 44 "% 's BC C1"Cfsortednl
want_comments want_originc \ [ U[ 5 ( a
[ US5 nO[ R " U5 nU n[ USS5 nUc SnUc" [ R R U5 n SnO9[ U[ 5 ( a UR U5 n OUn UR 5 nU( a` U R c eSU R R 5 - n
U
R U5 n UR U 5 UR U 5 U( a* [ U R 5 5 n U R! 5 OU R 5 n U HU n
X
R U
U R UUS9n
U
R U5 n UR U 5 UR U 5 MW SSS5 g! [ a% UR U
5 UR U5 Nf = f! [ a& UR U
5 UR U5 M f = f! , ( d f g= f)a Write a zone to a file.
*f*, a file or `str`. If *f* is a string, it is treated
as the name of a file to open.
*sorted*, a ``bool``. If True, the default, then the file
will be written with the names sorted in DNSSEC order from
least to greatest. Otherwise the names will be written in
whatever order they happen to have in the zone's dictionary.
*relativize*, a ``bool``. If True, the default, then domain
names in the output will be relativized to the zone's origin
if possible.
*nl*, a ``str`` or None. The end of line string. If not
``None``, the output will use the platform's native
end-of-line marker (i.e. LF on POSIX, CRLF on Windows).
*want_comments*, a ``bool``. If ``True``, emit end-of-line comments
as part of writing the file. If ``False``, the default, do not
emit them.
*want_origin*, a ``bool``. If ``True``, emit a $ORIGIN line at
the start of the file. If ``False``, the default, do not emit
one.
wbencodingNzutf-8
z$ORIGIN )r4 r5 r )rL rM open
contextlib nullcontextgetattroslinesepencodedecoder4 to_textwrite TypeErrorlistrs sort)rQ r r r5 r r r cmfile_encnl_bll_bnamesns r to_file Zone.to_fileq s H a 48DMB''*B
1 q*d3H "zzz((2B$$yy*YY[{{... !4!4!66hhx( GGCLGGDM
TYY[)
GOO ;; )"/ $ hhx( GGCLGGDM C R0 ! GGAJGGBK * ! GGAJGGBK [ RsU B5H 1"F8A5H "G*+H 8,G'$H &G''H *,HH HH
H+c [ R " 5 nU R XaX#XE5 UR 5 nUR 5 U$ )a Return a zone's text as though it were written to a file.
*sorted*, a ``bool``. If True, the default, then the file
will be written with the names sorted in DNSSEC order from
least to greatest. Otherwise the names will be written in
whatever order they happen to have in the zone's dictionary.
*relativize*, a ``bool``. If True, the default, then domain
names in the output will be relativized to the zone's origin
if possible.
*nl*, a ``str`` or None. The end of line string. If not
``None``, the output will use the platform's native
end-of-line marker (i.e. LF on POSIX, CRLF on Windows).
*want_comments*, a ``bool``. If ``True``, emit end-of-line comments
as part of writing the file. If ``False``, the default, do not
emit them.
*want_origin*, a ``bool``. If ``True``, emit a $ORIGIN line at
the start of the output. If ``False``, the default, do not emit
one.
Returns a ``str``.
)ioStringIOr getvalueclose)rQ r r5 r r r temp_buffer return_values r r Zone.to_text s@ B kkm [*-U"++- r c V U R ( a [ R R nOU R c eU R nU R U[ R R 5 c [ eU R U[ R R 5 c [ eg)zDo some simple checking of the zone's origin.
Raises ``dns.zone.NoSOA`` if there is no SOA RRset.
Raises ``dns.zone.NoNS`` if there is no NS RRset.
Raises ``KeyError`` if there is no origin node.
N) r5 r< r3 emptyr4 r r SOAr NSr! r] s r check_originZone.check_origin sz ??88>>D;;* **;;D T3==#4#4 5 =K T3==#3#3 4 <J =r txnc l U R ( a [ R R nO U R c [
eU R nU( a+ UR
U[ R R 5 nO*U R U[ R R 5 nUc [
eUS $ )z{Get the zone SOA rdata.
Raises ``dns.zone.NoSOA`` if there is no SOA RRset.
Returns a ``dns.rdtypes.ANY.SOA.SOA`` Rdata.
r )
r5 r< r3 r r4 r r r r r )rQ r origin_namesoas r get_soa Zone.get_soa s~ ?? ((..K{{" ++K ''+s}}'8'89C##K 1B1BCC ;K1v
r hash_algorithmschemec [ R " U5 nU( d [ eU[ R :w a [
eU R ( a [ R R nOU R c eU R nU" 5 n[ U R 5 5 GH u pgUR U R 5 n[ US S9 H n Xd:X a6 [ R R U R U R" 4; a M> [$ R& " SU R U R( U R* 5 n
U V s/ s H oR U R 5 PM n n [ U 5 H< n [$ R& " S[- U 5 5 n
UR/ X- U
- U - 5 M> M GM UR1 5 $ s sn f )Nc 2 U R U R 4$ r` )r r )r s r
&Zone._compute_digest..1 s #**cjj9Qr )rc z!HHIz!H)r r r+ r SIMPLEr' r5 r< r3 r r4 r r{
to_digestabler ZONEMDr r structpackrI r r r digest)rQ r r hashinfor hasherr3 r rrnamebufr rrfixedr rdatasrrlens r _compute_digestZone._compute_digest sl
#&&~60 0 \(( () ) ?? ((..K;;* ** ++K .JD **4;;7I "4-Q R&3==+?+? OO OOD , ++HOOX-=-=x|| IQQu--dkk:Q #F^E "KKc%j 9EMM)"5"="EF , S / }} Rs
$Gc U R 5 R nU R X5 n[ R R
R R
U R [ R R X2X5 $ r` ) r serialr r< rdtypesr r rI r )rQ r r r r s r compute_digestZone.compute_digest@ s]
&&%%n={{%%,, LL#--..
r zonemdc d U( a U/nONU R c eU R U R [ R R 5 nUc [
eUnU H; n U R
UR UR 5 nXTR :X a g M= [ e! [ a MR f = fr` ) r4 r r< r r r. r r r r Exceptionr1 )rQ r digestsr r computeds r
verify_digestZone.verify_digestK s hG;;* **##DKK 1E1EFC{ G F
//0E0Ev}}U}}, - ('
s 5B!!
B/.B/ Transactionc
\ [ U S[ U SU R U R 5 5 $ )NF )r VersionrJ r4 ro s r reader Zone.readerb s$ 4aT[[(QRRr c < [ X5 nUR 5 U$ r` )r _setup_version)rQ r r s r writer Zone.writere s $,
r c U R ( a [ R R nO U R nU R U R U4$ r` )r5 r< r3 r r4 )rQ effectives r origin_informationZone.origin_informationj s6 ??I I T__i88r c U R $ r` )rI ro s r get_classZone.get_classt s ||r c g r` r rQ r s r _end_readZone._end_ready r c g r` r r s r
_end_writeZone._end_write| r# r c N UR U l U R c X0l g g r` )rJ r4 )rQ _versionr4 s r _commit_versionZone._commit_version s! ]]
;; K r c g)Nr r ro s r _get_next_version_idZone._get_next_version_id s r )rJ r4 rI r5 F)TTNFF)r6 Nr` )r6 r )Yr r r r r r< r NoderC r __annotations__dictrD r r3 rO rF r rH __slots__
rdataclassINr rM
RdataClassboolrR rW rZ r? rd rh rk rn rs rw r{ r r r r r r NONEr r Rdatasetr r r r r r r r r r r r intr Rdatar r r r r transactionr r r r r r r
bytesr r r r r r r r r! r% r* r- r r r r rA rA x s 14
L(2sxx}},-=NRK"nSXX]]CHHMM-I JJKRJN hx4E0E'F GNLP x5G1G(H IP-> %sxx}}c 123 % ** % %<"&B5 );#< B B %!#"#!
?D#((--,-7; : ?D#((--,-7; #((-- 4
!chhmmS&8 9
!d
!& 7:mm6H6H -HCHHMM3&'-H cmm--s23-H cmm--s23 -H
-H
-Hf 7:mm6H6H .CHHMM3&'. cmm--s23. cmm--s23 .
.
#,,'' (
.h 7:mm6H6H $'CHHMM3&'$' cmm--s23$' cmm--s23 $'
$'L+#((--,-+ &D 7:mm6G6G69mm6H6H 5cmm--s23 5 cmm--s23 5
%
sCIIOO;< = 5H # !W W W W
SM W
W W
W v # !
% % %
SM %
%
%
% N( <@COO 7 78 : , 2 2 +
J , 2 2
+
& &
AE( s{{ 5 5 < <=(
(.S$ =
9 x
&hsxx}}.EE F9
!
r rA c . ^ \ rS rSrS/rU 4S jrSrU =r$ )
VersionedNodei idc 0 > [ TU ] 5 SU l g Nr )superrR r@ )rQ __class__s r rR VersionedNode.__init__ s
r )r@ )r r r r r3 rR r
__classcell__rD s @r r? r? s I r r? c ^ \ rS rSrU 4S jr\R R S4S\R R S\R R S\R R S\ S\R R 4
U 4S jjjr\R R S4S\R R S\R R S\R R S\ S\\R R 4
U 4S
jjjr\R R 4S\R R S\R R S\R R SS 4S jjrS
\R R SS 4S jrS\ 4S jrSrU =r$ )ImmutableVersionedNodei c > [ TU ] 5 UR U l [ UR Vs/ s H" n[
R R U5 PM$ sn5 U l g s snf r` )rC rR r@ tuple rdatasetsr< r ImmutableRdataset)rQ r r rD s r rR ImmutableVersionedNode.__init__ sM
'' <@NN KNSS\\
+
+C
0N K
Ks )A*FrI r r r r6 c J > U( a [ S5 e[ TU ] XUS5 $ N immutableF)r rC r rQ rI r r r rD s r r $ImmutableVersionedNode.find_rdataset s' K( (w$WfeDDr c J > U( a [ S5 e[ TU ] XUS5 $ rP )r rC r rR s r r #ImmutableVersionedNode.get_rdataset s' K( (w#GVUCCr Nc [ S5 eNrQ r )rQ rI r r s r r &ImmutableVersionedNode.delete_rdataset s $$r r c [ S5 erW rX )rQ r s r r 'ImmutableVersionedNode.replace_rdataset s
$$r c gNTr ro s r is_immutable#ImmutableVersionedNode.is_immutable s r )r@ rL )r r r r rR r< r r8 r4 r6 r r7 r r9 r r r r r r^ r rF rG s @r rI rI s
+.--*<*< E ** E
'' E
'' E
E
E E +.--*<*< D ** D
'' D
'' D
D
#,,'' (
D D +.--*<*< % **%
''%
'' %
%%CLL,A,A %d %d r rI c
Z \ rS rSr SS\S\S\\\R R \R R 4 S\\R R 4S jjr
S\R R S \R R 4S
jrS\R R S \\R R 4S jrS\R R S \R R" S
\R R" S \\R$ R& 4S jrS rS rSrg)r i Nzoner@ rJ r4 c f Xl X l Ub X0l OUR 5 U l X@l g r` )ra r@ rJ rD r4 )rQ ra r@ rJ r4 s r rR Version.__init__ s. J ))+DJ r r3 r6 c V [ XR U R R 5 $ r` )r? r4 ra r5 r] s r r? Version._validate_name s dKK1E1EFFr c Z U R U5 nU R R U5 $ r` r r] s r r Version.get_node s% ""4(zz~~d##r r r c x U R U5 nUc g UR U R R X#5 $ r` )r r ra rI r s r r Version.get_rdataset s7 }}T" < !2!2FCCr c 6 U R R 5 $ r` rr ro s r rs Version.keys ru r c 6 U R R 5 $ r` rz ro s r r{
Version.items r} r )r@ rJ r4 ra )NN)r r r r rA r: r r r< r3 rO r r0 rR r? r r r r r9 r rs r{ r r r r r r s
IM*.
sxx}}chhmm'CDE
'
G388== GSXX]] G$SXX]] $x
/F $ Dhhmm D
'' D
'' D
#,,'' ( D!"r r c ^ \ rS rSrSS\S\4U 4S jjjrS\R R S\R R 4S jr S\R R SS4S jr
S\R R S
\R R SS4S jrS\R R S \R" R$ S
\R" R$ SS4S jrSrU =r$ )rE i ra r c > UR 5 n[ TU ] X5 U( d% U R R UR 5 UR
U l [
5 U l g r` )r- rC rR rJ r r4 setchanged)rQ ra r r@ rD s r rR WritableVersion.__init__ sQ
&
&
(
"
JJ djj ) kk +.5 r r3 r6 c U R U5 nU R R U5 nUb XR ; a U R R 5 n[
US5 ( a U R Ul Ub% UR R UR 5 X0R U' U R R U5 U$ U$ )Nr@ ) r? rJ r rq ra rC hasattrr@ rL extendadd)rQ r3 r new_nodes r
_maybe_cowWritableVersion._maybe_cow s ""4(zz~~d# <4||3yy--/Hx&& #gg ""))$..9 'JJt LL T "OKr Nc U R U5 nXR ; a) U R U U R R U5 g g r` )r? rJ rq rv r] s r r WritableVersion.delete_node s? ""4( ::
4 LL T " r r c H U R U5 nUR U5 g r` )rx r )rQ r3 r r s r put_rdataset WritableVersion.put_rdataset s t$ h'r r r c U R U5 nUR U R R X#5 [ U5 S:X a U R
U g g rB )rx r ra rI r rJ r s r r WritableVersion.delete_rdataset$ sH t$ TYY . .? t9>
4 r )rq r4 r/ )r r r r rA r7 rR r< r3 rO r r0 rx r r r9 r} r r r r rF rG s @r rE rE s 1T 1 1 1 sxx}} ,#
#$ # (HHMM(-0\\-B-B(
( !hhmm !
'' !
'' !
! !r rE c 0 ^ \ rS rSrS\4U 4S jjrSrU =r$ )rG i0 r) c > [ TU ] UR S5 UR U l UR U l UR
H? nUR R U5 nU( d M' [ U5 UR U' MA [ R R UR SU R R 5 U l g r] )
rC rR ra r@ r4 rq rJ r rI r< rQ DictrD )rQ r) r3 r rD s r rR ImmutableVersion.__init__2 s t,** nn OOD==$$T*Dt& US Ln[ TU ] XU5 X0l X@l g r` )rC rR r) make_immutable)rQ ra r r) r read_onlyrD s r rR Transaction.__init__I s' 4'
I6 ,r c U R $ r` )managerro s r ra Transaction.zoneO s ||r c U R b eU R R nUc [ nU" U R U R
5 U l g r` )r) r rF rE ra r )rQ factorys r r Transaction._setup_versionS sC ||###,,77 ?%G tyy$*:*:; r c : U R R XU5 $ r` )r) r rQ r3 r r s r
_get_rdatasetTransaction._get_rdatasetZ s ||((v>>r c ` U R ( a eU R R X5 g r` )r r) r} )rQ r3 r s r
_put_rdatasetTransaction._put_rdataset] s! >>!! !!$1r c ` U R ( a eU R R U5 g r` )r r) r r] s r _delete_nameTransaction._delete_namea s! >>!! &r c b U R ( a eU R R XU5 g r` )r r) r r s r _delete_rdataset Transaction._delete_rdatasete s# >>!! $$T6:r c < U R R U5 S L$ r` r) r r] s r _name_existsTransaction._name_existsi s ||$$T*$66r c j U R ( a g[ U R R 5 S: $ )NFr )r r r) rq ro s r _changedTransaction._changedl s& >>t||++,q0 0r c U R ( a U R R U 5 g U( a [ U R R
5 S: a U R ( a2 U R R nUc [ nU" U R 5 nO U R nU R R XU R R 5 g U R R U 5 g rB )
r ra r! r r) rq r r rH rG r* r4 r% )rQ commitr r) s r _end_transaction Transaction._end_transactionr s >> II %
DLL 0 01A5"" ,,@@? .G!$,,/ ,, II % %dT\\5H5H I
II &r c T U R R c XR l g g r` )r) r4 )rQ r4 s r _set_originTransaction._set_origin s! << &"(LL 'r c # n # U R R 5 H u pU H nX4v M
M g 7fr` )r) r{ )rQ r3 r r s r _iterate_rdatasets Transaction._iterate_rdatasets s1 ,,,,.JD && ! /s 35c 6 U R R 5 $ r` )r) rs ro s r _iterate_namesTransaction._iterate_names s || ""r c 8 U R R U5 $ r` r r] s r _get_nodeTransaction._get_node s ||$$T**r c U R R 5 u pnUcQ U R R b: U R R nU( a [ R
R nOUnXU4$ r` )r r r) r4 r< r3 r )rQ absoluter5 r s r _origin_information Transaction._origin_information s_ ,0LL,K,K,M)y 3 3 ? ||**H HHNN $ i00r )r r) )NF)r r r r rR propertyra r r r r r r r r r r r r r r rF rG s @r r r H sb - <?2';71 ' )'
#+
1
1r r TFtextrI zone_factoryfilename
allow_includer
idna_codecallow_directivesc
Uc SnU" XUS9n
U
R S5 n [ R R XUS9n [ R R U UU UU S9n
U
R
5 S S S 5 U( a U
R 5 U
$ ! [ R R a [ R R ef = f! , ( d f Nc= f)Nzr5 T)r )r r )
r r< tokenizer TokenizerzonefileReaderreadr$ ra r )r r4 rI r5 r r r r r r ra r tokr s r
_from_textr s & J ?D
T cmm%%d%L $$ ' - %
) KKM
K
||)) )(((( ( )
s A C
B9C
C
Cc
* [ U UUUUUUUUU 5
$ )a Build a zone object from a zone file format string.
*text*, a ``str``, the zone file format input.
*origin*, a ``dns.name.Name``, a ``str``, or ``None``. The origin
of the zone; if not specified, the first ``$ORIGIN`` statement in the
zone file will determine the origin of the zone.
*rdclass*, a ``dns.rdataclass.RdataClass``, the zone's rdata class; the default is
class IN.
*relativize*, a ``bool``, determine's whether domain names are
relativized to the zone's origin. The default is ``True``.
*zone_factory*, the zone factory to use or ``None``. If ``None``, then
``dns.zone.Zone`` will be used. The value may be any class or callable
that returns a subclass of ``dns.zone.Zone``.
*filename*, a ``str`` or ``None``, the filename to emit when
describing where an error occurred; the default is ``''``.
*allow_include*, a ``bool``. If ``True``, the default, then ``$INCLUDE``
directives are permitted. If ``False``, then encoutering a ``$INCLUDE``
will raise a ``SyntaxError`` exception.
*check_origin*, a ``bool``. If ``True``, the default, then sanity
checks of the origin node will be made by calling the zone's
``check_origin()`` method.
*idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA
encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder
is used.
*allow_directives*, a ``bool`` or an iterable of `str`. If ``True``, the default,
then directives are permitted, and the *allow_include* parameter controls whether
``$INCLUDE`` is permitted. If ``False`` or an empty iterable, then no directive
processing is done and any directive-like text will be treated as a regular owner
name. If a non-empty iterable, then only the listed directives (including the
``$``) are allowed.
Raises ``dns.zone.NoSOA`` if there is no SOA RRset.
Raises ``dns.zone.NoNS`` if there is no NS RRset.
Raises ``KeyError`` if there is no origin node.
Returns a subclass of ``dns.zone.Zone``.
)r )
r r4 rI r5 r r r r r r s
r rN rN s0 x r r c
[ U [ 5 ( a Uc U n[ U 5 n
O[ R " U 5 n
U
n [ U UUUUUUUUU 5
sSSS5 $ ! , ( d f O= f e)a Read a zone file and build a zone object.
*f*, a file or ``str``. If *f* is a string, it is treated
as the name of a file to open.
*origin*, a ``dns.name.Name``, a ``str``, or ``None``. The origin
of the zone; if not specified, the first ``$ORIGIN`` statement in the
zone file will determine the origin of the zone.
*rdclass*, an ``int``, the zone's rdata class; the default is class IN.
*relativize*, a ``bool``, determine's whether domain names are
relativized to the zone's origin. The default is ``True``.
*zone_factory*, the zone factory to use or ``None``. If ``None``, then
``dns.zone.Zone`` will be used. The value may be any class or callable
that returns a subclass of ``dns.zone.Zone``.
*filename*, a ``str`` or ``None``, the filename to emit when
describing where an error occurred; the default is ``''``.
*allow_include*, a ``bool``. If ``True``, the default, then ``$INCLUDE``
directives are permitted. If ``False``, then encoutering a ``$INCLUDE``
will raise a ``SyntaxError`` exception.
*check_origin*, a ``bool``. If ``True``, the default, then sanity
checks of the origin node will be made by calling the zone's
``check_origin()`` method.
*idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA
encoder/decoder. If ``None``, the default IDNA 2003 encoder/decoder
is used.
*allow_directives*, a ``bool`` or an iterable of `str`. If ``True``, the default,
then directives are permitted, and the *allow_include* parameter controls whether
``$INCLUDE`` is permitted. If ``False`` or an empty iterable, then no directive
processing is done and any directive-like text will be treated as a regular owner
name. If a non-empty iterable, then only the listed directives (including the
``$``) are allowed.
Raises ``dns.zone.NoSOA`` if there is no SOA RRset.
Raises ``dns.zone.NoNS`` if there is no NS RRset.
Raises ``KeyError`` if there is no origin node.
Returns a subclass of ``dns.zone.Zone``.
N)rL rM r r r r ) r r4 rI r5 r r r r r r r s r from_filer sr z !S H04Q
#
#A
& q
5s A
A+xfrc SnU GH" nUcM U( a
UR nOUR S R nUR S R nU" XgUS9nUR H nUR R UR 5 n U ( d( UR
5 n XR UR ' U R UR UR UR S5 n
U
R UR 5 U H n U
R U 5 M M GM% Uc [ S5 eU( a UR 5 U$ )a Convert the output of a zone transfer generator into a zone object.
*xfr*, a generator of ``dns.message.Message`` objects, typically
``dns.query.xfr()``.
*relativize*, a ``bool``, determine's whether domain names are
relativized to the zone's origin. The default is ``True``.
It is essential that the relativize setting matches the one specified
to the generator.
*check_origin*, a ``bool``. If ``True``, the default, then sanity
checks of the origin node will be made by calling the zone's
``check_origin()`` method.
Raises ``dns.zone.NoSOA`` if there is no SOA RRset.
Raises ``dns.zone.NoNS`` if there is no NS RRset.
Raises ``KeyError`` if there is no origin node.
Raises ``ValueError`` if no messages are yielded by the generator.
Returns a subclass of ``dns.zone.Zone``.
Nr r Tzempty transfer)r4 answerr3 rI rJ r rC r r r
update_ttlr rv rP r ) r r r5 r zrr4 rI r znodezrdsrds r from_xfrr e s >
A
9!))hhqk))G VDAXXEGGKK
+E(&+
#&&u}}ellELLRVWD OOEII & " y)** Hr )Hr r r r r typingr r r r r r r r
r r
dns.exceptionr<
dns.grange
dns.immutabledns.namedns.node dns.rdatadns.rdataclass dns.rdataset
dns.rdatatypedns.rdtypes.ANY.SOAdns.rdtypes.ANY.ZONEMD dns.rrset
dns.tokenizerdns.transactiondns.ttl dns.zonefile
dns.zonetypesr
r r exception DNSExceptionr r r! r$ r' r+ r. r1 r3 rO r7 r? r< TransactionManagerrA r r0 r? rQ rI r rE rG r r4 r5 rM r6 IDNACodecr rN r r r r r r s $
L L%cmm(( %4G 467 6,G ,3cmm 8 8 33S]]%?%? 3:s}})) :.
: : .
((-- SXX]] # XX]] @N 3?? - - N rCHHMM *] * *Z&" &"R<!g <!~
w
.S1#//-- S1p 37), ):): " /337'
' U388==#-. /' ^^
&
&' '
' sm
' ' ' ++,' D(3- /0'
'X 37), ):): " /337G
G U388==#-. /G ^^
&
&G G
G sm
G G G ++,G D(3- /0G
GX 37), ):): " /337P
P U388==#-. /P ^^
&
&P P
P sm
P P P ++,P D(3- /0P
Pj 5
5
5
5
5
5
r