python-unbound 1.5.8-1ubuntu1 / usr / lib / python2.7 / dist-packages / unbound.py

# This file was automatically generated by SWIG (http://www.swig.org).
# Version 3.0.8
#
# Do not make changes to this file unless you know what you are doing--modify
# the SWIG interface file instead.





from sys import version_info
if version_info >= (2, 6, 0):
    def swig_import_helper():
        from os.path import dirname
        import imp
        fp = None
        try:
            fp, pathname, description = imp.find_module('_unbound', [dirname(__file__)])
        except ImportError:
            import _unbound
            return _unbound
        if fp is not None:
            try:
                _mod = imp.load_module('_unbound', fp, pathname, description)
            finally:
                fp.close()
            return _mod
    _unbound = swig_import_helper()
    del swig_import_helper
else:
    import _unbound
del version_info
try:
    _swig_property = property
except NameError:
    pass  # Python < 2.2 doesn't have 'property'.


def _swig_setattr_nondynamic(self, class_type, name, value, static=1):
    if (name == "thisown"):
        return self.this.own(value)
    if (name == "this"):
        if type(value).__name__ == 'SwigPyObject':
            self.__dict__[name] = value
            return
    method = class_type.__swig_setmethods__.get(name, None)
    if method:
        return method(self, value)
    if (not static):
        if _newclass:
            object.__setattr__(self, name, value)
        else:
            self.__dict__[name] = value
    else:
        raise AttributeError("You cannot add attributes to %s" % self)


def _swig_setattr(self, class_type, name, value):
    return _swig_setattr_nondynamic(self, class_type, name, value, 0)


def _swig_getattr_nondynamic(self, class_type, name, static=1):
    if (name == "thisown"):
        return self.this.own()
    method = class_type.__swig_getmethods__.get(name, None)
    if method:
        return method(self)
    if (not static):
        return object.__getattr__(self, name)
    else:
        raise AttributeError(name)

def _swig_getattr(self, class_type, name):
    return _swig_getattr_nondynamic(self, class_type, name, 0)


def _swig_repr(self):
    try:
        strthis = "proxy of " + self.this.__repr__()
    except Exception:
        strthis = ""
    return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)

try:
    _object = object
    _newclass = 1
except AttributeError:
    class _object:
        pass
    _newclass = 0



import encodings.idna
try:
    import builtins
except ImportError:
    import __builtin__ as builtins

# Ensure compatibility with older python versions
if 'bytes' not in vars():
    bytes = str

def ord(s):
    if isinstance(s, int):
        return s
    return builtins.ord(s)


def ub_ctx_free_dbg(c):
    return _unbound.ub_ctx_free_dbg(c)
ub_ctx_free_dbg = _unbound.ub_ctx_free_dbg

_unbound.RR_TYPE_A_swigconstant(_unbound)
RR_TYPE_A = _unbound.RR_TYPE_A

_unbound.RR_TYPE_NS_swigconstant(_unbound)
RR_TYPE_NS = _unbound.RR_TYPE_NS

_unbound.RR_TYPE_MD_swigconstant(_unbound)
RR_TYPE_MD = _unbound.RR_TYPE_MD

_unbound.RR_TYPE_MF_swigconstant(_unbound)
RR_TYPE_MF = _unbound.RR_TYPE_MF

_unbound.RR_TYPE_CNAME_swigconstant(_unbound)
RR_TYPE_CNAME = _unbound.RR_TYPE_CNAME

_unbound.RR_TYPE_SOA_swigconstant(_unbound)
RR_TYPE_SOA = _unbound.RR_TYPE_SOA

_unbound.RR_TYPE_MB_swigconstant(_unbound)
RR_TYPE_MB = _unbound.RR_TYPE_MB

_unbound.RR_TYPE_MG_swigconstant(_unbound)
RR_TYPE_MG = _unbound.RR_TYPE_MG

_unbound.RR_TYPE_MR_swigconstant(_unbound)
RR_TYPE_MR = _unbound.RR_TYPE_MR

_unbound.RR_TYPE_NULL_swigconstant(_unbound)
RR_TYPE_NULL = _unbound.RR_TYPE_NULL

_unbound.RR_TYPE_WKS_swigconstant(_unbound)
RR_TYPE_WKS = _unbound.RR_TYPE_WKS

_unbound.RR_TYPE_PTR_swigconstant(_unbound)
RR_TYPE_PTR = _unbound.RR_TYPE_PTR

_unbound.RR_TYPE_HINFO_swigconstant(_unbound)
RR_TYPE_HINFO = _unbound.RR_TYPE_HINFO

_unbound.RR_TYPE_MINFO_swigconstant(_unbound)
RR_TYPE_MINFO = _unbound.RR_TYPE_MINFO

_unbound.RR_TYPE_MX_swigconstant(_unbound)
RR_TYPE_MX = _unbound.RR_TYPE_MX

_unbound.RR_TYPE_TXT_swigconstant(_unbound)
RR_TYPE_TXT = _unbound.RR_TYPE_TXT

_unbound.RR_TYPE_RP_swigconstant(_unbound)
RR_TYPE_RP = _unbound.RR_TYPE_RP

_unbound.RR_TYPE_AFSDB_swigconstant(_unbound)
RR_TYPE_AFSDB = _unbound.RR_TYPE_AFSDB

_unbound.RR_TYPE_X25_swigconstant(_unbound)
RR_TYPE_X25 = _unbound.RR_TYPE_X25

_unbound.RR_TYPE_ISDN_swigconstant(_unbound)
RR_TYPE_ISDN = _unbound.RR_TYPE_ISDN

