a
MeE @ s d Z ddlmZmZ G dd deZG dd deZG dd deZG d d
d
eZG d d d eZ G d
d deZ
G dd deZ G dd de Z G dd deZ
G dd deZG dd dZdS )zCommon DNS Exceptions.
Dnspython modules may also define their own exceptions, which will
always be subclasses of ``DNSException``.
)OptionalSetc sx e Zd ZU dZdZee ed< e Z e
e ed< dZ ee ed< fddZ dd Z
d
d Zd d
Z fddZ ZS ) DNSExceptiona Abstract base class shared by all dnspython exceptions.
It supports two basic modes of operation:
a) Old/compatible mode is used if ``__init__`` was called with
empty *kwargs*. In compatible mode all *args* are passed
to the standard Python Exception class as before and all *args* are
printed by the standard ``__str__`` implementation. Class variable
``msg`` (or doc string if ``msg`` is ``None``) is returned from ``str()``
if *args* is empty.
b) New/parametrized mode is used if ``__init__`` was called with
non-empty *kwargs*.
In the new mode *args* must be empty and all kwargs must match
those set in class variable ``supp_kwargs``. All kwargs are stored inside
``self.kwargs`` and used in a new ``__str__`` implementation to construct
a formatted message based on the ``fmt`` class variable, a ``string``.
In the simplest case it is enough to override the ``supp_kwargs``
and ``fmt`` class variables to get nice parametrized messages.
Nmsg supp_kwargsfmtc sp | j |i | |r2| jf i || _t| | _nt | _| jd u rL| j| _|r^t j| nt | j d S N)
_check_params
_check_kwargskwargsstrr dict__doc__super__init__selfargsr __class__ 1/usr/lib/python3.9/site-packages/dns/exception.pyr 7 s
zDNSException.__init__c O s$ |s|r t |t |ks J ddS )zsOld exceptions supported only args and not kwargs.
For sanity we do not allow to mix old and new behavior.z=keyword arguments are mutually exclusive with positional argsN)boolr r r r r G s zDNSException._check_paramsc K s( |r$t | | jks$J d| j |S )Nz-following set of keyword args is required: %s)setkeysr )r r r r r r
P s zDNSException._check_kwargsc K sd i }| D ]R\}}t|ttfrVttt|||< t|| dkr^|| ||< q |||< q |S )zFormat kwargs before printing them.
Resulting dictionary has to have keys necessary for str.format call
on fmt class variable.
)items
isinstancelistr mapr lenpop)r r fmtargskwdatar r r _fmt_kwargsW s
zDNSException._fmt_kwargsc s> | j r0| jr0| jf i | j }| jjf i |S t S d S r )r r r% formatr __str__)r r" r r r r' i s zDNSException.__str__)__name__
__module__ __qualname__r r r r __annotations__r r r r r r r
r% r'
__classcell__r r r r r s
r c @ s e Zd ZdZdS ) FormErrorzDNS message is malformed.Nr( r) r* r r r r r r- s s r- c @ s e Zd ZdZdS ) SyntaxErrorzText input is malformed.Nr. r r r r r/ w s r/ c @ s e Zd ZdZdS )
UnexpectedEndz Text input ended unexpectedly.Nr. r r r r r0 { s r0 c @ s e Zd ZdZdS )TooBigzThe DNS message is too big.Nr. r r r r r1 s r1 c s* e Zd ZdZdhZdZ fddZ ZS )Timeoutz The DNS operation timed out.timeoutz7The DNS operation timed out after {timeout:.3f} secondsc s t j|i | d S r )r r r r r r r s zTimeout.__init__)r( r) r* r r r r r, r r r r r2 s r2 c @ s e Zd ZdZdS )UnsupportedAlgorithmz&The DNSSEC algorithm is not supported.Nr. r r r r r4 s r4 c @ s e Zd ZdZdS )AlgorithmKeyMismatchz=The DNSSEC algorithm is not supported for the given key type.Nr. r r r r r5 s r5 c @ s e Zd ZdZdS )ValidationFailurez The DNSSEC signature is invalid.Nr. r r r r r6 s r6 c @ s e Zd ZdZdS )DeniedByPolicyzDenied by DNSSEC policy.Nr. r r r r r7 s r7 c @ s$ e Zd Zdd Zdd Zdd ZdS )ExceptionWrapperc C s
|| _ d S r )exception_class)r r9 r r r r s zExceptionWrapper.__init__c C s | S r r )r r r r __enter__ s zExceptionWrapper.__enter__c C s( |d ur$t || js$| t||dS )NF)r r9 r )r exc_typeZexc_valZexc_tbr r r __exit__ s zExceptionWrapper.__exit__N)r( r) r* r r: r< r r r r r8 s r8 N)r typingr r Exceptionr r- r/ r0 r1 r2 r4 r5 r6 r7 r8 r r r r s W