summaryrefslogtreecommitdiff
path: root/doc/async.rst
blob: 9f066833479c569423049304ade40ae2aa1d561d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
.. _async:

Asynchronous I/O Support
========================

The ``dns.asyncquery`` and ``dns.asyncresolver`` modules offer
asynchronous APIs equivalent to those of ``dns.query`` and
``dns.resolver``.

Dnspython presents a uniform API, but offers three different backend
implementations, to support the Trio, Curio, and asyncio libraries.
Dnspython attempts to detect which library is in use by using the
``sniffio`` library if it is available.  It's also possible to
explicitly select a "backend" library, or to pass a backend to
a particular call, allowing for use in mixed library situations.

Note that Curio is not supported for DNS-over-HTTPS, due to a
lack of support in the anyio library used by httpx.

.. toctree::

   async-query
   async-resolver
   async-backend