aiodns provides a simple way for doing asynchronous DNS resolutions with a synchronous looking interface by using pycares.
Example
import asyncio
import aiodns
loop = asyncio.get_event_loop()
resolver = aiodns.DNSResolver(loop=loop)
f = resolver.query('google.com','A')
result = loop.run_until_complete(f)
print(result)
The following query types are supported: A, AAAA, CNAME, MX, NAPTR, NS, PTR, SOA, SRV, TXT.
API
The API is pretty simple, two functions are provided in the DNSResolver class:
query(host, type): Do a DNS resolution of the given type for the given hostname. It returns an instance of asyncio.Future.
cancel(): Cancel all pending DNS queries. All futures will get DNSError exception set, with ARES_ECANCELLED errno.
Running the test suite
To run the test suite: python test_aiodns.py
License
aiodns uses the MIT license, check LICENSE file.
Python versions
Python 3.4 is natively supported. Python 3.3 supported using the asyncio package. Older Python versions(2.6 - 3.2) are supported using trollius.
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 :-)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file aiodns-0.3.1.tar.gz.
File metadata
- Download URL: aiodns-0.3.1.tar.gz
- Upload date:
- Size: 4.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3138c10391903202325b38692b5dc0c2c1eb6d0db07bcce96e0384e7da95b421
|
|
| MD5 |
90adcd2524a8d9feb6463f4b795935a7
|
|
| BLAKE2b-256 |
ef55d2e44f0b43ae2ba9ba6ec37122e1dc381d2f44353154999c0a8ab5adf4b8
|
