Skip to content
Asynchronous HTTP client/server framework for asyncio and Python
Python C Other
Branch: master
Clone or download

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.azure-pipelines Fix python 3.8 tests under Windows (#4513) Jan 18, 2020
.dependabot Backport to 3.7 branch, 3.6 is frozen Oct 20, 2019
.github Separate issue templates for different requests Jan 29, 2020
CHANGES On exit, cancel the main task first (#3805) Jan 27, 2020
aiohttp On exit, cancel the main task first (#3805) Jan 27, 2020
docs Add DEEPaaS API to built with page. (#4553) Feb 4, 2020
examples Fix ./examples/web_cookies.py to avoid a warning message Jan 26, 2020
requirements Bump codecov from 2.0.15 to 2.0.16 (#4595) Feb 24, 2020
tests Add an xfailing test expecting HTTP500 for invalid handler return values Feb 14, 2020
tools benchmarking script to time the different asyncio write options (#2179) Oct 19, 2019
vendor Bump vendored http-parser to v 77310ee commit Aug 23, 2018
.cherry_picker.toml Fix cherry-picker config Apr 13, 2018
.codecov.yml Update codecov yaml Oct 23, 2019
.editorconfig Dont inherit web exceptions for web.Response (#3462) Jan 14, 2019
.gitattributes Enable windows CI (#4176) Oct 14, 2019
.gitignore Update gitignore Oct 9, 2019
.gitmodules Turn vendored Node.js' http-parser into a git submodule (#3011) May 18, 2018
.lgtm.yml Cleanup lgtm errors (#3902) Jul 13, 2019
.readthedocs.yml Disable installing deps in RTD (#3226) Aug 28, 2018
CHANGES.rst Bump to 3.6.2 Oct 9, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Mar 20, 2018
CONTRIBUTING.rst Simplify the hello world example, explain request lifecycle (#4329) Nov 12, 2019
CONTRIBUTORS.txt On exit, cancel the main task first (#3805) Jan 27, 2020
HISTORY.rst Release aiohttp 3.5 beta 1 Dec 20, 2018
LICENSE.txt Update year Jan 13, 2020
MANIFEST.in Type annotations (#3049) Jun 18, 2018
Makefile Unify configs (#4394) Nov 27, 2019
README.rst Fix dead link in README (#4336) Nov 13, 2019
pyproject.toml Update towncrier template (#3472) Jan 1, 2019
setup.cfg Unify configs (#4394) Nov 27, 2019
setup.py Update async timeout to 4.0 alpha (#4341) Nov 13, 2019

README.rst

Async http client/server framework

aiohttp logo


Azure Pipelines status for master branch codecov.io status for master branch Latest PyPI package version Latest Read The Docs Discourse status 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 plugable routing.

Getting started

Client

To get something from the web:

import aiohttp
import asyncio

async def main():

    async with aiohttp.ClientSession() as session:
        async with session.get('http://python.org') as response:

            print("Status:", response.status)
            print("Content-type:", response.headers['content-type'])

            html = await response.text()
            print("Body:", html[:15], "...")

loop = asyncio.get_event_loop()
loop.run_until_complete(main())

This prints:

Status: 200
Content-type: text/html; charset=utf-8
Body: <!doctype html> ...

Comming from requests ? Read why we need so many lines.

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)])

if __name__ == '__main__':
    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 discourse group: https://aio-libs.discourse.group

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.