Spec-Zone.ru › Python 3.8

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

Эта страница перечисляет все API asyncio, поддерживающие асинхронные/ожидающие операции.

Задачи

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

run()

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

create_task()

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

await sleep()

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

await gather()

Планировать и ждать одновременного выполнения нескольких операций.

await wait_for()

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

await shield()

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

await wait()

Мониторить завершение.

current_task()

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

all_tasks()

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

Task

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

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

Объект асинхронного/ожидающего уровня для приема сетевых данных.

StreamWriter

Объект асинхронного/ожидающего уровня для отправки сетевых данных.

Примеры

  • Пример 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.8/library/asyncio-api-index.html

Spec-Zone.ru

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