Gecko [ primetaxinc.net ]

Name	Size	Permission
__pycache__	[ DIR ]	drwxr-xr-x
dnssecalgs	[ DIR ]	drwxr-xr-x
quic	[ DIR ]	drwxr-xr-x
rdtypes	[ DIR ]	drwxr-xr-x
__init__.py	1.62 KB	-rw-r--r--
_asyncbackend.py	2.34 KB	-rw-r--r--
_asyncio_backend.py	8.84 KB	-rw-r--r--
_ddr.py	5.12 KB	-rw-r--r--
_features.py	2.43 KB	-rw-r--r--
_immutable_ctx.py	2.4 KB	-rw-r--r--
_trio_backend.py	8.27 KB	-rw-r--r--
asyncbackend.py	2.73 KB	-rw-r--r--
asyncquery.py	30.1 KB	-rw-r--r--
asyncresolver.py	17.43 KB	-rw-r--r--
dnssec.py	40.74 KB	-rw-r--r--
dnssectypes.py	1.76 KB	-rw-r--r--
e164.py	3.88 KB	-rw-r--r--
edns.py	16.69 KB	-rw-r--r--
entropy.py	4.14 KB	-rw-r--r--
enum.py	3.6 KB	-rw-r--r--
exception.py	5.81 KB	-rw-r--r--
flags.py	2.69 KB	-rw-r--r--
grange.py	2.09 KB	-rw-r--r--
immutable.py	1.97 KB	-rw-r--r--
inet.py	5.64 KB	-rw-r--r--
ipv4.py	2.49 KB	-rw-r--r--
ipv6.py	6.4 KB	-rw-r--r--
message.py	66.59 KB	-rw-r--r--
name.py	41.78 KB	-rw-r--r--
namedict.py	3.91 KB	-rw-r--r--
nameserver.py	9.88 KB	-rw-r--r--
node.py	12.37 KB	-rw-r--r--
opcode.py	2.67 KB	-rw-r--r--
py.typed	0 B	-rw-r--r--
query.py	54.98 KB	-rw-r--r--
rcode.py	4.06 KB	-rw-r--r--
rdata.py	30.29 KB	-rw-r--r--
rdataclass.py	2.91 KB	-rw-r--r--
rdataset.py	16.27 KB	-rw-r--r--
rdatatype.py	7.27 KB	-rw-r--r--
renderer.py	10.99 KB	-rw-r--r--
resolver.py	72 KB	-rw-r--r--
reversename.py	3.74 KB	-rw-r--r--
rrset.py	8.96 KB	-rw-r--r--
serial.py	3.52 KB	-rw-r--r--
set.py	9 KB	-rw-r--r--
tokenizer.py	23.03 KB	-rw-r--r--
transaction.py	22.06 KB	-rw-r--r--
tsig.py	11.15 KB	-rw-r--r--
tsigkeyring.py	2.57 KB	-rw-r--r--
ttl.py	2.91 KB	-rw-r--r--
update.py	11.96 KB	-rw-r--r--
version.py	1.88 KB	-rw-r--r--
versioned.py	11.49 KB	-rw-r--r--
win32util.py	8.67 KB	-rw-r--r--
wire.py	2.76 KB	-rw-r--r--
xfr.py	12.96 KB	-rw-r--r--
zone.py	50.87 KB	-rw-r--r--
zonefile.py	27.27 KB	-rw-r--r--
zonetypes.py	690 B	-rw-r--r--

Code Editor : rrset.py

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

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

from typing import Any, Collection, Dict, Optional, Union, cast

import dns.name
import dns.rdataclass
import dns.rdataset
import dns.renderer

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: dns.name.Name,
        rdclass: dns.rdataclass.RdataClass,
        rdtype: dns.rdatatype.RdataType,
        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
        deleting: Optional[dns.rdataclass.RdataClass] = None,
    ):
        """Create a new RRset."""

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

def _clone(self):
        obj = super()._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: "
            + self._rdata_repr()
            + ">"
        )

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

def __eq__(self, other):
        if isinstance(other, RRset):
            if self.name != other.name:
                return False
        elif not isinstance(other, dns.rdataset.Rdataset):
            return False
        return super().__eq__(other)

def match(self, *args: Any, **kwargs: Any) -> bool:  # type: ignore[override]
        """Does this rrset match the specified attributes?

Behaves as :py:func:`full_match()` if the first argument is a
        ``dns.name.Name``, and as :py:func:`dns.rdataset.Rdataset.match()`
        otherwise.

(This behavior fixes a design mistake where the signature of this
        method became incompatible with that of its superclass.  The fix
        makes RRsets matchable as Rdatasets while preserving backwards
        compatibility.)
        """
        if isinstance(args[0], dns.name.Name):
            return self.full_match(*args, **kwargs)  # type: ignore[arg-type]
        else:
            return super().match(*args, **kwargs)  # type: ignore[arg-type]

