Skip to main content

Fast implementation of asyncio event loop on top of libuv

Project description

https://img.shields.io/github/actions/workflow/status/MagicStack/uvloop/tests.yml?branch=master https://img.shields.io/pypi/v/uvloop.svg 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.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:

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:

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:

    $ git clone --recursive git@github.com:MagicStack/uvloop.git
    $ cd uvloop
  2. Create a virtual environment and activate it:

    $ python3 -m venv uvloop-dev
    $ source uvloop-dev/bin/activate
  3. Install development dependencies:

    $ pip install -e .[dev]
  4. Build and run tests:

    $ make
    $ make test

License

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

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

uvloop-0.21.0.tar.gz (2.5 MB view hashes)

Uploaded Source

Built Distributions

uvloop-0.21.0-cp313-cp313-musllinux_1_2_x86_64.whl (4.7 MB view hashes)

Uploaded CPython 3.13 musllinux: musl 1.2+ x86-64

uvloop-0.21.0-cp313-cp313-musllinux_1_2_aarch64.whl (4.5 MB view hashes)

Uploaded CPython 3.13 musllinux: musl 1.2+ ARM64

uvloop-0.21.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.7 MB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ x86-64

uvloop-0.21.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (4.6 MB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ ARM64

uvloop-0.21.0-cp313-cp313-macosx_10_13_x86_64.whl (819.3 kB view hashes)

Uploaded CPython 3.13 macOS 10.13+ x86-64

uvloop-0.21.0-cp313-cp313-macosx_10_13_universal2.whl (1.5 MB view hashes)

Uploaded CPython 3.13 macOS 10.13+ universal2 (ARM64, x86-64)

uvloop-0.21.0-cp312-cp312-musllinux_1_2_x86_64.whl (4.7 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.2+ x86-64

uvloop-0.21.0-cp312-cp312-musllinux_1_2_aarch64.whl (4.5 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.2+ ARM64

uvloop-0.21.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.7 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

uvloop-0.21.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (4.6 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ARM64

uvloop-0.21.0-cp312-cp312-macosx_10_13_x86_64.whl (821.3 kB view hashes)

Uploaded CPython 3.12 macOS 10.13+ x86-64

uvloop-0.21.0-cp312-cp312-macosx_10_13_universal2.whl (1.5 MB view hashes)

Uploaded CPython 3.12 macOS 10.13+ universal2 (ARM64, x86-64)

uvloop-0.21.0-cp311-cp311-musllinux_1_2_x86_64.whl (3.9 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.2+ x86-64

uvloop-0.21.0-cp311-cp311-musllinux_1_2_aarch64.whl (3.8 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.2+ ARM64

uvloop-0.21.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.0 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

uvloop-0.21.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (4.0 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ARM64

uvloop-0.21.0-cp311-cp311-macosx_10_9_x86_64.whl (805.5 kB view hashes)

Uploaded CPython 3.11 macOS 10.9+ x86-64

uvloop-0.21.0-cp311-cp311-macosx_10_9_universal2.whl (1.4 MB view hashes)

Uploaded CPython 3.11 macOS 10.9+ universal2 (ARM64, x86-64)

uvloop-0.21.0-cp310-cp310-musllinux_1_2_x86_64.whl (3.8 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.2+ x86-64

uvloop-0.21.0-cp310-cp310-musllinux_1_2_aarch64.whl (3.7 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.2+ ARM64

uvloop-0.21.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.8 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

uvloop-0.21.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (3.8 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ARM64

uvloop-0.21.0-cp310-cp310-macosx_10_9_x86_64.whl (801.9 kB view hashes)

Uploaded CPython 3.10 macOS 10.9+ x86-64

uvloop-0.21.0-cp310-cp310-macosx_10_9_universal2.whl (1.4 MB view hashes)

Uploaded CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64)

uvloop-0.21.0-cp39-cp39-musllinux_1_2_x86_64.whl (3.8 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.2+ x86-64

uvloop-0.21.0-cp39-cp39-musllinux_1_2_aarch64.whl (3.7 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.2+ ARM64

uvloop-0.21.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.8 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

uvloop-0.21.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (3.8 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ARM64

uvloop-0.21.0-cp39-cp39-macosx_10_9_x86_64.whl (800.9 kB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

uvloop-0.21.0-cp39-cp39-macosx_10_9_universal2.whl (1.4 MB view hashes)

Uploaded CPython 3.9 macOS 10.9+ universal2 (ARM64, x86-64)

uvloop-0.21.0-cp38-cp38-musllinux_1_2_x86_64.whl (4.3 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.2+ x86-64

uvloop-0.21.0-cp38-cp38-musllinux_1_2_aarch64.whl (4.2 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.2+ ARM64

uvloop-0.21.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.3 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

uvloop-0.21.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (4.3 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ARM64

uvloop-0.21.0-cp38-cp38-macosx_10_9_x86_64.whl (798.0 kB view hashes)

Uploaded CPython 3.8 macOS 10.9+ x86-64

uvloop-0.21.0-cp38-cp38-macosx_10_9_universal2.whl (1.4 MB view hashes)

Uploaded CPython 3.8 macOS 10.9+ universal2 (ARM64, x86-64)

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page