GitHub - MagicStack/uvloop at v0.16.0

GitHub

https://img.shields.io/github/workflow/status/MagicStack/uvloop/Tests
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

. Please also check out the

wiki

.

Performance

uvloop makes asyncio 2-4x faster.

https://raw.githubusercontent.com/MagicStack/uvloop/master/performance.png

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

about it.

Installation

uvloop requires Python 3.7 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

Call uvloop.install() before calling asyncio.run() or manually creating an asyncio event loop:

importasyncioimportuvloopasyncdefmain(): # Main entry-point. ... uvloop.install() asyncio.run(main())Building From Source

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

Clone the repository:

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

Create a virtual environment and activate it:

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

Install development dependencies:

$ pip install -e .[dev]

Build and run tests:

$ make $ make test

License

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