Metadata-Version: 1.1
Name: aiorest
Version: 0.1.1
Summary: Support REST calls for asyncio+aiohttp.
Home-page: http://aiorest.readthedocs.org
Author: Andrew Svetlov
Author-email: andrew.svetlov@gmail.com
License: BSD
Download-URL: https://pypi.python.org/pypi/aiorest
Description: aiorest
        =======
        
        JSON REST framework based on aiohttp (an asyncio (PEP 3156) http server).
        
        .. image:: https://travis-ci.org/aio-libs/aiorest.svg?branch=master
           :target: https://travis-ci.org/aio-libs/aiorest
        
        
        Example usage
        -------------
        
        Simple REST server can be run like this::
        
            import asyncio
            import aiohttp
            import aiorest
        
        
            # define a simple request handler
            # which accept no arguments
            # and responds with json
            def hello():
                return {'hello': 'world'}
        
        
            loop = asyncio.get_event_loop()
            server = aiorest.RESTServer(hostname='127.0.0.1',
                                        loop=loop)
        
            # configure routes
            server.add_url('GET', '/hello', hello)
            # create server
            srv = loop.run_until_complete(loop.create_server(
                server.make_handler, '127.0.0.1', 8080))
        
        
            @asyncio.coroutine
            def query():
                resp = yield from aiohttp.request(
                    'GET', 'http://127.0.0.1:8080/hello', loop=loop)
                data = yield from resp.read_and_close(decode=True)
                print(data)
        
        
            loop.run_until_complete(query())
            srv.close()
            loop.run_until_complete(srv.wait_closed())
            loop.close()
        
        this will print ``{'hello': 'world'}`` json
        
        See `examples <https://github.com/aio-libs/aiorest/tree/master/examples>`_ for more.
        
        
        Requirements
        ------------
        
        - Python 3.3
        
        - asyncio http://code.google.com/p/tulip/ or Python 3.4+
        
        - aiohttp http://github.com/KeepSafe/aiohttp
        
        - optional module ``aiorest.redis_session`` requires asyncio_redis
          https://github.com/jonathanslenders/asyncio-redis
        
        License
        -------
        
        aiorest is offered under the MIT license.
        
        CHANGES
        -------
        
        0.1.1 (2014-07-09)
        ^^^^^^^^^^^^^^^^^^
        
        * Switched to aiohttp v0.9.0
        
        
        0.1.0 (2014-07-07)
        ^^^^^^^^^^^^^^^^^^
        
        * Basic REST API
Platform: OS Independent
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Operating System :: OS Independent
Classifier: Environment :: Web Environment
Requires: aiohttp
Provides: aiorest
