REDROOM

Navigation

Breadcrumbs

/ / lib / python3.6 / site-packages / dns

Create

Create File | Create Folder | Upload Files | Run Command

Preview: rrset.py Size: 5.85 KB

//lib/python3.6/site-packages/dns/rrset.py

# Copyright (C) 2003-2007, 2009-2011 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 RRsets (an RRset is a named rdataset)"""


import dns.name
import dns.rdataset
import dns.rdataclass
import dns.renderer
from ._compat import string_types


class RRset(dns.rdataset.Rdataset):

    """A DNS RRset (named rdataset).

    RRset inherits from Rdataset, and RRsets can be treated as
    Rdatasets in most cases.  There are, however, a few notable
    exceptions.  RRsets have different to_wire() and to_text() method
    arguments, reflecting the fact that RRsets always have an owner
    name.
    """

    __slots__ = ['name', 'deleting']

    def __init__(self, name, rdclass, rdtype, covers=dns.rdatatype.NONE,
                 deleting=None):
        """Create a new RRset."""

        super(RRset, self).__init__(rdclass, rdtype, covers)
        self.name = name
        self.deleting = deleting

    def _clone(self):
        obj = super(RRset, self)._clone()
        obj.name = self.name
        obj.deleting = self.deleting
        return obj

    def __repr__(self):
        if self.covers == 0:
            ctext = ''
        else:
            ctext = '(' + dns.rdatatype.to_text(self.covers) + ')'
        if self.deleting is not None:
            dtext = ' delete=' + dns.rdataclass.to_text(self.deleting)
        else:
            dtext = ''
        return '<DNS ' + str(self.name) + ' ' + \
               dns.rdataclass.to_text(self.rdclass) + ' ' + \
               dns.rdatatype.to_text(self.rdtype) + ctext + dtext + ' RRset>'

    def __str__(self):
        return self.to_text()

    def __eq__(self, other):
        """Two RRsets are equal if they have the same name and the same
        rdataset

        @rtype: bool"""
        if not isinstance(other, RRset):
            return False
        if self.name != other.name:
            return False
        return super(RRset, self).__eq__(other)

    def match(self, name, rdclass, rdtype, covers, deleting=None):
        """Returns True if this rrset matches the specified class, type,
        covers, and deletion state."""

        if not super(RRset, self).match(rdclass, rdtype, covers):
            return False
        if self.name != name or self.deleting != deleting:
            return False
        return True

    def to_text(self, origin=None, relativize=True, **kw):
        """Convert the RRset into DNS master file format.

        @see: L{dns.name.Name.choose_relativity} for more information
        on how I{origin} and I{relativize} determine the way names
        are emitted.

        Any additional keyword arguments are passed on to the rdata
        to_text() method.

        @param origin: The origin for relative names, or None.
        @type origin: dns.name.Name object
        @param relativize: True if names should names be relativized
        @type relativize: bool"""

        return super(RRset, self).to_text(self.name, origin, relativize,
                                          self.deleting, **kw)

    def to_wire(self, file, compress=None, origin=None, **kw):
        """Convert the RRset to wire format."""

        return super(RRset, self).to_wire(self.name, file, compress, origin,
                                          self.deleting, **kw)

    def to_rdataset(self):
        """Convert an RRset into an Rdataset.

        @rtype: dns.rdataset.Rdataset object
        """
        return dns.rdataset.from_rdata_list(self.ttl, list(self))


def from_text_list(name, ttl, rdclass, rdtype, text_rdatas,
                   idna_codec=None):
    """Create an RRset with the specified name, TTL, class, and type, and with
    the specified list of rdatas in text format.

    @rtype: dns.rrset.RRset object
    """

    if isinstance(name, string_types):
        name = dns.name.from_text(name, None, idna_codec=idna_codec)
    if isinstance(rdclass, string_types):
        rdclass = dns.rdataclass.from_text(rdclass)
    if isinstance(rdtype, string_types):
        rdtype = dns.rdatatype.from_text(rdtype)
    r = RRset(name, rdclass, rdtype)
    r.update_ttl(ttl)
    for t in text_rdatas:
        rd = dns.rdata.from_text(r.rdclass, r.rdtype, t)
        r.add(rd)
    return r


def from_text(name, ttl, rdclass, rdtype, *text_rdatas):
    """Create an RRset with the specified name, TTL, class, and type and with
    the specified rdatas in text format.

    @rtype: dns.rrset.RRset object
    """

    return from_text_list(name, ttl, rdclass, rdtype, text_rdatas)


def from_rdata_list(name, ttl, rdatas, idna_codec=None):
    """Create an RRset with the specified name and TTL, and with
    the specified list of rdata objects.

    @rtype: dns.rrset.RRset object
    """

    if isinstance(name, string_types):
        name = dns.name.from_text(name, None, idna_codec=idna_codec)

    if len(rdatas) == 0:
        raise ValueError("rdata list must not be empty")
    r = None
    for rd in rdatas:
        if r is None:
            r = RRset(name, rd.rdclass, rd.rdtype)
            r.update_ttl(ttl)
        r.add(rd)
    return r


def from_rdata(name, ttl, *rdatas):
    """Create an RRset with the specified name and TTL, and with
    the specified rdata objects.

    @rtype: dns.rrset.RRset object
    """

    return from_rdata_list(name, ttl, rdatas)

Directory Contents

Dirs: 2 × Files: 37

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
rdtypes DIR	-	drwxr-xr-x	2025-04-06 18:08:43	Edit Download recursive recursive
__pycache__ DIR	-	drwxr-xr-x	2025-04-06 18:08:43	Edit Download recursive recursive
dnssec.py	14.44 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
e164.py	3.07 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
edns.py	4.28 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
entropy.py	4.36 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
exception.py	4.52 KB	lrw-r--r--	2016-09-20 19:13:40	Edit Download recursive recursive
flags.py	2.60 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
grange.py	1.93 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
hash.py	1.07 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
inet.py	3.17 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
ipv4.py	1.98 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
ipv6.py	5.17 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
message.py	42.12 KB	lrw-r--r--	2016-09-26 15:38:18	Edit Download recursive recursive
name.py	28.74 KB	lrw-r--r--	2024-05-23 10:29:27	Edit Download recursive recursive
namedict.py	3.59 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
node.py	5.91 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
opcode.py	2.48 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
query.py	19.18 KB	lrw-r--r--	2024-05-23 10:29:27	Edit Download recursive recursive
rcode.py	3.03 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
rdata.py	14.65 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
rdataclass.py	3.18 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
rdataset.py	11.29 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
rdatatype.py	5.21 KB	lrw-r--r--	2016-09-20 19:54:45	Edit Download recursive recursive
renderer.py	11.64 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
resolver.py	50.88 KB	lrw-r--r--	2016-09-26 15:52:30	Edit Download recursive recursive
reversename.py	3.23 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
rrset.py	5.85 KB	lrw-r--r--	2016-09-25 19:25:33	Edit Download recursive recursive
set.py	7.53 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
tokenizer.py	17.88 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
tsig.py	7.54 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
tsigkeyring.py	1.70 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
ttl.py	2.23 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
update.py	9.78 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
version.py	1.23 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
wiredata.py	3.64 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
zone.py	39.09 KB	lrw-r--r--	2016-09-29 22:29:39	Edit Download recursive recursive
_compat.py	1.28 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive
__init__.py	1.30 KB	lrw-r--r--	2016-09-20 16:24:02	Edit Download recursive recursive