- 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 middleware and pluggable routing.
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: 200 Content-type: text/html; charset=utf-8 Body: <!doctype html> ...
Coming from requests ? Read why we need so many lines.
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)https://aiohttp.readthedocs.io/
https://github.com/aio-libs/aiohttp-demos
Feel free to make a Pull Request for adding your link to these pages!
aio-libs Discussions: https://github.com/aio-libs/aiohttp/discussions
Matrix: #aio-libs:matrix.org
We support Stack Overflow. Please add aiohttp tag to your question there.
Optionally you may install the aiodns library (highly recommended for sake of speed).
The aiohttp community would like to thank Keepsafe (https://www.getkeepsafe.com) for its support in the early days of the project.
The latest developer version is available in a GitHub repository: https://github.com/aio-libs/aiohttp
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