_unbound.RR_TYPE_RT_swigconstant(_unbound)
RR_TYPE_RT = _unbound.RR_TYPE_RT

_unbound.RR_TYPE_NSAP_swigconstant(_unbound)
RR_TYPE_NSAP = _unbound.RR_TYPE_NSAP

_unbound.RR_TYPE_NSAP_PTR_swigconstant(_unbound)
RR_TYPE_NSAP_PTR = _unbound.RR_TYPE_NSAP_PTR

_unbound.RR_TYPE_SIG_swigconstant(_unbound)
RR_TYPE_SIG = _unbound.RR_TYPE_SIG

_unbound.RR_TYPE_KEY_swigconstant(_unbound)
RR_TYPE_KEY = _unbound.RR_TYPE_KEY

_unbound.RR_TYPE_PX_swigconstant(_unbound)
RR_TYPE_PX = _unbound.RR_TYPE_PX

_unbound.RR_TYPE_GPOS_swigconstant(_unbound)
RR_TYPE_GPOS = _unbound.RR_TYPE_GPOS

_unbound.RR_TYPE_AAAA_swigconstant(_unbound)
RR_TYPE_AAAA = _unbound.RR_TYPE_AAAA

_unbound.RR_TYPE_LOC_swigconstant(_unbound)
RR_TYPE_LOC = _unbound.RR_TYPE_LOC

_unbound.RR_TYPE_NXT_swigconstant(_unbound)
RR_TYPE_NXT = _unbound.RR_TYPE_NXT

_unbound.RR_TYPE_EID_swigconstant(_unbound)
RR_TYPE_EID = _unbound.RR_TYPE_EID

_unbound.RR_TYPE_NIMLOC_swigconstant(_unbound)
RR_TYPE_NIMLOC = _unbound.RR_TYPE_NIMLOC

_unbound.RR_TYPE_SRV_swigconstant(_unbound)
RR_TYPE_SRV = _unbound.RR_TYPE_SRV

_unbound.RR_TYPE_ATMA_swigconstant(_unbound)
RR_TYPE_ATMA = _unbound.RR_TYPE_ATMA

_unbound.RR_TYPE_NAPTR_swigconstant(_unbound)
RR_TYPE_NAPTR = _unbound.RR_TYPE_NAPTR

_unbound.RR_TYPE_KX_swigconstant(_unbound)
RR_TYPE_KX = _unbound.RR_TYPE_KX

_unbound.RR_TYPE_CERT_swigconstant(_unbound)
RR_TYPE_CERT = _unbound.RR_TYPE_CERT

_unbound.RR_TYPE_A6_swigconstant(_unbound)
RR_TYPE_A6 = _unbound.RR_TYPE_A6

_unbound.RR_TYPE_DNAME_swigconstant(_unbound)
RR_TYPE_DNAME = _unbound.RR_TYPE_DNAME

_unbound.RR_TYPE_SINK_swigconstant(_unbound)
RR_TYPE_SINK = _unbound.RR_TYPE_SINK

_unbound.RR_TYPE_OPT_swigconstant(_unbound)
RR_TYPE_OPT = _unbound.RR_TYPE_OPT

_unbound.RR_TYPE_APL_swigconstant(_unbound)
RR_TYPE_APL = _unbound.RR_TYPE_APL

_unbound.RR_TYPE_DS_swigconstant(_unbound)
RR_TYPE_DS = _unbound.RR_TYPE_DS

_unbound.RR_TYPE_SSHFP_swigconstant(_unbound)
RR_TYPE_SSHFP = _unbound.RR_TYPE_SSHFP

_unbound.RR_TYPE_IPSECKEY_swigconstant(_unbound)
RR_TYPE_IPSECKEY = _unbound.RR_TYPE_IPSECKEY

_unbound.RR_TYPE_RRSIG_swigconstant(_unbound)
RR_TYPE_RRSIG = _unbound.RR_TYPE_RRSIG

_unbound.RR_TYPE_NSEC_swigconstant(_unbound)
RR_TYPE_NSEC = _unbound.RR_TYPE_NSEC

_unbound.RR_TYPE_DNSKEY_swigconstant(_unbound)
RR_TYPE_DNSKEY = _unbound.RR_TYPE_DNSKEY

_unbound.RR_TYPE_DHCID_swigconstant(_unbound)
RR_TYPE_DHCID = _unbound.RR_TYPE_DHCID

_unbound.RR_TYPE_NSEC3_swigconstant(_unbound)
RR_TYPE_NSEC3 = _unbound.RR_TYPE_NSEC3

_unbound.RR_TYPE_NSEC3PARAMS_swigconstant(_unbound)
RR_TYPE_NSEC3PARAMS = _unbound.RR_TYPE_NSEC3PARAMS

_unbound.RR_TYPE_UINFO_swigconstant(_unbound)
RR_TYPE_UINFO = _unbound.RR_TYPE_UINFO

_unbound.RR_TYPE_UID_swigconstant(_unbound)
RR_TYPE_UID = _unbound.RR_TYPE_UID

_unbound.RR_TYPE_GID_swigconstant(_unbound)
RR_TYPE_GID = _unbound.RR_TYPE_GID

_unbound.RR_TYPE_UNSPEC_swigconstant(_unbound)
RR_TYPE_UNSPEC = _unbound.RR_TYPE_UNSPEC

_unbound.RR_TYPE_TSIG_swigconstant(_unbound)
RR_TYPE_TSIG = _unbound.RR_TYPE_TSIG

