Metadata-Version: 1.1
Name: uvloop
Version: 0.13.0
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
        
        .. 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://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 in a
        `blog post <http://magic.io/blog/uvloop-blazing-fast-python-networking/>`_
        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:
        
        .. code:: python
        
            import asyncio
            import uvloop
        
            asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
        
        or, starting with uvloop 0.12:
        
        .. code:: python
        
            import uvloop
        
            uvloop.install()
        
        
        Building From Source
        --------------------
        
        To build uvloop, you'll need Python 3.5 or greater:
        
        1. Clone the repository:
        
           .. code::
        
            $ git clone --recursive git@github.com:MagicStack/uvloop.git
            $ cd uvloop
        
        2. Create a virtual environment and activate it:
        
           .. code::
        
            $ python3.7 -m venv uvloop-dev
            $ source uvloop-dev/bin/activate
        
        3. Install development dependencies:
        
           ..  code::
        
            $ pip install -r requirements.dev.txt
        
        4. Build and run tests:
        
           .. code::
        
            $ make
            $ make test
        
        
        License
        -------
        
        uvloop is dual-licensed under MIT and Apache 2.0 licenses.
        
Platform: *nix
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: AsyncIO
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: Apache Software License
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Provides: uvloop