Spec-Zone.ru › Python 3.9

Индекс API высокого уровня

На этой странице перечислены все высокоуровневые API asyncio, поддерживающие async/await.

Задачи

Утилиты для выполнения программ asyncio, создания задач и ожидания нескольких операций с таймаутами.

run()

Создать цикл событий, запустить корутину, закрыть цикл.

create_task()

Запустить asyncio задачу.

await sleep()

Подождать определенное количество секунд.

await gather()

Планировать и ждать выполнения задач одновременно.

await wait_for()

Выполнить с таймаутом.

await shield()

Защитить от отмены.

await wait()

Отслеживать завершение.

current_task()

Возвращает текущую задачу.

all_tasks()

Возвращает все задачи для цикла событий.

Task

Объект задачи.

to_thread()

Асинхронно выполнить функцию в отдельном системном потоке.

run_coroutine_threadsafe()

Запланировать корутину из другого системного потока.

for in as_completed()

Отслеживать завершение с циклом for.

Примеры

  • Использование asyncio.gather() для выполнения задач параллельно.
  • Использование asyncio.wait_for() для применения таймаута.
  • Отмена.
  • Использование asyncio.sleep().
  • См. также основную страницу документации по задачам.

Очереди

Очереди следует использовать для распределения задач между несколькими asyncio задачами, реализации пулов подключений и паттернов издатель-подписчик.

Queue

Очередь FIFO.

PriorityQueue

Очередь с приоритетами.

LifoQueue

Очередь LIFO.

Примеры

  • Использование asyncio.Queue для распределения нагрузки между несколькими задачами.
  • См. также страницу документации по очередям.

Подпроцессы

Утилиты для запуска подпроцессов и выполнения команд оболочки.

await create_subprocess_exec()

Создать подпроцесс.

await create_subprocess_shell()

Выполнить команду оболочки.

Примеры

  • Выполнение команды оболочки.
  • См. также документацию по API подпроцессов.

Потоки

Высокоуровневые API для работы с сетевым вводом-выводом.

await open_connection()

Установить TCP-соединение.

await open_unix_connection()

Установить соединение через сокет Unix.

await start_server()

Запустить TCP-сервер.

await start_unix_server()

Запустить сервер Unix-сокет.

StreamReader

Высокоуровневый объект async/await для приема сетевых данных.

StreamWriter

Высокоуровневый объект async/await для отправки сетевых данных.

Примеры

  • Пример TCP-клиента.
  • См. также документацию по API потоков.

Синхронизация

Примитивы синхронизации, подобные потоковым, которые могут быть использованы в задачах.

Lock

Мутекс-блокировка.

Event

Объект события.

Condition

Объект условия.

Semaphore

Семафор.

BoundedSemaphore

Ограниченный семафор.

Примеры

  • Использование asyncio.Event.
  • См. также документацию по примитивам синхронизации asyncio.

Исключения

asyncio.TimeoutError

Выбрасывается при таймауте функциями, такими как wait_for(). Имейте в виду, что asyncio.TimeoutError не связан со встроенным исключением TimeoutError.

asyncio.CancelledError

Выбрасывается, когда задача отменяется. См. также Task.cancel().

Примеры

  • Обработка CancelledError для выполнения кода при запросе отмены.
  • См. также полный список исключений asyncio.

© 2001–2022 Python Software Foundation
Licensed under the PSF License.
https://docs.python.org/3.9/library/asyncio-api-index.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API