aiodns provides a simple way for doing asynchronous DNS resolutions with a synchronous looking interface by using pycares.
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.
The library supports both asyncio and Trollius.
If you use Python 3 you may use yield from statement:
@asyncio.coroutine
def func():
result = yield from resolver.query('google.com','A')
For Trollius you should use another syntax like:
@trollius.coroutine
def func():
result = yield trollius.From(resolver.query('google.com','A'))
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 ofasyncio.Future
. The actual result of the DNS query is taken directly from pycares. As of version 1.0.0 of aiodns (and pycares, for that matter) results are always namedtuple-like objects with different attributes. Please check the documentation for the result fields.cancel()
: Cancel all pending DNS queries. All futures will getDNSError
exception set, withARES_ECANCELLED
errno.
To run the test suite: python test_aiodns.py
Saúl Ibarra Corretgé <[email protected]>
aiodns uses the MIT license, check LICENSE file.
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.
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 :-)