`asyncio-api-index.md`

113 строк · 10.2 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.12/library/asyncio-api-index.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Указатель API высокого уровня89На этой странице перечислены все API asyncio высокого уровня с поддержкой async/await.1011## Задачи1213Утилиты для запуска программ asyncio, создания задач и ожидания нескольких событий с тайм-аутами.1415| [`run()`](https://python-all.ru/3.12/library/asyncio-runner.html#asyncio.run) | Создать цикл событий, запустить корутину, закрыть цикл. |16| --- | --- |17| [`Runner`](https://python-all.ru/3.12/library/asyncio-runner.html#asyncio.Runner) | Менеджер контекста, упрощающий несколько асинхронных вызовов функций. |18| [`Task`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.Task) | Объект задачи. |19| [`TaskGroup`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.TaskGroup) | Менеджер контекста, содержащий группу задач. Предоставляет удобный и надёжный способ дождаться завершения всех задач в группе. |20| [`create_task()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.create_task) | Запускает задачу asyncio и возвращает её. |21| [`current_task()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.current_task) | Возвращает текущую задачу. |22| [`all_tasks()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.all_tasks) | Возвращает все ещё не завершённые задачи для цикла событий. |23| `await` [`sleep()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.sleep) | Приостановить выполнение на заданное число секунд. |24| `await` [`gather()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.gather) | Планировать и ожидать несколько событий одновременно. |25| `await` [`wait_for()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.wait_for) | Запуск с тайм-аутом. |26| `await` [`shield()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.shield) | Защита от отмены. |27| `await` [`wait()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.wait) | Ожидание завершения. |28| [`timeout()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.timeout) | Запуск с тайм-аутом. Полезно в случаях, когда `wait_for` не подходит. |29| [`to_thread()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.to_thread) | Асинхронный запуск функции в отдельном потоке ОС. |30| [`run_coroutine_threadsafe()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.run_coroutine_threadsafe) | Запланировать корутину из другого потока ОС. |31| `for in` [`as_completed()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.as_completed) | Ожидание завершения с циклом `for`. |3233Примеры3435- [Использование asyncio.gather() для параллельного выполнения](https://python-all.ru/3.12/library/asyncio-task.html#asyncio-example-gather).36- [Использование asyncio.wait\_for() для принудительного тайм-аута](https://python-all.ru/3.12/library/asyncio-task.html#asyncio-example-waitfor).37- [Отмена](https://python-all.ru/3.12/library/asyncio-task.html#asyncio-example-task-cancel).38- [Использование asyncio.sleep()](https://python-all.ru/3.12/library/asyncio-task.html#asyncio-example-sleep).39- См. также основную [страницу документации по задачам](https://python-all.ru/3.12/library/asyncio-task.html#coroutine).4041## Очереди4243Очереди следует использовать для распределения работы между несколькими задачами asyncio, реализации пулов соединений и шаблонов издатель-подписчик (pub/sub).4445| [`Queue`](https://python-all.ru/3.12/library/asyncio-queue.html#asyncio.Queue) | Очередь FIFO. |46| --- | --- |47| [`PriorityQueue`](https://python-all.ru/3.12/library/asyncio-queue.html#asyncio.PriorityQueue) | Очередь с приоритетом. |48| [`LifoQueue`](https://python-all.ru/3.12/library/asyncio-queue.html#asyncio.LifoQueue) | Очередь LIFO. |4950Примеры5152- [Использование asyncio.Queue для распределения нагрузки между несколькими задачами](https://python-all.ru/3.12/library/asyncio-queue.html#asyncio-example-queue-dist).53- См. также [страницу документации по очередям](https://python-all.ru/3.12/library/asyncio-queue.html#asyncio-queues).5455## Подпроцессы5657Утилиты для запуска подпроцессов и выполнения команд оболочки.5859| `await` [`create_subprocess_exec()`](https://python-all.ru/3.12/library/asyncio-subprocess.html#asyncio.create_subprocess_exec) | Создание подпроцесса. |60| --- | --- |61| `await` [`create_subprocess_shell()`](https://python-all.ru/3.12/library/asyncio-subprocess.html#asyncio.create_subprocess_shell) | Выполнение команды оболочки. |6263Примеры6465- [Выполнение команды оболочки](https://python-all.ru/3.12/library/asyncio-subprocess.html#asyncio-example-subprocess-shell).66- См. также [документацию по API подпроцессов](https://python-all.ru/3.12/library/asyncio-subprocess.html#asyncio-subprocess) .6768## Потоки данных6970Высокоуровневые API для работы с сетевым вводом-выводом.7172| `await` [`open_connection()`](https://python-all.ru/3.12/library/asyncio-stream.html#asyncio.open_connection) | Установка TCP-соединения. |73| --- | --- |74| `await` [`open_unix_connection()`](https://python-all.ru/3.12/library/asyncio-stream.html#asyncio.open_unix_connection) | Установка соединения через Unix-сокет. |75| `await` [`start_server()`](https://python-all.ru/3.12/library/asyncio-stream.html#asyncio.start_server) | Запуск TCP-сервера. |76| `await` [`start_unix_server()`](https://python-all.ru/3.12/library/asyncio-stream.html#asyncio.start_unix_server) | Запуск сервера Unix-сокетов. |77| [`StreamReader`](https://python-all.ru/3.12/library/asyncio-stream.html#asyncio.StreamReader) | Высокоуровневый async/await-объект для приёма сетевых данных. |78| [`StreamWriter`](https://python-all.ru/3.12/library/asyncio-stream.html#asyncio.StreamWriter) | Высокоуровневый async/await-объект для отправки сетевых данных. |7980Примеры8182- [Пример TCP-клиента](https://python-all.ru/3.12/library/asyncio-stream.html#asyncio-example-stream).83- См. также [документацию по API потоков данных](https://python-all.ru/3.12/library/asyncio-stream.html#asyncio-streams) .8485## Синхронизация8687Примитивы синхронизации, аналогичные используемым в threading, которые можно применять в задачах.8889| [`Lock`](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio.Lock) | Блокировка мьютекс. |90| --- | --- |91| [`Event`](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio.Event) | Объект события. |92| [`Condition`](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio.Condition) | Объект условия. |93| [`Semaphore`](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio.Semaphore) | Семафор. |94| [`BoundedSemaphore`](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio.BoundedSemaphore) | Ограниченный семафор. |95| [`Barrier`](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio.Barrier) | Объект барьера. |9697Примеры9899- [Использование asyncio.Event](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio-example-sync-event).100- [Использование asyncio.Barrier](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio-example-barrier).101- См. также документацию asyncio [примитивов синхронизации](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio-sync).102103## Исключения104105| [`asyncio.CancelledError`](https://python-all.ru/3.12/library/asyncio-exceptions.html#asyncio.CancelledError) | Возникает при отмене задачи. См. также [`Task.cancel()`](https://python-all.ru/3.12/library/asyncio-task.html#asyncio.Task.cancel). |106| --- | --- |107| [`asyncio.BrokenBarrierError`](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio.BrokenBarrierError) | Возникает при нарушении Barrier. См. также [`Barrier.wait()`](https://python-all.ru/3.12/library/asyncio-sync.html#asyncio.Barrier.wait). |108109Примеры110111- [Обработка CancelledError для выполнения кода при запросе отмены](https://python-all.ru/3.12/library/asyncio-task.html#asyncio-example-task-cancel).112- См. также полный список [специфических исключений asyncio](https://python-all.ru/3.12/library/asyncio-exceptions.html#asyncio-exceptions).113