Skip to main content

Python interface for c-ares

Project description

https://badge.fury.io/py/pycares.png https://secure.travis-ci.org/saghul/pycares.png?branch=master https://ci.appveyor.com/api/projects/status/vx1wbkfq3l7nm1m8?svg=true

pycares is a Python module which provides an interface to c-ares. c-ares is a C library that performs DNS requests and name resolutions asynchronously.

Bundled c-ares

pycares currently bundles c-ares and as of pycares 1.0.0 this is a strong requirement. Upstream c-ares is not willing to apply a patch adding TTL support. I did apply the patch to the bundled c-ares, but unfortunately it breaks the ABI, so attempting to use a system provided c-ares is not possible.

Installation

GNU/Linux, macOS, Windows, others:

pip install pycares

FreeBSD:

cd /usr/ports/dns/py-pycares && make install

IDNA 2008 support

If the idna package is installed, pycares will support IDNA 2008 encodingm otherwise the builtin idna codec will be used, which provides IDNA 2003 support.

You can force this at installation time as follows:

pip install pycares[idna]

Running the test suite

There are several ways of running the test ruite:

  • Run the test with the current Python interpreter:

    From the toplevel directory, run: python tests/tests.py

  • Use Tox to run the test suite in several virtualenvs with several interpreters

    From the toplevel directory, run: tox -e py35,py36,py37 this will run the test suite on Python 3.5, 3.6 and 3.7 (you’ll need to have them installed beforehand)

Using it from the cli, a la dig

This module can be used directly from the command line in a similar fashion to dig (limited, of course):

$ python -m pycares google.com
;; QUESTION SECTION:
;google.com                  IN      A

;; ANSWER SECTION:
google.com           300     IN      A       172.217.17.142

$ python -m pycares mx google.com
;; QUESTION SECTION:
;google.com                  IN      MX

;; ANSWER SECTION:
google.com           600     IN      MX      50 alt4.aspmx.l.google.com
google.com           600     IN      MX      10 aspmx.l.google.com
google.com           600     IN      MX      40 alt3.aspmx.l.google.com
google.com           600     IN      MX      20 alt1.aspmx.l.google.com
google.com           600     IN      MX      30 alt2.aspmx.l.google.com

Author

Saúl Ibarra Corretgé <s@saghul.net>

License

Unless stated otherwise on-file pycares uses the MIT license, check LICENSE file.

Supported Python versions

Python >= 3.5 are supported. Both CPython and PyPy are supported.

Contributing

If you’d like to contribute, fork the project, make a patch and send a pull request. Have a look at the surrounding code and please, make yours look alike :-)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pycares, version 3.0.0
Filename, size File type Python version Upload date Hashes
Filename, size pycares-3.0.0-cp35-cp35m-manylinux1_i686.whl (188.3 kB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp35-cp35m-manylinux1_x86_64.whl (204.3 kB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp35-cp35m-win32.whl (57.0 kB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp35-cp35m-win_amd64.whl (70.6 kB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp36-cp36m-manylinux1_i686.whl (188.3 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp36-cp36m-manylinux1_x86_64.whl (204.3 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp36-cp36m-win32.whl (57.0 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp36-cp36m-win_amd64.whl (70.6 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp37-cp37m-manylinux1_i686.whl (188.3 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp37-cp37m-manylinux1_x86_64.whl (204.3 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp37-cp37m-win32.whl (57.0 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size pycares-3.0.0-cp37-cp37m-win_amd64.whl (70.6 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size pycares-3.0.0.tar.gz (211.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page