_unbound.RR_TYPE_IXFR_swigconstant(_unbound)
RR_TYPE_IXFR = _unbound.RR_TYPE_IXFR

_unbound.RR_TYPE_AXFR_swigconstant(_unbound)
RR_TYPE_AXFR = _unbound.RR_TYPE_AXFR

_unbound.RR_TYPE_MAILB_swigconstant(_unbound)
RR_TYPE_MAILB = _unbound.RR_TYPE_MAILB

_unbound.RR_TYPE_MAILA_swigconstant(_unbound)
RR_TYPE_MAILA = _unbound.RR_TYPE_MAILA

_unbound.RR_TYPE_ANY_swigconstant(_unbound)
RR_TYPE_ANY = _unbound.RR_TYPE_ANY

_unbound.RR_TYPE_DLV_swigconstant(_unbound)
RR_TYPE_DLV = _unbound.RR_TYPE_DLV

_unbound.RR_CLASS_IN_swigconstant(_unbound)
RR_CLASS_IN = _unbound.RR_CLASS_IN

_unbound.RR_CLASS_CH_swigconstant(_unbound)
RR_CLASS_CH = _unbound.RR_CLASS_CH

_unbound.RR_CLASS_HS_swigconstant(_unbound)
RR_CLASS_HS = _unbound.RR_CLASS_HS

_unbound.RR_CLASS_NONE_swigconstant(_unbound)
RR_CLASS_NONE = _unbound.RR_CLASS_NONE

_unbound.RR_CLASS_ANY_swigconstant(_unbound)
RR_CLASS_ANY = _unbound.RR_CLASS_ANY

def ub_resolve_free_dbg(r):
    return _unbound.ub_resolve_free_dbg(r)
ub_resolve_free_dbg = _unbound.ub_resolve_free_dbg

_unbound.RCODE_NOERROR_swigconstant(_unbound)
RCODE_NOERROR = _unbound.RCODE_NOERROR

_unbound.RCODE_FORMERR_swigconstant(_unbound)
RCODE_FORMERR = _unbound.RCODE_FORMERR

_unbound.RCODE_SERVFAIL_swigconstant(_unbound)
RCODE_SERVFAIL = _unbound.RCODE_SERVFAIL

_unbound.RCODE_NXDOMAIN_swigconstant(_unbound)
RCODE_NXDOMAIN = _unbound.RCODE_NXDOMAIN

_unbound.RCODE_NOTIMPL_swigconstant(_unbound)
RCODE_NOTIMPL = _unbound.RCODE_NOTIMPL

_unbound.RCODE_REFUSED_swigconstant(_unbound)
RCODE_REFUSED = _unbound.RCODE_REFUSED

_unbound.RCODE_YXDOMAIN_swigconstant(_unbound)
RCODE_YXDOMAIN = _unbound.RCODE_YXDOMAIN

_unbound.RCODE_YXRRSET_swigconstant(_unbound)
RCODE_YXRRSET = _unbound.RCODE_YXRRSET

_unbound.RCODE_NXRRSET_swigconstant(_unbound)
RCODE_NXRRSET = _unbound.RCODE_NXRRSET

_unbound.RCODE_NOTAUTH_swigconstant(_unbound)
RCODE_NOTAUTH = _unbound.RCODE_NOTAUTH

_unbound.RCODE_NOTZONE_swigconstant(_unbound)
RCODE_NOTZONE = _unbound.RCODE_NOTZONE

class ub_data:
   """Class which makes the resolution results accessible"""
   def __init__(self, data):
      """Creates ub_data class
         :param data: a list of the result data in RAW format
      """
      if data == None:
         raise Exception("ub_data init: No data")
      self.data = data

   def __str__(self):
      """Represents data as string"""
      return ';'.join([' '.join(map(lambda x:"%02X" % ord(x),a)) for a in self.data])

   @staticmethod
   def dname2str(s, ofs=0, maxlen=0):
      """Parses DNAME and produces a list of labels

         :param ofs: where the conversion should start to parse data
         :param maxlen: maximum length (0 means parse to the end)
         :returns: list of labels (string)
      """
      if not s:
         return []

      res = []
      slen = len(s)
      if maxlen > 0:
         slen = min(slen, maxlen)

      idx = ofs
      while (idx < slen):
         complen = ord(s[idx])
# In python 3.x `str()` converts the string to unicode which is the expected text string type
         res.append(str(s[idx+1:idx+1+complen].decode()))
         idx += complen + 1

      return res

   def as_raw_data(self):
      """Returns a list of RAW strings"""
      return self.data

   raw = property(as_raw_data, doc="Returns RAW data (a list of binary encoded strings). See :meth:`as_raw_data`")

   def as_mx_list(self):
      """Represents data as a list of MX records (query for RR_TYPE_MX)

         :returns: list of tuples (priority, dname)
      """
      return [(256*ord(rdf[0])+ord(rdf[1]),'.'.join([a for a in self.dname2str(rdf,2)])) for rdf in self.data]

   mx_list = property(as_mx_list, doc="Returns a list of tuples containing priority and domain names. See :meth:`as_mx_list`")

   def as_idn_mx_list(self):
      """Represents data as a list of MX records (query for RR_TYPE_MX)

         :returns: list of tuples (priority, unicode dname)
      """
      return [(256*ord(rdf[0])+ord(rdf[1]),'.'.join([encodings.idna.ToUnicode(a) for a in self.dname2str(rdf,2)])) for rdf in self.data]

   mx_list_idn = property(as_idn_mx_list, doc="Returns a list of tuples containing priority and IDN domain names. See :meth:`as_idn_mx_list`")

   def as_address_list(self):
      """Represents data as a list of IP addresses (query for RR_TYPE_PTR)

         :returns: list of strings
      """
      return ['.'.join(map(lambda x:str(ord(x)),a)) for a in self.data]

   address_list = property(as_address_list, doc="Returns a list of IP addresses. See :meth:`as_address_list`")

   def as_domain_list(self):
      """Represents data as a list of domain names (query for RR_TYPE_A)

         :returns: list of strings
      """
      return map(lambda x:'.'.join(self.dname2str(x)), self.data)

   domain_list = property(as_domain_list, doc="Returns a list of domain names. See :meth:`as_domain_list`")

   def as_idn_domain_list(self):
      """Represents data as a list of unicode domain names (query for RR_TYPE_A)

         :returns: list of strings
      """
      return map(lambda x: '.'.join([encodings.idna.ToUnicode(a) for a in self.dname2str(x)]), self.data)

   domain_list_idn = property(as_idn_domain_list, doc="Returns a list of IDN domain names. See :meth:`as_idn_domain_list`")

