Python interface for c-ares

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for saghul from gravatar.com saghul

Unverified details

These details have not been verified by PyPI
Project links
Meta
Classifiers

Project description

Looking for new maintainers

https://github.com/saghul/pycares/issues/139

pycares: Python interface for c-ares

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.

Documentation

http://readthedocs.org/docs/pycares/

Bundled c-ares

pycares currently bundles c-ares as a submodule for ease of building. Using the system provided c-ares is possible if the PYCARES_USE_SYSTEM_LIB environment variable is set to 1 when building.

NOTE: Versions prior to 4.0.0 used to embed a modified c-ares with extended TTL support. That is no longer the case and as a result only A and AAAA records will have TTL information. Follow this PR in uppstream c-ares, looks like TTLs will be added: https://github.com/c-ares/c-ares/pull/393

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 encoding 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 suite:

  • 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 py36,py37,py38,py39 this will run the test suite on Python 3.6 through 3.9 (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.6 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

Verified details

These details have been verified by PyPI
Maintainers
Avatar for saghul from gravatar.com saghul

Unverified details

These details have not been verified by PyPI
Project links
Meta
Classifiers

Release history Release notifications | RSS feed

4.4.0

4.3.0

4.2.2

This version

4.2.1

4.2.0

4.1.2

4.1.1

4.0.0

3.2.3

3.2.0

3.1.1

3.1.0

3.0.0

3.0.0b5 pre-release

3.0.0b4 pre-release

3.0.0b3 pre-release

3.0.0b2 pre-release

3.0.0b1 pre-release

3.0.0b0 pre-release

2.4.0

2.3.0

2.2.0

2.1.1

2.1.0

2.0.1

2.0.0

1.0.0

0.7.0

0.6.3

0.6.2

0.6.1

0.6.0

0.5.0

0.4.0

0.3.0

0.2.0

0.1.0

Download files

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

Source Distribution

pycares-4.2.1.tar.gz (825.0 kB view hashes)

Uploaded Source

Built Distributions

pycares-4.2.1-cp310-cp310-win_amd64.whl (84.3 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

pycares-4.2.1-cp310-cp310-win32.whl (67.2 kB view hashes)

Uploaded CPython 3.10 Windows x86

pycares-4.2.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (296.6 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ARM64

pycares-4.2.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (292.3 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.12+ x86-64 manylinux: glibc 2.5+ x86-64

pycares-4.2.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl (273.2 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.12+ i686 manylinux: glibc 2.5+ i686

pycares-4.2.1-cp310-cp310-macosx_10_9_x86_64.whl (75.6 kB view hashes)

Uploaded CPython 3.10 macOS 10.9+ x86-64

pycares-4.2.1-cp39-cp39-win_amd64.whl (84.3 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

pycares-4.2.1-cp39-cp39-win32.whl (67.2 kB view hashes)

Uploaded CPython 3.9 Windows x86

pycares-4.2.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (296.6 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ARM64

pycares-4.2.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (292.3 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.12+ x86-64 manylinux: glibc 2.5+ x86-64

pycares-4.2.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl (273.2 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.12+ i686 manylinux: glibc 2.5+ i686

pycares-4.2.1-cp39-cp39-macosx_10_9_x86_64.whl (75.6 kB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

pycares-4.2.1-cp38-cp38-win_amd64.whl (84.3 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

pycares-4.2.1-cp38-cp38-win32.whl (67.2 kB view hashes)

Uploaded CPython 3.8 Windows x86

pycares-4.2.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (297.1 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ARM64

pycares-4.2.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (292.7 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.12+ x86-64 manylinux: glibc 2.5+ x86-64

pycares-4.2.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl (273.6 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.12+ i686 manylinux: glibc 2.5+ i686

pycares-4.2.1-cp38-cp38-macosx_10_9_x86_64.whl (75.6 kB view hashes)

Uploaded CPython 3.8 macOS 10.9+ x86-64

pycares-4.2.1-cp37-cp37m-win_amd64.whl (84.3 kB view hashes)

Uploaded CPython 3.7m Windows x86-64

pycares-4.2.1-cp37-cp37m-win32.whl (67.2 kB view hashes)

Uploaded CPython 3.7m Windows x86

pycares-4.2.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (295.6 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ ARM64

pycares-4.2.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (291.7 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.12+ x86-64 manylinux: glibc 2.5+ x86-64

pycares-4.2.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl (272.7 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.12+ i686 manylinux: glibc 2.5+ i686

pycares-4.2.1-cp37-cp37m-macosx_10_9_x86_64.whl (75.6 kB view hashes)

Uploaded CPython 3.7m macOS 10.9+ x86-64

pycares-4.2.1-cp36-cp36m-win_amd64.whl (84.3 kB view hashes)

Uploaded CPython 3.6m Windows x86-64

pycares-4.2.1-cp36-cp36m-win32.whl (67.2 kB view hashes)

Uploaded CPython 3.6m Windows x86

pycares-4.2.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (295.6 kB view hashes)

Uploaded CPython 3.6m manylinux: glibc 2.17+ ARM64

pycares-4.2.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (291.7 kB view hashes)

Uploaded CPython 3.6m manylinux: glibc 2.12+ x86-64 manylinux: glibc 2.5+ x86-64

pycares-4.2.1-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl (272.7 kB view hashes)

Uploaded CPython 3.6m manylinux: glibc 2.12+ i686 manylinux: glibc 2.5+ i686

pycares-4.2.1-cp36-cp36m-macosx_10_9_x86_64.whl (75.6 kB view hashes)

Uploaded CPython 3.6m macOS 10.9+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page