The Wayback Machine - https://web.archive.org/web/20190403160106/https://github.com/aio-libs/aiohttp
Skip to content
Please note that GitHub no longer supports your web browser.

We recommend upgrading to the latest Google Chrome or Firefox.

Asynchronous HTTP client/server framework for asyncio and Python
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
CHANGES Fix normalize_path_middleware behavior for patch without slash (3669) ( Mar 27, 2019
aiohttp Fix normalize_path_middleware behavior for patch without slash (3669) ( Mar 27, 2019
docs Fix spelling of "guarantee" word in comments Mar 27, 2019
examples Remove wildcard imports (#3469) Dec 28, 2018
requirements Scheduled weekly dependency update for week 09 (#3637) Mar 4, 2019
tests Fix normalize_path_middleware behavior for patch without slash (3669) ( Mar 27, 2019
tools 🐛 Fix wheel dir path in the build script Jan 22, 2019
vendor Bump vendored http-parser to v 77310ee commit Aug 23, 2018
.appveyor.yml
.cherry_picker.toml Fix cherry-picker config Apr 13, 2018
.editorconfig
.gitattributes
.gitignore
.gitmodules
.pyup.yml
.readthedocs.yml
.travis.yml
CHANGES.rst
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Mar 20, 2018
CONTRIBUTING.rst
CONTRIBUTORS.txt
HISTORY.rst Release aiohttp 3.5 beta 1 Dec 20, 2018
LICENSE.txt
MANIFEST.in
Makefile
README.rst
codecov.yml
pyproject.toml
pytest.ci.ini
pytest.ini
setup.cfg
setup.py Add 'speedups' extra dependencies group Dec 6, 2018
tox.ini

README.rst

Async http client/server framework

aiohttp logo


Travis status for master branch AppVeyor status for master branch codecov.io status for master branch Latest PyPI package version Latest Read The Docs Chat on Gitter

Key Features

  • Supports both client and server side of HTTP protocol.
  • Supports both client and server Web-Sockets out-of-the-box and avoids Callback Hell.
  • Provides Web-server with middlewares and pluggable routing.

Getting started

Client

To get something from the web:

import aiohttp
import asyncio

async def fetch(session, url):
    async with session.get(url) as response:
        return await response.text()

async def main():
    async with aiohttp.ClientSession() as session:
        html = await fetch(session, 'http://python.org')
        print(html)

if __name__ == '__main__':
    loop = asyncio.get_event_loop()
    loop.run_until_complete(main())

Server

An example using a simple server:

# examples/server_simple.py
from aiohttp import web

async def handle(request):
    name = request.match_info.get('name', "Anonymous")
    text = "Hello, " + name
    return web.Response(text=text)

async def wshandle(request):
    ws = web.WebSocketResponse()
    await ws.prepare(request)

    async for msg in ws:
        if msg.type == web.WSMsgType.text:
            await ws.send_str("Hello, {}".format(msg.data))
        elif msg.type == web.WSMsgType.binary:
            await ws.send_bytes(msg.data)
        elif msg.type == web.WSMsgType.close:
            break

    return ws


app = web.Application()
app.add_routes([web.get('/', handle),
                web.get('/echo', wshandle),
                web.get('/{name}', handle)])

web.run_app(app)

Documentation

https://aiohttp.readthedocs.io/

Demos

https://github.com/aio-libs/aiohttp-demos

External links

Feel free to make a Pull Request for adding your link to these pages!

Communication channels

aio-libs google group: https://groups.google.com/forum/#!forum/aio-libs

Feel free to post your questions and ideas here.

gitter chat https://gitter.im/aio-libs/Lobby

We support Stack Overflow. Please add aiohttp tag to your question there.

Requirements

Optionally you may install the cChardet and aiodns libraries (highly recommended for sake of speed).

License

aiohttp is offered under the Apache 2 license.

Keepsafe

The aiohttp community would like to thank Keepsafe (https://www.getkeepsafe.com) for its support in the early days of the project.

Source code

The latest developer version is available in a GitHub repository: https://github.com/aio-libs/aiohttp

Benchmarks

If you are interested in efficiency, the AsyncIO community maintains a list of benchmarks on the official wiki: https://github.com/python/asyncio/wiki/Benchmarks

You can’t perform that action at this time.