class ub_result(_object):
    """The validation and resolution results."""

    __swig_setmethods__ = {}
    __setattr__ = lambda self, name, value: _swig_setattr(self, ub_result, name, value)
    __swig_getmethods__ = {}
    __getattr__ = lambda self, name: _swig_getattr(self, ub_result, name)

    def __init__(self, *args, **kwargs):
        raise AttributeError("No constructor defined")
    __repr__ = _swig_repr
    __swig_setmethods__["qname"] = _unbound.ub_result_qname_set
    __swig_getmethods__["qname"] = _unbound.ub_result_qname_get
    if _newclass:
        qname = _swig_property(_unbound.ub_result_qname_get, _unbound.ub_result_qname_set)
    __swig_setmethods__["qtype"] = _unbound.ub_result_qtype_set
    __swig_getmethods__["qtype"] = _unbound.ub_result_qtype_get
    if _newclass:
        qtype = _swig_property(_unbound.ub_result_qtype_get, _unbound.ub_result_qtype_set)
    __swig_setmethods__["qclass"] = _unbound.ub_result_qclass_set
    __swig_getmethods__["qclass"] = _unbound.ub_result_qclass_get
    if _newclass:
        qclass = _swig_property(_unbound.ub_result_qclass_get, _unbound.ub_result_qclass_set)
    __swig_setmethods__["_data"] = _unbound.ub_result__data_set
    __swig_getmethods__["_data"] = _unbound.ub_result__data_get
    if _newclass:
        _data = _swig_property(_unbound.ub_result__data_get, _unbound.ub_result__data_set)
    __swig_setmethods__["len"] = _unbound.ub_result_len_set
    __swig_getmethods__["len"] = _unbound.ub_result_len_get
    if _newclass:
        len = _swig_property(_unbound.ub_result_len_get, _unbound.ub_result_len_set)
    __swig_setmethods__["canonname"] = _unbound.ub_result_canonname_set
    __swig_getmethods__["canonname"] = _unbound.ub_result_canonname_get
    if _newclass:
        canonname = _swig_property(_unbound.ub_result_canonname_get, _unbound.ub_result_canonname_set)
    __swig_setmethods__["rcode"] = _unbound.ub_result_rcode_set
    __swig_getmethods__["rcode"] = _unbound.ub_result_rcode_get
    if _newclass:
        rcode = _swig_property(_unbound.ub_result_rcode_get, _unbound.ub_result_rcode_set)
    __swig_setmethods__["answer_packet"] = _unbound.ub_result_answer_packet_set
    __swig_getmethods__["answer_packet"] = _unbound.ub_result_answer_packet_get
    if _newclass:
        answer_packet = _swig_property(_unbound.ub_result_answer_packet_get, _unbound.ub_result_answer_packet_set)
    __swig_setmethods__["answer_len"] = _unbound.ub_result_answer_len_set
    __swig_getmethods__["answer_len"] = _unbound.ub_result_answer_len_get
    if _newclass:
        answer_len = _swig_property(_unbound.ub_result_answer_len_get, _unbound.ub_result_answer_len_set)
    __swig_setmethods__["havedata"] = _unbound.ub_result_havedata_set
    __swig_getmethods__["havedata"] = _unbound.ub_result_havedata_get
    if _newclass:
        havedata = _swig_property(_unbound.ub_result_havedata_get, _unbound.ub_result_havedata_set)
    __swig_setmethods__["nxdomain"] = _unbound.ub_result_nxdomain_set
    __swig_getmethods__["nxdomain"] = _unbound.ub_result_nxdomain_get
    if _newclass:
        nxdomain = _swig_property(_unbound.ub_result_nxdomain_get, _unbound.ub_result_nxdomain_set)
    __swig_setmethods__["secure"] = _unbound.ub_result_secure_set
    __swig_getmethods__["secure"] = _unbound.ub_result_secure_get
    if _newclass:
        secure = _swig_property(_unbound.ub_result_secure_get, _unbound.ub_result_secure_set)
    __swig_setmethods__["bogus"] = _unbound.ub_result_bogus_set
    __swig_getmethods__["bogus"] = _unbound.ub_result_bogus_get
    if _newclass:
        bogus = _swig_property(_unbound.ub_result_bogus_get, _unbound.ub_result_bogus_set)
    __swig_setmethods__["why_bogus"] = _unbound.ub_result_why_bogus_set
    __swig_getmethods__["why_bogus"] = _unbound.ub_result_why_bogus_get
    if _newclass:
        why_bogus = _swig_property(_unbound.ub_result_why_bogus_get, _unbound.ub_result_why_bogus_set)
    __swig_setmethods__["ttl"] = _unbound.ub_result_ttl_set
    __swig_getmethods__["ttl"] = _unbound.ub_result_ttl_get
    if _newclass:
        ttl = _swig_property(_unbound.ub_result_ttl_get, _unbound.ub_result_ttl_set)

    def _ub_result_data(self, result):
        return _unbound.ub_result__ub_result_data(self, result)

    def _packet(self):
        return _unbound.ub_result__packet(self)

    def __init__(self):
        raise Exception("This class can't be created directly.")

    #__swig_destroy__ = _unbound.ub_resolve_free_dbg
    __swig_destroy__ = _unbound._ub_resolve_free

    #havedata = property(_unbound.ub_result_havedata_get, _unbound.ub_result_havedata_set, "Havedata property")

    rcode2str = {RCODE_NOERROR:'no error', RCODE_FORMERR:'form error', RCODE_SERVFAIL:'serv fail', RCODE_NXDOMAIN:'nx domain', RCODE_NOTIMPL:'not implemented', RCODE_REFUSED:'refused', RCODE_YXDOMAIN:'yxdomain', RCODE_YXRRSET:'yxrrset', RCODE_NXRRSET:'nxrrset', RCODE_NOTAUTH:'not auth', RCODE_NOTZONE:'not zone'}

    def _get_rcode_str(self):
        """Returns rcode in display representation form

           :returns: string
        """
        return self.rcode2str[self.rcode]

    __swig_getmethods__["rcode_str"] = _get_rcode_str
    if _newclass:rcode_str = _swig_property(_get_rcode_str)

    def _get_raw_data(self):
        """Result data, a list of network order DNS rdata items. 

           Data are represented as a list of strings. To decode RAW data to the list of IP addresses use :attr:`data` attribute which returns an :class:`ub_data` instance containing conversion function.
        """
        return self._ub_result_data(self)

    __swig_getmethods__["rawdata"] = _get_raw_data
    rawdata = property(_get_raw_data, doc="Returns raw data, a list of rdata items. To decode RAW data use the :attr:`data` attribute which returns an instance of :class:`ub_data` containing the conversion functions.")

    def _get_data(self):
        if not self.havedata: return None
        return ub_data(self._ub_result_data(self))

    __swig_getmethods__["data"] = _get_data
    __swig_getmethods__["packet"] = _packet
    data = property(_get_data, doc="Returns :class:`ub_data` instance containing various decoding functions or None")


