aiohttp¶

HTTP client/server for asyncio (PEP 3156).

Features¶

Supports both HTTP Client and HTTP Server.
Supports both Server WebSockets and Client WebSockets out-of-the-box.
Web-server has Middlewares and pluggable routing.

Library Installation¶

$ pip install aiohttp

You may want to install optional cchardet library as faster replacement for chardet:

$ pip install cchardet

Getting Started¶

Client example:

import asyncio
import aiohttp

@asyncio.coroutine
def fetch_page(url):
    response = yield from aiohttp.request('GET', url)
    assert response.status == 200
    return (yield from response.read())

content = asyncio.get_event_loop().run_until_complete(
    fetch_page('http://python.org'))
print(content)

Server example:

import asyncio
from aiohttp import web


@asyncio.coroutine
def handle(request):
    name = request.match_info.get('name', "Anonymous")
    text = "Hello, " + name
    return web.Response(body=text.encode('utf-8'))


@asyncio.coroutine
def init(loop):
    app = web.Application(loop=loop)
    app.router.add_route('GET', '/{name}', handle)

    srv = yield from loop.create_server(app.make_handler(),
                                        '127.0.0.1', 8080)
    print("Server started at http://127.0.0.1:8080")
    return srv

loop = asyncio.get_event_loop()
loop.run_until_complete(init(loop))
try:
    loop.run_forever()
except KeyboardInterrupt:
    pass

Source code¶

The project is hosted on GitHub

Please feel free to file an issue on the bug tracker if you have found a bug or have some suggestion in order to improve the library.

The library uses Travis for Continuous Integration.

IRC channel¶

You can discuss the library on Freenode at #aio-libs channel.

Dependencies¶

Python 3.3 and asyncio or Python 3.4+
chardet library
Optional cchardet library as faster replacement for chardet.

Install it manually via:
```
$ pip install cchardet
```

Contributing¶

Please read the instructions for contributors before making a Pull Request.

Authors and License¶

The aiohttp package is written mostly by Nikolay Kim and Andrew Svetlov.

It’s Apache 2 licensed and freely available.

Feel free to improve this package and send a pull request to GitHub.

Contents: