:mod:`!asyncio` --- Asynchronous I/O
Python 3.14 Docs · نسخهٔ 3.14.10 · PSF License
:mod:!asyncio --- Asynchronous I/O
:synopsis: Asynchronous I/O.
-------------------------------
::
import asyncio
async def main(): print('Hello ...') await asyncio.sleep(1) print('... World!')
asyncio.run(main())
asyncio is a library to write concurrent code using the async/await syntax.
asyncio is used as a foundation for multiple Python asynchronous frameworks that provide high-performance network and web-servers, database connection libraries, distributed task queues, etc.
asyncio is often a perfect fit for IO-bound and high-level structured network code.
a-conceptual-overview-of-asyncio Explanation of the fundamentals of asyncio.
asyncio provides a set of high-level APIs to:
run Python coroutines <coroutine>concurrently and
have full control over their execution;
- perform
network IO and IPC <asyncio-streams>;
- control
subprocesses <asyncio-subprocess>;
- distribute tasks via
queues <asyncio-queues>;
synchronize <asyncio-sync>concurrent code;
For introspection, asyncio provides APIs and tools for:
- inspecting the
async call graph <asyncio-graph>of tasks and futures;
- inspecting tasks in another running Python process with
command-line tools <asyncio-introspection-tools>;
Additionally, there are low-level APIs for *library and framework developers* to:
- create and manage
event loops <asyncio-event-loop>, which
provide asynchronous APIs for networking <loop_create_server>, running subprocesses <loop_subprocess_exec>, handling OS signals <loop_add_signal_handler>, etc;
- implement efficient protocols using
transports <asyncio-transports-protocols>;
bridge <asyncio-futures>callback-based libraries and code
with async/await syntax.
You can experiment with an `asyncio concurrent context in the REPL`:
$ python -m asyncio
asyncio REPL ...
Use "await" directly instead of "asyncio.run()".
Type "help", "copyright", "credits" or "license" for more information.
>>> import asyncio
>>> await asyncio.sleep(10, result='hello')
'hello'This REPL provides limited compatibility with PYTHON_BASIC_REPL. It is recommended that the default REPL is used for full functionality and the latest features.
Emits audit events.
Uses PyREPL if possible, in which case PYTHONSTARTUP is also executed. Emits audit events.
the "Reference" subsection in the TOC.
:caption: High-level APIs :maxdepth: 1
asyncio-runner.rst asyncio-task.rst asyncio-stream.rst asyncio-sync.rst asyncio-subprocess.rst asyncio-queue.rst asyncio-exceptions.rst
:caption: Introspection APIs :maxdepth: 1
asyncio-graph.rst asyncio-tools.rst
:caption: Low-level APIs :maxdepth: 1
asyncio-eventloop.rst asyncio-future.rst asyncio-protocol.rst asyncio-policy.rst asyncio-platforms.rst asyncio-extending.rst
:caption: Guides and Tutorials :maxdepth: 1
asyncio-api-index.rst asyncio-llapi-index.rst asyncio-dev.rst asyncio-threading.rst
The source code for asyncio can be found in Lib/asyncio/.