ub_result_swigregister = _unbound.ub_result_swigregister
ub_result_swigregister(ub_result)


def ub_ctx_create():
    return _unbound.ub_ctx_create()
ub_ctx_create = _unbound.ub_ctx_create

def _ub_ctx_delete(ctx):
    return _unbound._ub_ctx_delete(ctx)
_ub_ctx_delete = _unbound._ub_ctx_delete

def ub_ctx_set_option(ctx, opt, val):
    return _unbound.ub_ctx_set_option(ctx, opt, val)
ub_ctx_set_option = _unbound.ub_ctx_set_option

def ub_ctx_get_option(ctx, opt, str):
    return _unbound.ub_ctx_get_option(ctx, opt, str)
ub_ctx_get_option = _unbound.ub_ctx_get_option

def ub_ctx_config(ctx, fname):
    return _unbound.ub_ctx_config(ctx, fname)
ub_ctx_config = _unbound.ub_ctx_config

def ub_ctx_set_fwd(ctx, addr):
    return _unbound.ub_ctx_set_fwd(ctx, addr)
ub_ctx_set_fwd = _unbound.ub_ctx_set_fwd

def ub_ctx_set_stub(ctx, zone, addr, isprime):
    return _unbound.ub_ctx_set_stub(ctx, zone, addr, isprime)
ub_ctx_set_stub = _unbound.ub_ctx_set_stub

def ub_ctx_resolvconf(ctx, fname):
    return _unbound.ub_ctx_resolvconf(ctx, fname)
ub_ctx_resolvconf = _unbound.ub_ctx_resolvconf

def ub_ctx_hosts(ctx, fname):
    return _unbound.ub_ctx_hosts(ctx, fname)
ub_ctx_hosts = _unbound.ub_ctx_hosts

def ub_ctx_add_ta(ctx, ta):
    return _unbound.ub_ctx_add_ta(ctx, ta)
ub_ctx_add_ta = _unbound.ub_ctx_add_ta

def ub_ctx_add_ta_file(ctx, fname):
    return _unbound.ub_ctx_add_ta_file(ctx, fname)
ub_ctx_add_ta_file = _unbound.ub_ctx_add_ta_file

def ub_ctx_add_ta_autr(ctx, fname):
    return _unbound.ub_ctx_add_ta_autr(ctx, fname)
ub_ctx_add_ta_autr = _unbound.ub_ctx_add_ta_autr

def ub_ctx_trustedkeys(ctx, fname):
    return _unbound.ub_ctx_trustedkeys(ctx, fname)
ub_ctx_trustedkeys = _unbound.ub_ctx_trustedkeys

def ub_ctx_debuglevel(ctx, d):
    return _unbound.ub_ctx_debuglevel(ctx, d)
ub_ctx_debuglevel = _unbound.ub_ctx_debuglevel

def ub_ctx_async(ctx, dothread):
    return _unbound.ub_ctx_async(ctx, dothread)
ub_ctx_async = _unbound.ub_ctx_async

def ub_poll(ctx):
    return _unbound.ub_poll(ctx)
ub_poll = _unbound.ub_poll

