Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 12,973 Commits
.github		.github
CHANGES		CHANGES
aiohttp		aiohttp
docs		docs
examples		examples
requirements		requirements
tests		tests
tools		tools
vendor		vendor
.cherry_picker.toml		.cherry_picker.toml
.codecov.yml		.codecov.yml
.coveragerc.toml		.coveragerc.toml
.editorconfig		.editorconfig
.git-blame-ignore-revs		.git-blame-ignore-revs
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.lgtm.yml		.lgtm.yml
.mypy.ini		.mypy.ini
.pip-tools.toml		.pip-tools.toml
.pre-commit-config.yaml		.pre-commit-config.yaml
.readthedocs.yml		.readthedocs.yml
CHANGES.rst		CHANGES.rst
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.rst		CONTRIBUTING.rst
CONTRIBUTORS.txt		CONTRIBUTORS.txt
LICENSE.txt		LICENSE.txt
MANIFEST.in		MANIFEST.in
Makefile		Makefile
README.rst		README.rst
pyproject.toml		pyproject.toml
setup.cfg		setup.cfg
setup.py		setup.py

Repository files navigation

Async http client/server framework

Key Features

Supports both client and server side of HTTP protocol.
Supports both client and server Web-Sockets out-of-the-box and avoidsCallback Hell.
Provides Web-server with middleware and pluggable routing.

Getting started

Client

To get something from the web:

importaiohttpimportasyncioasyncdefmain():asyncwithaiohttp.ClientSession()assession:asyncwithsession.get('http://python.org')asresponse:print("Status:",response.status)print("Content-type:",response.headers['content-type'])html=awaitresponse.text()print("Body:",html[:15],"...")asyncio.run(main())

This prints:

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

Coming fromrequests ? Readwhy we need so many lines.

Server

An example using a simple server:

# examples/server_simple.pyfromaiohttpimportwebasyncdefhandle(request):name=request.match_info.get('name',"Anonymous")text="Hello, "+namereturnweb.Response(text=text)asyncdefwshandle(request):ws=web.WebSocketResponse()awaitws.prepare(request)asyncformsginws:ifmsg.type==web.WSMsgType.text:awaitws.send_str("Hello, {}".format(msg.data))elifmsg.type==web.WSMsgType.binary:awaitws.send_bytes(msg.data)elifmsg.type==web.WSMsgType.close:breakreturnwsapp=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 Discussions:https://github.com/aio-libs/aiohttp/discussions

Matrix:#aio-libs:matrix.org

We supportStack Overflow.Please addaiohttp tag to your question there.

Requirements

Optionally you may install theaiodns library (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 ofthe 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 alist of benchmarks on the official wiki:https://github.com/python/asyncio/wiki/Benchmarks