Skip to main content

Fast implementation of asyncio event loop on top of libuv

Project description

https://travis-ci.org/MagicStack/uvloop.svg?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.

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.5 or greater and is available on PyPI. Use pip to install it:

$ pip install uvloop

Using uvloop

To make asyncio use uvloop, you can install the uvloop event loop policy:

import asyncio
import uvloop

asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())

or, starting with uvloop 0.12:

import uvloop

uvloop.install()

Building From Source

To build uvloop, you’ll need Python 3.5 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.7 -m venv uvloop-dev
    $ source uvloop-dev/bin/activate
    
  3. Install development dependencies:

    $ pip install -r requirements.dev.txt
    
  4. Build and run tests:

    $ make
    $ make test
    

License

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

Project details


Download files

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

Files for uvloop, version 0.13.0
Filename, size File type Python version Upload date Hashes
Filename, size uvloop-0.13.0-cp35-cp35m-macosx_10_11_x86_64.whl (1.5 MB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size uvloop-0.13.0-cp35-cp35m-manylinux2010_x86_64.whl (3.8 MB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size uvloop-0.13.0-cp36-cp36m-macosx_10_11_x86_64.whl (1.5 MB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size uvloop-0.13.0-cp36-cp36m-manylinux2010_x86_64.whl (3.8 MB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size uvloop-0.13.0-cp37-cp37m-macosx_10_11_x86_64.whl (1.5 MB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size uvloop-0.13.0-cp37-cp37m-manylinux2010_x86_64.whl (3.8 MB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size uvloop-0.13.0.tar.gz (2.0 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page