def ub_wait(ctx):
    return _unbound.ub_wait(ctx)
ub_wait = _unbound.ub_wait

def ub_fd(ctx):
    return _unbound.ub_fd(ctx)
ub_fd = _unbound.ub_fd

def ub_process(ctx):
    return _unbound.ub_process(ctx)
ub_process = _unbound.ub_process

def ub_resolve(ctx, name, rrtype, rrclass):
    return _unbound.ub_resolve(ctx, name, rrtype, rrclass)
ub_resolve = _unbound.ub_resolve

def ub_resolve_async(ctx, name, rrtype, rrclass, mydata, callback, async_id):
    return _unbound.ub_resolve_async(ctx, name, rrtype, rrclass, mydata, callback, async_id)
ub_resolve_async = _unbound.ub_resolve_async

def ub_cancel(ctx, async_id):
    return _unbound.ub_cancel(ctx, async_id)
ub_cancel = _unbound.ub_cancel

def _ub_resolve_free(result):
    return _unbound._ub_resolve_free(result)
_ub_resolve_free = _unbound._ub_resolve_free

def ub_strerror(err):
    return _unbound.ub_strerror(err)
ub_strerror = _unbound.ub_strerror

def ub_ctx_print_local_zones(ctx):
    return _unbound.ub_ctx_print_local_zones(ctx)
ub_ctx_print_local_zones = _unbound.ub_ctx_print_local_zones

def ub_ctx_zone_add(ctx, zone_name, zone_type):
    return _unbound.ub_ctx_zone_add(ctx, zone_name, zone_type)
ub_ctx_zone_add = _unbound.ub_ctx_zone_add

def ub_ctx_zone_remove(ctx, zone_name):
    return _unbound.ub_ctx_zone_remove(ctx, zone_name)
ub_ctx_zone_remove = _unbound.ub_ctx_zone_remove

def ub_ctx_data_add(ctx, data):
    return _unbound.ub_ctx_data_add(ctx, data)
ub_ctx_data_add = _unbound.ub_ctx_data_add

def ub_ctx_data_remove(ctx, data):
    return _unbound.ub_ctx_data_remove(ctx, data)
ub_ctx_data_remove = _unbound.ub_ctx_data_remove

def ub_version():
    return _unbound.ub_version()
