3 [_ð] ã@shdZGdd„deƒZGdd„deƒZGdd„deƒZGdd„deƒZGd d „d eƒZGd d „d eƒZd S)z…Common DNS Exceptions. Dnspython modules may also define their own exceptions, which will always be subclasses of ``DNSException``. csReZdZdZdZeƒZdZ‡fdd„Zdd„Z dd„Z d d „Z ‡fd d „Z ‡Z S) Ú 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. Ncsp|j||Ž|r*|jf|Ž|_t|ƒ|_ntƒ|_|jdkrD|j|_|rZtt|ƒj |Žntt|ƒj |jƒdS)N) Ú _check_paramsÚ _check_kwargsÚkwargsÚstrÚmsgÚdictÚ__doc__ÚsuperrÚ__init__)ÚselfÚargsr)Ú __class__©ú2/tmp/pip-build-yz_zf6az/dnspython/dns/exception.pyr 3s   zDNSException.__init__cOs$|s|r t|ƒt|ƒks tdƒ‚dS)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)ÚboolÚAssertionError)r r rrrrrBszDNSException._check_paramscKs(|r$t|jƒƒ|jks$td|jƒ‚|S)Nz-following set of keyword args is required: %s)ÚsetÚkeysÚ supp_kwargsr)r rrrrrJs  zDNSException._check_kwargscKshi}x^|jƒD]R\}}t|ttfƒrXttt|ƒƒ||<t||ƒdkr`||jƒ||<q|||<qW|S)z˜Format kwargs before printing them. Resulting dictionary has to have keys necessary for str.format call on fmt class variable. é)ÚitemsÚ isinstanceÚlistrÚmaprÚlenÚpop)r rÚfmtargsÚkwÚdatarrrÚ _fmt_kwargsQs zDNSException._fmt_kwargscs:|jr(|jr(|jf|jŽ}|jjf|ŽStt|ƒjƒSdS)N)rÚfmtrÚformatr rÚ__str__)r r)r rrr"cs zDNSException.__str__)Ú__name__Ú __module__Ú __qualname__rrrrr r rrrr"Ú __classcell__rr)r rrs rc@seZdZdZdS)Ú FormErrorzDNS message is malformed.N)r#r$r%rrrrrr'msr'c@seZdZdZdS)Ú SyntaxErrorzText input is malformed.N)r#r$r%rrrrrr(qsr(c@seZdZdZdS)Ú UnexpectedEndzText input ended unexpectedly.N)r#r$r%rrrrrr)usr)c@seZdZdZdS)ÚTooBigzThe DNS message is too big.N)r#r$r%rrrrrr*ysr*c@seZdZdZdhZdZdS)ÚTimeoutzThe DNS operation timed out.Útimeoutz3The DNS operation timed out after {timeout} secondsN)r#r$r%rrr rrrrr+}sr+N)rÚ Exceptionrr'r(r)r*r+rrrrÚs U