Github url

uvloop

by MagicStack

MagicStack /uvloop

Ultra fast asyncio event loop.

7.0K Stars 410 Forks Last release: 8 months ago (v0.14.0) Other 853 Commits 71 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

.. image:: https://travis-ci.org/MagicStack/uvloop.svg?branch=master :target: https://travis-ci.org/MagicStack/uvloop

.. 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:></http:>

_. Please also check out the

wiki <https:></https:>
```_.
## Performance

uvloop makes asyncio 2-4x faster.

.. image:: 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:

\_ about it.
## Installation

uvloop requires Python 3.5 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:

.. code:: python

import asyncio import uvloop async def main(): # Main entry-point. ... uvloop.install() asyncio.run(main())


## Building From Source

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

1. Clone the repository:

.. code::

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


1. Create a virtual environment and activate it:

.. code::

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


1. Install development dependencies:

.. code::

$ pip install -r requirements.dev.txt


1. Build and run tests:

.. code::

$ make $ make test

```

License

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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.