Metadata-Version: 1.1
Name: uvloop
Version: 0.8.1
Summary: Fast implementation of asyncio event loop on top of libuv
Home-page: http://github.com/MagicStack/uvloop
Author: Yury Selivanov
Author-email: yury@magic.io
License: MIT
Description-Content-Type: UNKNOWN
Description: .. 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
        
        
        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://uvloop.readthedocs.org/>`_.  Please also check out the
        `wiki <https://github.com/MagicStack/uvloop/wiki>`_.
        
        
        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
        `performance <http://magic.io/blog/uvloop-blazing-fast-python-networking/>`_.
        
        
        Installation
        ------------
        
        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
            asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
        
        Alternatively, you can create an instance of the loop
        manually, using:
        
        .. code:: python
        
            loop = uvloop.new_event_loop()
            asyncio.set_event_loop(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 git@github.com:MagicStack/uvloop.git``
        
        2. ``cd uvloop``
        
        3. ``make``
        
        4. ``make test``
        
        
        License
        -------
        
        uvloop is dual-licensed under MIT and Apache 2.0 licenses.
        
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
