Gecko [ tsuru-no-tsurugi.tokyo ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2024-09-07 23:29
rdtypes	[ DIR ]	drwxr-xr-x	2024-09-07 23:28
__init__.py	1.56 KB	-rw-r--r--	2020-10-24 23:17
_asyncbackend.py	1.53 KB	-rw-r--r--	2020-08-19 21:18
_asyncio_backend.py	4.34 KB	-rw-r--r--	2020-10-24 23:17
_curio_backend.py	3.33 KB	-rw-r--r--	2020-10-24 23:17
_immutable_attr.py	2.92 KB	-rw-r--r--	2020-10-24 23:17
_immutable_ctx.py	2.4 KB	-rw-r--r--	2020-10-24 23:17
_trio_backend.py	3.68 KB	-rw-r--r--	2020-10-24 23:17
asyncbackend.py	3 KB	-rw-r--r--	2020-10-24 23:17
asyncquery.py	17.4 KB	-rw-r--r--	2020-10-24 23:17
asyncresolver.py	8.71 KB	-rw-r--r--	2020-10-24 23:17
dnssec.py	19.19 KB	-rw-r--r--	2020-10-24 23:17
e164.py	3.6 KB	-rw-r--r--	2020-08-17 01:59
edns.py	10.72 KB	-rw-r--r--	2020-10-24 23:17
entropy.py	4.07 KB	-rw-r--r--	2020-08-17 01:59
enum.py	2.75 KB	-rw-r--r--	2020-10-24 23:17
exception.py	5.13 KB	-rw-r--r--	2020-10-24 23:17
flags.py	2.58 KB	-rw-r--r--	2020-10-24 23:17
grange.py	2.04 KB	-rw-r--r--	2020-10-24 23:17
immutable.py	1.97 KB	-rw-r--r--	2020-10-24 23:17
inet.py	4.74 KB	-rw-r--r--	2020-10-24 23:17
ipv4.py	1.93 KB	-rw-r--r--	2020-08-17 01:59
ipv6.py	5.92 KB	-rw-r--r--	2020-10-24 23:17
message.py	52.73 KB	-rw-r--r--	2021-01-05 04:29
name.py	31.54 KB	-rw-r--r--	2020-10-24 23:17
namedict.py	3.83 KB	-rw-r--r--	2020-08-17 01:59
node.py	6.42 KB	-rw-r--r--	2020-10-24 23:17
opcode.py	2.58 KB	-rw-r--r--	2021-01-05 03:22
py.typed	0 B	-rw-r--r--	2020-06-27 03:20
query.py	40.46 KB	-rw-r--r--	2020-10-24 23:17
rcode.py	3.9 KB	-rw-r--r--	2021-01-05 03:23
rdata.py	24.32 KB	-rw-r--r--	2021-01-06 03:41
rdataclass.py	2.81 KB	-rw-r--r--	2020-10-24 23:17
rdataset.py	14.54 KB	-rw-r--r--	2020-10-24 23:17
rdatatype.py	6.64 KB	-rw-r--r--	2020-10-24 23:17
renderer.py	8.59 KB	-rw-r--r--	2020-08-17 01:59
resolver.py	59.29 KB	-rw-r--r--	2020-12-29 03:07
reversename.py	3.65 KB	-rw-r--r--	2020-08-17 01:59
rrset.py	7.44 KB	-rw-r--r--	2020-10-24 23:17
serial.py	3.53 KB	-rw-r--r--	2020-08-17 01:59
set.py	7.64 KB	-rw-r--r--	2020-10-24 23:17
tokenizer.py	21.86 KB	-rw-r--r--	2020-10-24 23:17
transaction.py	16.93 KB	-rw-r--r--	2020-10-24 23:17
tsig.py	10.93 KB	-rw-r--r--	2020-10-30 22:15
tsigkeyring.py	2.43 KB	-rw-r--r--	2020-10-24 23:17
ttl.py	2.58 KB	-rw-r--r--	2020-10-24 23:17
update.py	10.55 KB	-rw-r--r--	2020-10-24 23:17
version.py	1.55 KB	-rw-r--r--	2021-01-07 18:20
versioned.py	15.91 KB	-rw-r--r--	2020-10-24 23:17
wire.py	2.48 KB	-rw-r--r--	2020-10-24 23:17
xfr.py	11.61 KB	-rw-r--r--	2020-10-24 23:17
zone.py	34.25 KB	-rw-r--r--	2020-10-24 23:17
zonefile.py	15.25 KB	-rw-r--r--	2020-10-24 23:17

Rename

# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license

# Copyright (C) 2001-2017 Nominum, Inc.
#
# Permission to use, copy, modify, and distribute this software and its
# documentation for any purpose with or without fee is hereby granted,
# provided that the above copyright notice and this permission notice
# appear in all copies.
#
# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR
# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
# OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

"""DNS nodes.  A node is a set of rdatasets."""

import io

import dns.rdataset
import dns.rdatatype
import dns.renderer

class Node:

"""A Node is a set of rdatasets."""

__slots__ = ['rdatasets']

def __init__(self):
        # the set of rdatasets, represented as a list.
        self.rdatasets = []

def to_text(self, name, **kw):
        """Convert a node to text format.

Each rdataset at the node is printed.  Any keyword arguments
        to this method are passed on to the rdataset's to_text() method.

*name*, a ``dns.name.Name`` or ``str``, the owner name of the
        rdatasets.

Returns a ``str``.

"""

s = io.StringIO()
        for rds in self.rdatasets:
            if len(rds) > 0:
                s.write(rds.to_text(name, **kw))
                s.write('\n')
        return s.getvalue()[:-1]

def __repr__(self):
        return '<DNS node ' + str(id(self)) + '>'

def __eq__(self, other):
        #
        # This is inefficient.  Good thing we don't need to do it much.
        #
        for rd in self.rdatasets:
            if rd not in other.rdatasets:
                return False
        for rd in other.rdatasets:
            if rd not in self.rdatasets:
                return False
        return True

def __ne__(self, other):
        return not self.__eq__(other)

def __len__(self):
        return len(self.rdatasets)

def __iter__(self):
        return iter(self.rdatasets)

def find_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE,
                      create=False):
        """Find an rdataset matching the specified properties in the
        current node.

*rdclass*, an ``int``, the class of the rdataset.

*rdtype*, an ``int``, the type of the rdataset.

*covers*, an ``int`` 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.

*create*, a ``bool``.  If True, create the rdataset if it is not found.

Raises ``KeyError`` if an rdataset of the desired type and class does
        not exist and *create* is not ``True``.

Returns a ``dns.rdataset.Rdataset``.
        """