ub_version = _unbound.ub_version
class ub_ctx(_object):
    """
    Unbound resolving and validation context. 

    The validation context is created to hold the resolver status, validation keys and a small cache (containing messages, rrsets, roundtrip times, trusted keys, lameness information).

    **Usage**

    >>> import unbound
    >>> ctx = unbound.ub_ctx()
    >>> ctx.resolvconf("/etc/resolv.conf")
    >>> status, result = ctx.resolve("www.google.com", unbound.RR_TYPE_A, unbound.RR_CLASS_IN)
    >>> if status==0 and result.havedata:
    >>>    print "Result:",result.data.address_list
    Result: ['74.125.43.147', '74.125.43.99', '74.125.43.103', '74.125.43.104']

    """

    __swig_setmethods__ = {}
    __setattr__ = lambda self, name, value: _swig_setattr(self, ub_ctx, name, value)
    __swig_getmethods__ = {}
    __getattr__ = lambda self, name: _swig_getattr(self, ub_ctx, name)

    def __init__(self, *args, **kwargs):
        raise AttributeError("No constructor defined")
    __repr__ = _swig_repr

    def __init__(self):
        """Creates a resolving and validation context.

           An exception is invoked if the process of creation an ub_ctx instance fails.
        """
        self.this = _unbound.ub_ctx_create()
        if not self.this:
            raise Exception("Fatal error: unbound context initialization failed")

    #__swig_destroy__ = _unbound.ub_ctx_free_dbg
    __swig_destroy__ = _unbound._ub_ctx_delete

    #UB_CTX_METHODS_#   
    def add_ta(self,ta):
        """Add a trust anchor to the given context.

           The trust anchor is a string, on one line, that holds a valid DNSKEY or DS RR.

           :param ta:
               string, with zone-format RR on one line. [domainname] [TTL optional] [type] [class optional] [rdata contents]
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_add_ta(self,ta)
    #parameters: struct ub_ctx *,char *,
    #retvals: int

    def add_ta_file(self,fname):
        """Add trust anchors to the given context.

           Pass name of a file with DS and DNSKEY records (like from dig or drill).

           :param fname:
               filename of file with keyfile with trust anchors.
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_add_ta_file(self,fname)
    #parameters: struct ub_ctx *,char *,
    #retvals: int

    def config(self,fname):
        """setup configuration for the given context.

           :param fname:
               unbound config file (not all settings applicable). This is a power-users interface that lets you specify all sorts of options. For some specific options, such as adding trust anchors, special routines exist.
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_config(self,fname)
    #parameters: struct ub_ctx *,char *,
    #retvals: int

    def debuglevel(self,d):
        """Set debug verbosity for the context Output is directed to stderr.

           :param d:
               debug level, 0 is off, 1 is very minimal, 2 is detailed, and 3 is lots.
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_debuglevel(self,d)
    #parameters: struct ub_ctx *,int,
    #retvals: int

    def debugout(self,out):
        """Set debug output (and error output) to the specified stream.

           Pass None to disable. Default is stderr.

           :param out:
               File stream to log to.
           :returns: (int) 0 if OK, else error.

           **Usage:**

              In order to log into file, use

              ::

                ctx = unbound.ub_ctx()
                fw = fopen("debug.log")
                ctx.debuglevel(3)
                ctx.debugout(fw)

              Another option is to print the debug informations to stderr output

              ::

                ctx = unbound.ub_ctx()
                ctx.debuglevel(10)
                ctx.debugout(sys.stderr) 
        """
        return _unbound.ub_ctx_debugout(self,out)
    #parameters: struct ub_ctx *,void *,
    #retvals: int

    def hosts(self,fname="/etc/hosts"):
        """Read list of hosts from the filename given.

           Usually "/etc/hosts". These addresses are not flagged as DNSSEC secure when queried for.

           :param fname:
               file name string. If None "/etc/hosts" is used.
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_hosts(self,fname)
    #parameters: struct ub_ctx *,char *,
    #retvals: int

    def print_local_zones(self):
        """Print the local zones and their content (RR data) to the debug output.

           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_print_local_zones(self)
    #parameters: struct ub_ctx *,
    #retvals: int

    def resolvconf(self,fname="/etc/resolv.conf"):
        """Read list of nameservers to use from the filename given.

           Usually "/etc/resolv.conf". Uses those nameservers as caching proxies. If they do not support DNSSEC, validation may fail.

           Only nameservers are picked up, the searchdomain, ndots and other settings from resolv.conf(5) are ignored.

           :param fname:
               file name string. If None "/etc/resolv.conf" is used.
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_resolvconf(self,fname)
    #parameters: struct ub_ctx *,char *,
    #retvals: int

    def set_async(self,dothread):
        """Set a context behaviour for asynchronous action.

           :param dothread:
               if True, enables threading and a call to :meth:`resolve_async` creates a thread to handle work in the background. 
               If False, a process is forked to handle work in the background. 
               Changes to this setting after :meth:`async` calls have been made have no effect (delete and re-create the context to change).
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_async(self,dothread)
    #parameters: struct ub_ctx *,int,
    #retvals: int

    def set_fwd(self,addr):
        """Set machine to forward DNS queries to, the caching resolver to use.

           IP4 or IP6 address. Forwards all DNS requests to that machine, which is expected to run a recursive resolver. If the  is not DNSSEC-capable, validation may fail. Can be called several times, in that case the addresses are used as backup servers.

           To read the list of nameservers from /etc/resolv.conf (from DHCP or so), use the call :meth:`resolvconf`.

           :param addr:
               address, IP4 or IP6 in string format. If the addr is None, forwarding is disabled.
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_set_fwd(self,addr)
    #parameters: struct ub_ctx *,char *,
    #retvals: int

    def set_option(self,opt,val):
        """Set an option for the context.

           Changes to the options after :meth:`resolve`, :meth:`resolve_async`, :meth:`zone_add`, :meth:`zone_remove`, :meth:`data_add` or :meth:`data_remove` have no effect (you have to delete and re-create the context).

           :param opt:
               option name from the unbound.conf config file format. (not all settings applicable). The name includes the trailing ':' for example set_option("logfile:", "mylog.txt"); This is a power-users interface that lets you specify all sorts of options. For some specific options, such as adding trust anchors, special routines exist.
           :param val:
               value of the option.
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_set_option(self,opt,val)
    #parameters: struct ub_ctx *,char *,char *,
    #retvals: int

    def trustedkeys(self,fname):
        """Add trust anchors to the given context.

           Pass the name of a bind-style config file with trusted-keys{}.

           :param fname:
               filename of file with bind-style config entries with trust anchors.
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_ctx_trustedkeys(self,fname)
    #parameters: struct ub_ctx *,char *,
    #retvals: int
    #_UB_CTX_METHODS#   

    def zone_print(self):
        """Print local zones using debugout"""            
        _unbound.ub_ctx_print_local_zones(self)

    def zone_add(self,zonename,zonetype):
        """Add new local zone

           :param zonename: zone domain name (e.g. myzone.)
           :param zonetype: type of the zone ("static",...) 
           :returns: (int) 0 if OK, else error. 
        """ 
        return _unbound.ub_ctx_zone_add(self,zonename, zonetype)
    #parameters: struct ub_ctx *,char*, char*
    #retvals: int

    def zone_remove(self,zonename):
        """Remove local zone

           If exists, removes local zone with all the RRs.

           :param zonename: zone domain name
           :returns: (int) 0 if OK, else error. 
        """ 
        return _unbound.ub_ctx_zone_remove(self,zonename)
    #parameters: struct ub_ctx *,char*
    #retvals: int

    def data_add(self,rrdata):
        """Add new local RR data

           :param rrdata: string, in zone-format on one line. [domainname] [TTL optional] [type] [class optional] [rdata contents]
           :returns: (int) 0 if OK, else error. 

           **Usage**
              The local data ...

              ::

                >>> ctx = unbound.ub_ctx()
                >>> ctx.zone_add("mydomain.net.","static")
                0
                >>> status = ctx.data_add("test.mydomain.net. IN A 192.168.1.1")
                0
                >>> status, result = ctx.resolve("test.mydomain.net")
                >>> if status==0 and result.havedata:
                >>>    print \"Result:\",result.data.address_list
                Result: ['192.168.1.1']

        """ 
        return _unbound.ub_ctx_data_add(self,rrdata)
    #parameters: struct ub_ctx *,char*
    #retvals: int

    def data_remove(self,rrdata):
        """Remove local RR data

           If exists, remove resource record from local zone

           :param rrdata: string, in zone-format on one line. [domainname] [TTL optional] [type] [class optional] [rdata contents]
           :returns: (int) 0 if OK, else error. 
        """ 
        return _unbound.ub_ctx_data_remove(self,rrdata)
    #parameters: struct ub_ctx *,char*
    #retvals: int

    #UB_METHODS_#
    def cancel(self,async_id):
        """Cancel an async query in progress.

           Its callback will not be called.

           :param async_id:
               which query to cancel.
           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_cancel(self,async_id)
    #parameters: struct ub_ctx *,int,
    #retvals: int

    def get_fd(self):
        """Get file descriptor.

           Wait for it to become readable, at this point answers are returned from the asynchronous validating resolver. Then call the ub_process to continue processing. This routine works immediately after context creation, the fd does not change.

           :returns: (int) -1 on error, or file descriptor to use select(2) with.
        """
        return _unbound.ub_fd(self)
    #parameters: struct ub_ctx *,
    #retvals: int

    def poll(self):
        """Poll a context to see if it has any new results Do not poll in a loop, instead extract the fd below to poll for readiness, and then check, or wait using the wait routine.

           :returns: (int) 0 if nothing to read, or nonzero if a result is available. If nonzero, call ctx_process() to do callbacks.
        """
        return _unbound.ub_poll(self)
    #parameters: struct ub_ctx *,
    #retvals: int

    def process(self):
        """Call this routine to continue processing results from the validating resolver (when the fd becomes readable).

           Will perform necessary callbacks.

           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_process(self)
    #parameters: struct ub_ctx *,
    #retvals: int

    def resolve(self,name,rrtype=RR_TYPE_A,rrclass=RR_CLASS_IN):
        """Perform resolution and validation of the target name. 

           :param name:
               domain name in text format (a string or unicode string). IDN domain name have to be passed as a unicode string.
           :param rrtype:
               type of RR in host order (optional argument). Default value is RR_TYPE_A (A class).
           :param rrclass:
               class of RR in host order (optional argument). Default value is RR_CLASS_IN (for internet).
           :returns: * (int) 0 if OK, else error.
                     * (:class:`ub_result`) the result data is returned in a newly allocated result structure. May be None on return, return value is set to an error in that case (out of memory).
        """
        if isinstance(name, bytes): #probably IDN
            return _unbound.ub_resolve(self,name,rrtype,rrclass)
        else:
            return _unbound.ub_resolve(self,idn2dname(name),rrtype,rrclass)
    #parameters: struct ub_ctx *,char *,int,int,
    #retvals: int,struct ub_result **

    def resolve_async(self,name,mydata,callback,rrtype=RR_TYPE_A,rrclass=RR_CLASS_IN):
        """Perform resolution and validation of the target name.

           Asynchronous, after a while, the callback will be called with your data and the result. 
           If an error happens during processing, your callback will be called with error set to a nonzero value (and result==None).

           :param name:
               domain name in text format (a string or unicode string). IDN domain name have to be passed as a unicode string.
           :param mydata:
               this data is your own data (you can pass arbitrary python object or None) which are passed on to the callback function.
           :param callback:
               call-back function which is called on completion of the resolution. 
           :param rrtype:
               type of RR in host order (optional argument). Default value is RR_TYPE_A (A class).
           :param rrclass:
               class of RR in host order (optional argument). Default value is RR_CLASS_IN (for internet).
           :returns: * (int) 0 if OK, else error.
                     * (int) async_id, an identifier number is returned for the query as it is in progress. It can be used to cancel the query.

           **Call-back function:**
                The call-back function looks as the follows::

                    def call_back(mydata, status, result):
                        pass

                **Parameters:** 
                    * `mydata` - mydata object
                    * `status` - 0 when a result has been found
                    * `result` - the result structure. The result may be None, in that case err is set.

        """
        if isinstance(name, bytes): #probably IDN
            return _unbound._ub_resolve_async(self,name,rrtype,rrclass,mydata,callback)
        else:
            return _unbound._ub_resolve_async(self,idn2dname(name),rrtype,rrclass,mydata,callback)
    #parameters: struct ub_ctx *,char *,int,int,void *,ub_callback_t,
    #retvals: int, int

    def wait(self):
        """Wait for a context to finish with results.

           Calls  after the wait for you. After the wait, there are no more outstanding asynchronous queries.

           :returns: (int) 0 if OK, else error.
        """
        return _unbound.ub_wait(self)
    #parameters: struct ub_ctx *,
    #retvals: int

    #_UB_METHODS#

ub_ctx_swigregister = _unbound.ub_ctx_swigregister
ub_ctx_swigregister(ub_ctx)


def ub_ctx_debugout(*args):
    return _unbound.ub_ctx_debugout(*args)
ub_ctx_debugout = _unbound.ub_ctx_debugout

def _ub_resolve_async(ctx, name, rrtype, rrclass, mydata, pyfunc):
    return _unbound._ub_resolve_async(ctx, name, rrtype, rrclass, mydata, pyfunc)
_ub_resolve_async = _unbound._ub_resolve_async

ub_resolve_async = _unbound._ub_resolve_async

def reverse(domain):
    """Reverse domain name

       Usable for reverse lookups when the IP address should be reversed
    """
    return '.'.join([a for a in domain.split(".")][::-1])

def idn2dname(idnname):
    """Converts domain name in IDN format to canonic domain name

       :param idnname: (unicode string) IDN name
       :returns: (string) domain name
    """
    return '.'.join([encodings.idna.ToASCII(a) for a in idnname.split('.')])

def dname2idn(name):
    """Converts canonic domain name in IDN format to unicode string

        :param name: (string) domain name
        :returns: (unicode string) domain name
    """
    return '.'.join([encodings.idna.ToUnicode(a) for a in name.split('.')])


# This file is compatible with both classic and new-style classes.