Async http client/server framework (asyncio)
Project description
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 without the Callback Hell.
Web-server has middlewares and pluggable routing.
Getting started
Client
To retrieve 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
This is simple usage example:
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
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
Python >= 3.5.3
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 it’s 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 by efficiency, AsyncIO community maintains a list of benchmarks on the official wiki: https://github.com/python/asyncio/wiki/Benchmarks
Changelog
3.3.2 (2018-06-12)
3.3.1 (2018-06-05)
3.3.0 (2018-06-01)
Features
Raise ConnectionResetError instead of CancelledError on trying to write to a closed stream. (#2499)
Implement ClientTimeout class and support socket read timeout. (#2768)
Enable logging when aiohttp.web is used as a program (#2956)
Add canonical property to resources (#2968)
Forbid reading response BODY after release (#2983)
Implement base protocol class to avoid a dependency from internal asyncio.streams.FlowControlMixin (#2986)
Cythonize @helpers.reify, 5% boost on macro benchmark (#2995)
Optimize HTTP parser (#3015)
Implement runner.addresses property. (#3036)
Use bytearray instead of a list of bytes in websocket reader. It improves websocket message reading a little. (#3039)
Remove heartbeat on closing connection on keepalive timeout. The used hack violates HTTP protocol. (#3041)
Limit websocket message size on reading to 4 MB by default. (#3045)
Bugfixes
Improved Documentation
Deprecations and Removals
Deprecate custom application’s router. (#3021)
Misc
#3008, #3011
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for aiohttp-3.4.0a3-cp37-cp37m-win_amd64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c9c210a27767e4f7dc85141a3f7eef105fecc1de099411a3285d0270ca37f2db |
|
| MD5 | 8dc68e423737779dc74d60f2335ac807 |
|
| BLAKE2b-256 | 3dd7c921dcf51e81c0927924075b7dc1162e1917acf27a62e2d477f2461af588 |
Hashes for aiohttp-3.4.0a3-cp37-cp37m-win32.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0806af1a897209d19283136cd78933a6bfa23f325a310e0007ffd8fe6a769b7f |
|
| MD5 | b6fe8c299a2c1f7dca9da730f365b7e8 |
|
| BLAKE2b-256 | 25a04fb7ab4e6c36d87291a82e6951e1c123c3a0cf6e5caa24d1e0d67e691091 |
Hashes for aiohttp-3.4.0a3-cp37-cp37m-macosx_10_13_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 679c70e02b3eada98402bc2eee29e137f2ef3280812d89c839fe79f516ea581f |
|
| MD5 | 1e8565cce40a0c7824337a9806c4c7ea |
|
| BLAKE2b-256 | 416c1ba23a35d092c190077af3318a89d49083118cb22a669630a17a873d90b7 |
Hashes for aiohttp-3.4.0a3-cp37-cp37m-macosx_10_11_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | cc845189759ab8d16f6b79457f9e49712567dd3533d63eac51cafd24ab36541b |
|
| MD5 | 5a54c0394afda50900deab764cbd8583 |
|
| BLAKE2b-256 | d761baf7c0b704a11820daba11ebadc9f35ceb91382d9ce244ec1b3b1b17bb2b |
Hashes for aiohttp-3.4.0a3-cp37-cp37m-macosx_10_10_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a9c119b18b3da7c4ecdcb2486f60677bfc1126591042679c5afd0c4d3088aebe |
|
| MD5 | 1121fd8f71a9778a74089bb0f1fb8a4a |
|
| BLAKE2b-256 | e649aa5af030cc816afc737c4fc7b3553a19658b664ef25b530efc2d05832976 |
Hashes for aiohttp-3.4.0a3-cp36-cp36m-win_amd64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3c17317d75464e32dbbbc48de593ab74047bca8bc9523645a9f6040884f6b87b |
|
| MD5 | d4e7d8bd5c24c608de2d379775f5bf86 |
|
| BLAKE2b-256 | 14b7716ac53ecd2103bdeacb89f4622f5badf6aa86c4155233ba0da314546088 |
Hashes for aiohttp-3.4.0a3-cp36-cp36m-win32.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 96f328f8d0d6a38c5ef630f8b3e49e36463c9d9438fb0f89101323b5e1166b8c |
|
| MD5 | 7faced57d40543a2c5c46aa406268706 |
|
| BLAKE2b-256 | 2f1f9bfa36f45a7611abf71a3ecade91271ed6bf48a1abeba5fefbf615c0cba6 |
Hashes for aiohttp-3.4.0a3-cp36-cp36m-macosx_10_13_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 33f6d47f973dfc10bbf9524864f85b85255591ec782a60646945baff762934ba |
|
| MD5 | a9dcff5753d556945edf53e9a980b199 |
|
| BLAKE2b-256 | 181ff12ad9d656781e164a06757ea32b9c3d58f0911c239c0c47841326cb06cc |
Hashes for aiohttp-3.4.0a3-cp36-cp36m-macosx_10_11_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4c9c6d4e8c8939fa613c32759126218b6e8605dcea86053ff388b36b11597f01 |
|
| MD5 | a4171a4349d3b740a5fbcf66e578ce8f |
|
| BLAKE2b-256 | 55df49a04d4ea5d35425e91b5c113f188e07710e7e99abecd9196d43f37ad859 |
Hashes for aiohttp-3.4.0a3-cp36-cp36m-macosx_10_10_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3f5f40446bb627b4b17fd634a48114ae761b93b8c094aa658f281e4634ddf492 |
|
| MD5 | e53692b3ccc0ec648d8be78d5c5b2a02 |
|
| BLAKE2b-256 | 5cd80110de6d6e42cd6fef5d4b40411f0030894d4c118ac168ac16f9ae5d89a7 |
Hashes for aiohttp-3.4.0a3-cp35-cp35m-win_amd64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 582f29242532f0c07f6d59d20e2b0f29d18b909dc136c26b646838f8d8192797 |
|
| MD5 | 06266eaf7e2e9054f77097ae70c5c1b4 |
|
| BLAKE2b-256 | 9b44ed24948fe9491623bf593a58826f69d633789cc6ac2b70304fb17bf81bff |
Hashes for aiohttp-3.4.0a3-cp35-cp35m-win32.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c00215fb860880c72f731adba3fb10b2603f7c879cf9f602208a6910bd37505d |
|
| MD5 | e4e8ad12e3736b53d488fc012567488d |
|
| BLAKE2b-256 | edbdca3ab080868007c0777856ae5139339e97d3b272954707eb0ac4db4c0513 |
Hashes for aiohttp-3.4.0a3-cp35-cp35m-macosx_10_13_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | daaa8a6c4755bb227412ad1a1b3ab477f13e8b4813a0de9a5562726b048e350a |
|
| MD5 | a7730420cda8f63b363ada1b60792226 |
|
| BLAKE2b-256 | 0609def4a5b8f55a8129bb0928bf7cd7673d8d924e8332f359c71de500e4f50e |
Hashes for aiohttp-3.4.0a3-cp35-cp35m-macosx_10_11_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8f8341c1cbe4b6753161224891d39ffc9058af8e51f298f389ac2b06f06bf84f |
|
| MD5 | d229e4e5bc2828234fc291301677c986 |
|
| BLAKE2b-256 | 94af9629a98b8d591394739e82abe507fceb9dc08d5e80e3eff3805198b499a6 |
Hashes for aiohttp-3.4.0a3-cp35-cp35m-macosx_10_10_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3ecdc77c5d622d2d33cbc05ceed37004bbfe0d9504e018762841587225ceddf3 |
|
| MD5 | f46562eec492a69877e9bfb840cccde1 |
|
| BLAKE2b-256 | cd0f6475167b34d34a79237d991db4340c6f79106d373ff3b0f6e8f893c2e9a6 |
