Metadata-Version: 2.0
Name: uvloop
Version: 0.9.1
Summary: Fast implementation of asyncio event loop on top of libuv
Author: Yury Selivanov
License: MIT
Description-Content-Type: UNKNOWN
Platform: *nix
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: License :: OSI Approved :: Apache Software License
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Provides: uvloop

.. image::

.. image::

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 <>`_.


uvloop makes asyncio 2-4x faster.

.. image:: 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
`performance <>`_.


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

.. code:: python

    import asyncio
    import uvloop

Alternatively, you can create an instance of the loop
manually, using:

.. code:: python

    loop = uvloop.new_event_loop()

Development of uvloop

To build uvloop, you'll need Cython and Python 3.5.  The best way
is to create a virtual env, so that you'll have ``cython`` and
``python`` commands pointing to the correct tools.

1. ``git clone --recursive``

2. ``cd uvloop``

3. ``make``

4. ``make test``


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