https://github.com/trolldbois/python3-adns

adns-python port to python3
https://github.com/trolldbois/python3-adns

Last synced: 9 days ago
JSON representation

adns-python port to python3

• Host: GitHub
• URL: https://github.com/trolldbois/python3-adns
• Owner: trolldbois
• Created: 2013-11-18T04:38:49.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2024-01-14T19:11:31.000Z (10 months ago)
• Last Synced: 2024-05-01T19:19:43.384Z (7 months ago)
• Language: C
• Size: 49.8 KB
• Stars: 6
• Watchers: 2
• Forks: 6
• Open Issues: 1
• Metadata Files:
  • Readme: README
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
Installation Instructions

==================

Install the ADNS library and development files.

    # sudo apt install libadns1-dev

Install the python package

    $ (venv) pip install adns

You are set.

Usage

=====

See the included test programs for examples. A simple interactive

example that uses synchronous queries::

    >>> import adns

    >>> s=adns.init()

    >>> s.synchronous('python.org',adns.rr.MX)

    (0, None, 1107034862, ((50, ('mail.python.org', 0,

    ((2, '194.109.207.14'),))),))

Results are generally returned as a 4-tuple: status, CNAME, expires, answer

status is the adns status, enumerated in adns.status.

CNAME is the CNAME of the answer, if any (None if the query target is not a

CNAME)

expires is the time (in ticks) that the answer's TTL expires.

answer is what you really want. Since queries generally can return more than

one answer, answer is returned as an n-tuple. The format of each item in the

tuple depends on what type of RR was requested.::

    >>> s.synchronous('python.org',adns.rr.MXraw)

    (0, None, 1107034862, ((50, 'mail.python.org'),))

In this case, MXraw returns only the MX data (priority and hostname). MX

does further expansions upon the hostname, returning a tuple of hostname,

status for the following data, and then a tuple of rr.ADDR answers, which

are the address class and the IP address, i.e.::

    >>> s.synchronous('mail.python.org',adns.rr.ADDR)

    (0, None, 1107034862, ((2, '194.109.207.14'),))

and compare to::

    >>> s.synchronous('mail.python.org',adns.rr.A)

    (0, None, 1107034862, ('194.109.207.14',))

Prefer to use exceptions to processing status codes? adns.exception(status)

will raise an appropriate exception. Sometimes you need to have the result,

even when there is an exceptional condition. The exceptions are:

* Error

  * NotReadyError

  * LocalError

  * RemoteError

    * RemoteConfigError

    * RemoteFailureError

    * RemoteTempError

  * QueryError

  * PermanentError

    * NXDomain

    * NoData

For asynchronous examples, see ADNS.py, hostmx.py, and DNSBL.py.

DNSBL.py is very outdated in terms of actual working blacklists,

but may still be instructive.

adns-python-1.2.0 and newer *requires* at least adns-1.2. For adns-1.1

and older, use adns-python-1.1.1.

:Author:

	Andy Dustman 

:Date:

	January 27, 2007

Build Instructions

==================

First, you gotta have the adns_ libraries installed somewhere. Maybe

your OS vendor has it packaged already.

.. _adns: http://www.chiark.greenend.org.uk/~ian/adns/

    # sudo apt install libadns1-dev

For adns-python-1.2.0 and newer, you *must* have at least adns-1.2.

Second, you gotta have Distutils_, which comes in Python 1.6 and up. If you

have Python 1.5.2, *upgrade already*!

.. _Distutils: http://www.python.org/sigs/distutils-sig/download.html

Then, you can build and install::

    # try to builds the C extension

    $ python setup.py build

    # We do not distribute wheels. But this is how. Does build the C extension

    # $ python -m build -w

    # so we use a sdist instead

    $ python setup.py sdist

    # or build a sdist package with build. Does not validate the C extension.

    $ python  -m build -s

RTFM for Distutils for more options.