def full_match(
        self,
        name: dns.name.Name,
        rdclass: dns.rdataclass.RdataClass,
        rdtype: dns.rdatatype.RdataType,
        covers: dns.rdatatype.RdataType,
        deleting: Optional[dns.rdataclass.RdataClass] = None,
    ) -> bool:
        """Returns ``True`` if this rrset matches the specified name, class,
        type, covers, and deletion state.
        """
        if not super().match(rdclass, rdtype, covers):
            return False
        if self.name != name or self.deleting != deleting:
            return False
        return True

# pylint: disable=arguments-differ

def to_text(  # type: ignore[override]
        self,
        origin: Optional[dns.name.Name] = None,
        relativize: bool = True,
        **kw: Dict[str, Any],
    ) -> str:
        """Convert the RRset into DNS zone file format.

See ``dns.name.Name.choose_relativity`` for more information
        on how *origin* and *relativize* determine the way names
        are emitted.

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

*origin*, a ``dns.name.Name`` or ``None``, the origin for relative
        names.

*relativize*, a ``bool``.  If ``True``, names will be relativized
        to *origin*.
        """

return super().to_text(
            self.name, origin, relativize, self.deleting, **kw  # type: ignore
        )

def to_wire(  # type: ignore[override]
        self,
        file: Any,
        compress: Optional[dns.name.CompressType] = None,  # type: ignore
        origin: Optional[dns.name.Name] = None,
        **kw: Dict[str, Any],
    ) -> int:
        """Convert the RRset to wire format.

All keyword arguments are passed to ``dns.rdataset.to_wire()``; see
        that function for details.

Returns an ``int``, the number of records emitted.
        """

return super().to_wire(
            self.name, file, compress, origin, self.deleting, **kw  # type:ignore
        )

# pylint: enable=arguments-differ

def to_rdataset(self) -> dns.rdataset.Rdataset:
        """Convert an RRset into an Rdataset.

Returns a ``dns.rdataset.Rdataset``.
        """
        return dns.rdataset.from_rdata_list(self.ttl, list(self))

def from_text_list(
    name: Union[dns.name.Name, str],
    ttl: int,
    rdclass: Union[dns.rdataclass.RdataClass, str],
    rdtype: Union[dns.rdatatype.RdataType, str],
    text_rdatas: Collection[str],
    idna_codec: Optional[dns.name.IDNACodec] = None,
    origin: Optional[dns.name.Name] = None,
    relativize: bool = True,
    relativize_to: Optional[dns.name.Name] = None,
) -> RRset:
    """Create an RRset with the specified name, TTL, class, and type, and with
    the specified list of rdatas in text format.

*idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA
    encoder/decoder to use; if ``None``, the default IDNA 2003
    encoder/decoder is used.

*origin*, a ``dns.name.Name`` (or ``None``), the
    origin to use for relative names.

*relativize*, a ``bool``.  If true, name will be relativized.

*relativize_to*, a ``dns.name.Name`` (or ``None``), the origin to use
    when relativizing names.  If not set, the *origin* value will be used.

Returns a ``dns.rrset.RRset`` object.
    """

if isinstance(name, str):
        name = dns.name.from_text(name, None, idna_codec=idna_codec)
    rdclass = dns.rdataclass.RdataClass.make(rdclass)
    rdtype = dns.rdatatype.RdataType.make(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, origin, relativize, relativize_to, idna_codec
        )
        r.add(rd)
    return r

def from_text(
    name: Union[dns.name.Name, str],
    ttl: int,
    rdclass: Union[dns.rdataclass.RdataClass, str],
    rdtype: Union[dns.rdatatype.RdataType, str],
    *text_rdatas: Any,
) -> RRset:
    """Create an RRset with the specified name, TTL, class, and type and with
    the specified rdatas in text format.

Returns a ``dns.rrset.RRset`` object.
    """

return from_text_list(
        name, ttl, rdclass, rdtype, cast(Collection[str], text_rdatas)
    )

def from_rdata_list(
    name: Union[dns.name.Name, str],
    ttl: int,
    rdatas: Collection[dns.rdata.Rdata],
    idna_codec: Optional[dns.name.IDNACodec] = None,
) -> RRset:
    """Create an RRset with the specified name and TTL, and with
    the specified list of rdata objects.

*idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA
    encoder/decoder to use; if ``None``, the default IDNA 2003
    encoder/decoder is used.

Returns a ``dns.rrset.RRset`` object.

"""

if isinstance(name, str):
        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)
    assert r is not None
    return r

def from_rdata(name: Union[dns.name.Name, str], ttl: int, *rdatas: Any) -> RRset:
    """Create an RRset with the specified name and TTL, and with
    the specified rdata objects.

Returns a ``dns.rrset.RRset`` object.
    """

return from_rdata_list(name, ttl, cast(Collection[dns.rdata.Rdata], rdatas))

${this.title}

Code Editor : rrset.py