Simple DNS resolver for asyncio
Project description
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 :-)
Release history Release notifications | RSS feed
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.0.tar.gz.
File metadata
- Download URL: aiodns-0.3.0.tar.gz
- Upload date:
- Size: 4.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d8cd6ff774dcae9ff351a4fdc264a18e1c33bf09e34f965fa5ad30fdba06e8c1 |
|
| MD5 | 28bf878794e505b2e2279ae65cf14bee |
|
| BLAKE2b-256 | 2de4a9a6e9b648afada8b3e2c2c25fb8988822aae8678d6f32a6e480bffca273 |