for rds in self.rdatasets:
            if rds.match(rdclass, rdtype, covers):
                return rds
        if not create:
            raise KeyError
        rds = dns.rdataset.Rdataset(rdclass, rdtype)
        self.rdatasets.append(rds)
        return rds

def get_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE,
                     create=False):
        """Get an rdataset matching the specified properties in the
        current node.

None is returned if an rdataset of the specified type and
        class does not exist and *create* is not ``True``.

*rdclass*, an ``int``, the class of the rdataset.

*rdtype*, an ``int``, the type of the rdataset.

*covers*, an ``int``, 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, create the rdataset if it is not found.

Returns a ``dns.rdataset.Rdataset`` or ``None``.
        """

try:
            rds = self.find_rdataset(rdclass, rdtype, covers, create)
        except KeyError:
            rds = None
        return rds

def delete_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE):
        """Delete the rdataset matching the specified properties in the
        current node.

If a matching rdataset does not exist, it is not an error.

*rdclass*, an ``int``, the class of the rdataset.

*rdtype*, an ``int``, the type of the rdataset.

*covers*, an ``int``, the covered type.
        """

rds = self.get_rdataset(rdclass, rdtype, covers)
        if rds is not None:
            self.rdatasets.remove(rds)

def replace_rdataset(self, replacement):
        """Replace an rdataset.

It is not an error if there is no rdataset matching *replacement*.

Ownership of the *replacement* object is transferred to the node;
        in other words, this method does not store a copy of *replacement*
        at the node, it stores *replacement* itself.

*replacement*, a ``dns.rdataset.Rdataset``.

Raises ``ValueError`` if *replacement* is not a
        ``dns.rdataset.Rdataset``.
        """

if not isinstance(replacement, dns.rdataset.Rdataset):
            raise ValueError('replacement is not an rdataset')
        if isinstance(replacement, dns.rrset.RRset):
            # RRsets are not good replacements as the match() method
            # is not compatible.
            replacement = replacement.to_rdataset()
        self.delete_rdataset(replacement.rdclass, replacement.rdtype,
                             replacement.covers)
        self.rdatasets.append(replacement)