uvloop README

The project's README from github.com/MagicStack/uvloop. As one markdown file: README.md.

.. image:: https://img.shields.io/github/actions/workflow/status/MagicStack/uvloop/tests.yml?branch=master :target: https://github.com/MagicStack/uvloop/actions/workflows/tests.yml?query=branch%3Amaster

.. image:: https://img.shields.io/pypi/v/uvloop.svg :target: https://pypi.python.org/pypi/uvloop

.. image:: https://pepy.tech/badge/uvloop :target: https://pepy.tech/project/uvloop :alt: PyPI - Downloads

uvloop is a fast, drop-in replacement of the built-in asyncio event loop. uvloop is implemented in Cython and uses libuv under the hood.

The project documentation can be found here <http://uvloop.readthedocs.org/>. Please also check out the wiki <https://github.com/MagicStack/uvloop/wiki>.

Performance

uvloop makes asyncio 2-4x faster.

.. image:: https://raw.githubusercontent.com/MagicStack/uvloop/master/performance.png :target: http://magic.io/blog/uvloop-blazing-fast-python-networking/

The above chart shows the performance of an echo server with different message sizes. The sockets benchmark uses loop.sock_recv() and loop.sock_sendall() methods; the streams benchmark uses asyncio high-level streams, created by the asyncio.start_server() function; and the protocol benchmark uses loop.create_server() with a simple echo protocol. Read more about uvloop in a blog post <http://magic.io/blog/uvloop-blazing-fast-python-networking/>_ about it.

Installation

uvloop requires Python 3.8 or greater and is available on PyPI. Use pip to install it::

$ pip install uvloop

Note that it is highly recommended to upgrade pip before installing uvloop with::

$ pip install -U pip

Using uvloop

As of uvloop 0.18, the preferred way of using it is via the uvloop.run() helper function:

.. code:: python

import uvloop

async def main():
    # Main entry-point.
    ...

uvloop.run(main())

uvloop.run() works by simply configuring asyncio.run() to use uvloop, passing all of the arguments to it, such as debug, e.g. uvloop.run(main(), debug=True).

With Python 3.11 and earlier the following alternative snippet can be used:

.. code:: python

import asyncio
import sys

import uvloop

async def main():
    # Main entry-point.
    ...

if sys.version_info >= (3, 11):
    with asyncio.Runner(loop_factory=uvloop.new_event_loop) as runner:
        runner.run(main())
else:
    uvloop.install()
    asyncio.run(main())

Building From Source

To build uvloop, you'll need Python 3.8 or greater:

  1. Clone the repository:

    .. code::

    $ git clone --recursive [email protected]:MagicStack/uvloop.git $ cd uvloop

  2. Create a virtual environment and activate it:

    .. code::

    $ python3 -m venv uvloop-dev $ source uvloop-dev/bin/activate

  3. Install development dependencies:

    .. code::

    $ pip install -e .[dev]

  4. Build and run tests:

    .. code::

    $ make $ make test

License

uvloop is dual-licensed under MIT and Apache 2.0 licenses.

uvloop (MagicStack/uvloop)

Searching Database…

11.9K ·GitHub
Uvloop
Что это такое?uvloop — это быстрая замена встроенному циклу событий asyncio в Python, которую можно подключить без переписывания кода. Он построен на основе библиотеки libuv.
Это библиотека, которую я импортирую, или отдельное приложение?Это библиотека на Python/Cython: её устанавливают через pip и подключают как реализацию цикла событий для asyncio. Никакого CLI или отдельного приложения нет.
Как перевести свой код на uvloop?На Python до версии 3.11 вызовите uvloop.install(), а затем запустите asyncio.run(main()) как обычно. На 3.11 и новее используйте asyncio.Runner(loop_factory=uvloop.new_event_loop) и вызовите runner.run(main()).
Нужно ли что-то собирать или можно просто выполнить pip install?Для обычного использования готовые wheel-пакеты публикуются на PyPI. Собирать из исходников (нужны Python 3.8+, make, компилятор C и рекурсивный git clone для подмодуля libuv) придётся только если вы хотите разрабатывать сам uvloop.
Работает ли uvloop на Windows?Нет. uvloop рассчитан только на Linux и macOS. Поддержки Windows нет, потому что он оборачивает libuv так, что опирается на внутренние механизмы asyncio в стиле POSIX.
Что такое libuv и зачем uvloop его использует?libuv — это высокопроизводительная библиотека цикла событий на C, та же, на которой работает Node.js. uvloop оборачивает её в Cython, чтобы asyncio в Python получил скорость libuv без изменения способа написания асинхронного кода.
Можно ли использовать uvloop с кодом, который я уже написал для asyncio?Да. uvloop задуман как прямая замена, поэтому существующие приложения на asyncio продолжат работать без изменений, когда uvloop будет установлен как цикл событий.
Нужно ли переписывать код async/await, чтобы использовать uvloop?Нет, переписывать ничего не нужно. Достаточно установить uvloop как реализацию цикла событий, и ваш существующий код async/await будет работать поверх него.
What are similar projects?discord.py, vert.x, aiohttp, libevent, swoole-src, gnet, tokio, pingora
Which topics is it in?cython, python-3, asyncio, concurrency, python-library, async, high-performance, backend, networking, performance, apache-2.0, server
Creator
MagicStack
Size
1.8 MB
Stars
11.9K
Updated
CommitOct 01Releasev0.23.0Sep 30
Age
10y
Commits · 90 Days