3
¢báW¨ ã @ s< d Z ddlmZ ddlZddlZddlZG dd„ deƒZdS )z)DNS nodes. A node is a set of rdatasets.é )ÚStringIONc @ sŠ e Zd ZdZdgZdd„ Zdd„ Zdd„ Zd d
„ Zd d „ Z d
d„ Z
dd„ Z e j
jdfdd„Ze j
jdfdd„Ze j
jfdd„Zdd„ ZdS )ÚNodez“A DNS node.
A node is a set of rdatasets
@ivar rdatasets: the node's rdatasets
@type rdatasets: list of dns.rdataset.Rdataset objectsÚ rdatasetsc C s
g | _ dS )z Initialize a DNS node.
N)r )Úself© r ú/usr/lib/python3.6/node.pyÚ__init__$ s z
Node.__init__c K sP t ƒ }x8| jD ].}t|ƒdkr|j|j|f|Žƒ |jdƒ qW |jƒ dd… S )a+ 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.
@param name: the owner name of the rdatasets
@type name: dns.name.Name object
@rtype: string
r Ú
Né éÿÿÿÿ)r r ÚlenÚwriteÚto_textÚgetvalue)r ÚnameÚkwÚsÚrdsr r r r * s
z Node.to_textc C s dt t| ƒƒ d S )Nz
)ÚstrÚid)r r r r Ú__repr__; s z
Node.__repr__c C s@ x | j D ]}||j krdS qW x |j D ]}|| j kr&dS q&W dS )zSTwo nodes are equal if they have the same rdatasets.
@rtype: bool
FT)r )r ÚotherZrdr r r Ú__eq__> s
z Node.__eq__c C s | j |ƒ S )N)r )r r r r r Ú__ne__N s z Node.__ne__c C s
t | jƒS )N)r r )r r r r Ú__len__Q s z Node.__len__c C s
t | jƒS )N)Úiterr )r r r r Ú__iter__T s z
Node.__iter__Fc C sH x | j D ]}|j|||ƒr|S qW |s*t‚tjj||ƒ}| j j|ƒ |S )a Find an rdataset matching the specified properties in the
current node.
@param rdclass: The class of the rdataset
@type rdclass: int
@param rdtype: The type of the rdataset
@type rdtype: int
@param covers: 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.
@type covers: int
@param create: If True, create the rdataset if it is not found.
@type create: bool
@raises KeyError: An rdataset of the desired type and class does
not exist and I{create} is not True.
@rtype: dns.rdataset.Rdataset object
)r ÚmatchÚKeyErrorÚdnsÚrdatasetÚRdatasetÚappend)r ÚrdclassÚrdtypeÚcoversÚcreater r r r Ú
find_rdatasetW s zNode.find_rdatasetc C s2 y| j ||||ƒ}W n tk
r, d}Y nX |S )aE 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 I{create} is not True.
@param rdclass: The class of the rdataset
@type rdclass: int
@param rdtype: The type of the rdataset
@type rdtype: int
@param covers: The covered type.
@type covers: int
@param create: If True, create the rdataset if it is not found.
@type create: bool
@rtype: dns.rdataset.Rdataset object or None
N)r( r )r r$ r% r& r' r r r r Ú get_rdatasety s
zNode.get_rdatasetc C s& | j |||ƒ}|dk r"| jj|ƒ dS )az Delete the rdataset matching the specified properties in the
current node.
If a matching rdataset does not exist, it is not an error.
@param rdclass: The class of the rdataset
@type rdclass: int
@param rdtype: The type of the rdataset
@type rdtype: int
@param covers: The covered type.
@type covers: int
N)r) r Úremove)r r$ r% r& r r r r Údelete_rdataset’ s zNode.delete_rdatasetc C s: t |tjjƒstdƒ‚| j|j|j|jƒ | j j
|ƒ dS )a8 Replace an rdataset.
It is not an error if there is no rdataset matching I{replacement}.
Ownership of the I{replacement} object is transferred to the node;
in other words, this method does not store a copy of I{replacement}
at the node, it stores I{replacement} itself.
z replacement is not an rdatasetN) Ú
isinstancer r! r" Ú
ValueErrorr+ r$ r% r& r r# )r Z replacementr r r Úreplace_rdataset¤ s
zNode.replace_rdatasetN)Ú__name__Ú
__module__Ú __qualname__Ú__doc__Ú __slots__r r r r r r r r Z rdatatypeZNONEr( r) r+ r. r r r r r s ! r ) r2 Úior Z dns.rdatasetr Z
dns.rdatatypeZ dns.rendererÚobjectr r r r r Ú s