`asyncio-api-index.md`

107 строк · 9.2 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.8/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.8/library/asyncio-task.html#asyncio.run) | Создать цикл событий, запустить корутину, закрыть цикл. |16| --- | --- |17| [`create_task()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.create_task) | Запустить задачу asyncio. |18| `await` [`sleep()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.sleep) | Приостановить выполнение на заданное число секунд. |19| `await` [`gather()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.gather) | Планировать и ожидать несколько событий одновременно. |20| `await` [`wait_for()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.wait_for) | Запуск с тайм-аутом. |21| `await` [`shield()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.shield) | Защита от отмены. |22| `await` [`wait()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.wait) | Ожидание завершения. |23| [`current_task()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.current_task) | Возвращает текущую задачу. |24| [`all_tasks()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.all_tasks) | Возвращает все задачи для цикла событий. |25| [`Task`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.Task) | Объект задачи. |26| [`run_coroutine_threadsafe()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.run_coroutine_threadsafe) | Запланировать корутину из другого потока ОС. |27| `for in` [`as_completed()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.as_completed) | Ожидание завершения с циклом `for`. |2829Примеры3031- [Использование asyncio.gather() для параллельного выполнения](https://python-all.ru/3.8/library/asyncio-task.html#asyncio-example-gather).32- [Использование asyncio.wait\_for() для принудительного тайм-аута](https://python-all.ru/3.8/library/asyncio-task.html#asyncio-example-waitfor).33- [Отмена](https://python-all.ru/3.8/library/asyncio-task.html#asyncio-example-task-cancel).34- [Использование asyncio.sleep()](https://python-all.ru/3.8/library/asyncio-task.html#asyncio-example-sleep).35- См. также основную [страницу документации по задачам](https://python-all.ru/3.8/library/asyncio-task.html#coroutine).3637## Очереди3839Очереди следует использовать для распределения работы между несколькими задачами asyncio, реализации пулов соединений и шаблонов издатель-подписчик (pub/sub).4041| [`Queue`](https://python-all.ru/3.8/library/asyncio-queue.html#asyncio.Queue) | Очередь FIFO. |42| --- | --- |43| [`PriorityQueue`](https://python-all.ru/3.8/library/asyncio-queue.html#asyncio.PriorityQueue) | Очередь с приоритетом. |44| [`LifoQueue`](https://python-all.ru/3.8/library/asyncio-queue.html#asyncio.LifoQueue) | Очередь LIFO. |4546Примеры4748- [Использование asyncio.Queue для распределения нагрузки между несколькими задачами](https://python-all.ru/3.8/library/asyncio-queue.html#asyncio-example-queue-dist).49- См. также [страницу документации по очередям](https://python-all.ru/3.8/library/asyncio-queue.html#asyncio-queues).5051## Подпроцессы5253Утилиты для запуска подпроцессов и выполнения команд оболочки.5455| `await` [`create_subprocess_exec()`](https://python-all.ru/3.8/library/asyncio-subprocess.html#asyncio.create_subprocess_exec) | Создание подпроцесса. |56| --- | --- |57| `await` [`create_subprocess_shell()`](https://python-all.ru/3.8/library/asyncio-subprocess.html#asyncio.create_subprocess_shell) | Выполнение команды оболочки. |5859Примеры6061- [Выполнение команды оболочки](https://python-all.ru/3.8/library/asyncio-subprocess.html#asyncio-example-subprocess-shell).62- См. также [документацию по API подпроцессов](https://python-all.ru/3.8/library/asyncio-subprocess.html#asyncio-subprocess) .6364## Потоки данных6566Высокоуровневые API для работы с сетевым вводом-выводом.6768| `await` [`open_connection()`](https://python-all.ru/3.8/library/asyncio-stream.html#asyncio.open_connection) | Установка TCP-соединения. |69| --- | --- |70| `await` [`open_unix_connection()`](https://python-all.ru/3.8/library/asyncio-stream.html#asyncio.open_unix_connection) | Установка соединения через Unix-сокет. |71| `await` [`start_server()`](https://python-all.ru/3.8/library/asyncio-stream.html#asyncio.start_server) | Запуск TCP-сервера. |72| `await` [`start_unix_server()`](https://python-all.ru/3.8/library/asyncio-stream.html#asyncio.start_unix_server) | Запуск сервера Unix-сокетов. |73| [`StreamReader`](https://python-all.ru/3.8/library/asyncio-stream.html#asyncio.StreamReader) | Высокоуровневый async/await-объект для приёма сетевых данных. |74| [`StreamWriter`](https://python-all.ru/3.8/library/asyncio-stream.html#asyncio.StreamWriter) | Высокоуровневый async/await-объект для отправки сетевых данных. |7576Примеры7778- [Пример TCP-клиента](https://python-all.ru/3.8/library/asyncio-stream.html#asyncio-example-stream).79- См. также [документацию по API потоков данных](https://python-all.ru/3.8/library/asyncio-stream.html#asyncio-streams) .8081## Синхронизация8283Примитивы синхронизации, аналогичные используемым в threading, которые можно применять в задачах.8485| [`Lock`](https://python-all.ru/3.8/library/asyncio-sync.html#asyncio.Lock) | Блокировка мьютекс. |86| --- | --- |87| [`Event`](https://python-all.ru/3.8/library/asyncio-sync.html#asyncio.Event) | Объект события. |88| [`Condition`](https://python-all.ru/3.8/library/asyncio-sync.html#asyncio.Condition) | Объект условия. |89| [`Semaphore`](https://python-all.ru/3.8/library/asyncio-sync.html#asyncio.Semaphore) | Семафор. |90| [`BoundedSemaphore`](https://python-all.ru/3.8/library/asyncio-sync.html#asyncio.BoundedSemaphore) | Ограниченный семафор. |9192Примеры9394- [Использование asyncio.Event](https://python-all.ru/3.8/library/asyncio-sync.html#asyncio-example-sync-event).95- См. также документацию asyncio [примитивов синхронизации](https://python-all.ru/3.8/library/asyncio-sync.html#asyncio-sync).9697## Исключения9899| [`asyncio.TimeoutError`](https://python-all.ru/3.8/library/asyncio-exceptions.html#asyncio.TimeoutError) | Возбуждается при тайм-ауте функциями вроде [`wait_for()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.wait_for). Имейте в виду, что `asyncio.TimeoutError` **не связано** со встроенным исключением [`TimeoutError`](https://python-all.ru/3.8/library/exceptions.html#TimeoutError). |100| --- | --- |101| [`asyncio.CancelledError`](https://python-all.ru/3.8/library/asyncio-exceptions.html#asyncio.CancelledError) | Возникает при отмене задачи. См. также [`Task.cancel()`](https://python-all.ru/3.8/library/asyncio-task.html#asyncio.Task.cancel). |102103Примеры104105- [Обработка CancelledError для выполнения кода при запросе отмены](https://python-all.ru/3.8/library/asyncio-task.html#asyncio-example-task-cancel).106- См. также полный список [специфических исключений asyncio](https://python-all.ru/3.8/library/asyncio-exceptions.html#asyncio-exceptions).107