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.
Web-server has middlewares and pluggable routing.
Getting started
Client
To retrieve something from the web:
import aiohttp
import asyncio
import async_timeout
async def fetch(session, url):
async with async_timeout.timeout(10):
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 wshandler(request):
ws = web.WebSocketResponse()
await ws.prepare(request)
async for msg in ws:
if msg.type == web.MsgType.text:
await ws.send_str("Hello, {}".format(msg.data))
elif msg.type == web.MsgType.binary:
await ws.send_bytes(msg.data)
elif msg.type == web.MsgType.close:
break
return ws
app = web.Application()
app.router.add_get('/echo', wshandler)
app.router.add_get('/', handle)
app.router.add_get('/{name}', handle)
web.run_app(app)Documentation
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.0.8 (2018-03-12)
Use asyncio.current_task() on Python 3.7 (#2825)
3.0.7 (2018-03-08)
Fix SSL proxy support by client. (#2810)
Restore a imperative check in setup.py for python version. The check works in parallel to environment marker. As effect a error about unsupported Python versions is raised even on outdated systems with very old setuptools version installed. (#2813)
3.0.6 (2018-03-05)
Add _reuse_address and _reuse_port to web_runner.TCPSite.__slots__. (#2792)
3.0.5 (2018-02-27)
Fix InvalidStateError on processing a sequence of two RequestHandler.data_received calls on web server. (#2773)
3.0.4 (2018-02-26)
Fix IndexError in HTTP request handling by server. (#2752)
Fix MultipartWriter.append* no longer returning part/payload. (#2759)
3.0.3 (2018-02-25)
Relax attrs dependency to minimal actually supported version 17.0.3 The change allows to avoid version conflicts with currently existing test tools.
3.0.2 (2018-02-23)
Security Fix
Prevent Windows absolute URLs in static files. Paths like /static/D:\path and /static/\\hostname\drive\path are forbidden.
3.0.1
Technical release for fixing distribution problems.
3.0.0 (2018-02-12)
Features
Speed up the PayloadWriter.write method for large request bodies. (#2126)
StreamResponse and Response are now MutableMappings. (#2246)
ClientSession publishes a set of signals to track the HTTP request execution. (#2313)
Content-Disposition fast access in ClientResponse (#2455)
Added support to Flask-style decorators with class-based Views. (#2472)
Signal handlers (registered callbacks) should be coroutines. (#2480)
Support async with test_client.ws_connect(...) (#2525)
Introduce site and application runner as underlying API for web.run_app implementation. (#2530)
Only quote multipart boundary when necessary and sanitize input (#2544)
Make the aiohttp.ClientResponse.get_encoding method public with the processing of invalid charset while detecting content encoding. (#2549)
Add optional configurable per message compression for ClientWebSocketResponse and WebSocketResponse. (#2551)
Add hysteresis to StreamReader to prevent flipping between paused and resumed states too often. (#2555)
Support .netrc by trust_env (#2581)
Avoid to create a new resource when adding a route with the same name and path of the last added resource (#2586)
MultipartWriter.boundary is str now. (#2589)
Allow a custom port to be used by TestServer (and associated pytest fixtures) (#2613)
Add param access_log_class to web.run_app function (#2615)
Add ssl parameter to client API (#2626)
Fixes performance issue introduced by #2577. When there are no middlewares installed by the user, no additional and useless code is executed. (#2629)
Rename PayloadWriter to StreamWriter (#2654)
New options reuse_port, reuse_address are added to run_app and TCPSite. (#2679)
Use custom classes to pass client signals parameters (#2686)
Use attrs library for data classes, replace namedtuple. (#2690)
Pytest fixtures renaming, add aiohttp_ prefix (#2578)
Add aiohttp- prefix for pytest-aiohttp command line parameters (#2578)
Bugfixes
Correctly process upgrade request from server to HTTP2. aiohttp does not support HTTP2 yet, the protocol is not upgraded but response is handled correctly. (#2277)
Fix ClientConnectorSSLError and ClientProxyConnectionError for proxy connector (#2408)
Fix connector convert OSError to ClientConnectorError (#2423)
Fix connection attempts for multiple dns hosts (#2424)
Fix writing to closed transport by raising asyncio.CancelledError (#2499)
Fix warning in ClientSession.__del__ by stopping to try to close it. (#2523)
Fixed race-condition for iterating addresses from the DNSCache. (#2620)
Fix default value of access_log_format argument in web.run_app (#2649)
Freeze sub-application on adding to parent app (#2656)
Do percent encoding for .url_for() parameters (#2668)
Correctly process request start time and multiple request/response headers in access log extra (#2641)
Improved Documentation
Improve tutorial docs, using literalinclude to link to the actual files. (#2396)
Small improvement docs: better example for file uploads. (#2401)
Rename from_env to trust_env in client reference. (#2451)
Fixed mistype in Proxy Support section where trust_env parameter was used in session.get(“http://python.org”, trust_env=True) method instead of aiohttp.ClientSession constructor as follows: aiohttp.ClientSession(trust_env=True). (#2688)
Fix issue with unittest example not compiling in testing docs. (#2717)
Deprecations and Removals
Simplify HTTP pipelining implementation (#2109)
Drop StreamReaderPayload and DataQueuePayload. (#2257)
Drop md5 and sha1 finger-prints (#2267)
Drop WSMessage.tp (#2321)
Drop Python 3.4 and Python 3.5.0, 3.5.1, 3.5.2. Minimal supported Python versions are 3.5.3 and 3.6.0. yield from is gone, use async/await syntax. (#2343)
Drop aiohttp.Timeout and use async_timeout.timeout instead. (#2348)
Drop resolve param from TCPConnector. (#2377)
Add DeprecationWarning for returning HTTPException (#2415)
send_str(), send_bytes(), send_json(), ping() and pong() are genuine async functions now. (#2475)
Drop undocumented app.on_pre_signal and app.on_post_signal. Signal handlers should be coroutines, support for regular functions is dropped. (#2480)
StreamResponse.drain() is not a part of public API anymore, just use await StreamResponse.write(). StreamResponse.write is converted to async function. (#2483)
Drop deprecated slow_request_timeout param and **kwargs` from RequestHandler. (#2500)
Drop deprecated resource.url(). (#2501)
Remove %u and %l format specifiers from access log format. (#2506)
Drop deprecated request.GET property. (#2547)
Simplify stream classes: drop ChunksQueue and FlowControlChunksQueue, merge FlowControlStreamReader functionality into StreamReader, drop FlowControlStreamReader name. (#2555)
Do not create a new resource on router.add_get(…, allow_head=True) (#2585)
Drop access to TCP tuning options from PayloadWriter and Response classes (#2604)
Drop deprecated encoding parameter from client API (#2606)
Deprecate verify_ssl, ssl_context and fingerprint parameters in client API (#2626)
Get rid of the legacy class StreamWriter. (#2651)
Forbid non-strings in resource.url_for() parameters. (#2668)
Deprecate inheritance from ClientSession and web.Application and custom user attributes for ClientSession, web.Request and web.Application (#2691)
Drop resp = await aiohttp.request(…) syntax for sake of async with aiohttp.request(…) as resp:. (#2540)
Forbid synchronous context managers for ClientSession and test server/client. (#2362)
Misc
#2552
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.0.8-cp36-cp36m-win_amd64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 754a10a14c54d029009ac9a1d158a73ac733bc65e2da81a87438b6c8e500bb7e |
|
| MD5 | ddc71b967fdc5e9cf61cea7f8fcb376b |
|
| BLAKE2b-256 | 5e6ccf27e7970923ec3f579d5482ef3525c280d97b5bd0642dfe4191e4a4114d |
Hashes for aiohttp-3.0.8-cp36-cp36m-win32.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 49c409ce1320483a11775368b642519347b9c36e59818f1cd82a23daa6fc3085 |
|
| MD5 | c93a79fbce042404f31c2bd549c438c3 |
|
| BLAKE2b-256 | 31b8675c7332c1d8d6aa4c3d8dd13e4b4ee1866005ce1e346f796300e0c6c476 |
Hashes for aiohttp-3.0.8-cp36-cp36m-manylinux1_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8fef5141e525b71016b299eda7c93c8719e9d014ef495fd08260dee621c1387e |
|
| MD5 | 58d0e6c930d5c5bee14565e76b01e97b |
|
| BLAKE2b-256 | 3b4ed2a08858243bbf290b0d51c9063ad757cf2524a1896109e2f5cf43d53535 |
Hashes for aiohttp-3.0.8-cp36-cp36m-manylinux1_i686.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b411005eef5bf575c439883f42c0f3a562bc98123d4892f082b07e54f4305025 |
|
| MD5 | a2f1e9dd2b32059baef585fd48ab84ae |
|
| BLAKE2b-256 | b385d5ee14b7186b66e4ec4eb8b5588c9f346286ebaf72fe21b8e75137aa7ea1 |
Hashes for aiohttp-3.0.8-cp36-cp36m-macosx_10_12_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 26b4ddf450a5781169b779c27804614dc217e5ef1a27cd8efbafb8557754da51 |
|
| MD5 | e7dd7f435bf561160b2c68f93445432e |
|
| BLAKE2b-256 | eca5eb8d88b8e53271d3c526de2f46fd7613564e7b35e16528cefbb8989a5509 |
Hashes for aiohttp-3.0.8-cp36-cp36m-macosx_10_11_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 235aa785d1615f83b607d9aff042644b6acc8661df87f4a78c45c7a16781678f |
|
| MD5 | 16449cba2e2bfa92effcb84a4507ea21 |
|
| BLAKE2b-256 | 66b96821bbb626f6002ded6cdf864da6cca850d6ff9bc5c4972a1499cb7badaa |
Hashes for aiohttp-3.0.8-cp35-cp35m-win_amd64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | f908c3888082625ce315151439f5f98fbd3bbd07446b8e14d36c8f48679b2166 |
|
| MD5 | e3556391c39c67df74699fb8555415f2 |
|
| BLAKE2b-256 | 2c9d12e5aa2055b9b6135df470571ad7119613ae7f67eff3c510acf7c649ff80 |
Hashes for aiohttp-3.0.8-cp35-cp35m-win32.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c91ff2bb4800bee4fd83108561f3ed9d127fc0a854252b02b9df22c87d95bcef |
|
| MD5 | 1d95aac602a3b63d67255050838fdfa5 |
|
| BLAKE2b-256 | cf44118d86f6d46266cfe691a16790165eb117e3390ecd98e892bd16d753e54e |
Hashes for aiohttp-3.0.8-cp35-cp35m-manylinux1_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ae84be09faff5908db2cd19649afca7f61b287b6909586f27cdc1261ff3080fe |
|
| MD5 | 33877aab15b087e1ffb85c9e4ab8d948 |
|
| BLAKE2b-256 | df2e418441c0c14aa8f30b3d2d6d88fb1fbb1704ad66c71af2d15143b5db3b50 |
Hashes for aiohttp-3.0.8-cp35-cp35m-manylinux1_i686.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1eca0e21df70a3f63d2e3e9b7639c0bd8d6382a7b088db14c0533c22d08999cd |
|
| MD5 | 6b37636c52e37818dfb0de51637ae6cb |
|
| BLAKE2b-256 | fbdd8679bd581f5809886f061fa7701712f88b41f55dcfc11d6c11e666bed3c0 |
Hashes for aiohttp-3.0.8-cp35-cp35m-macosx_10_12_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | af069a139ee4f0771c6398b7f4ad12de034712c074fc78f60c3f3f5336dc38a2 |
|
| MD5 | 9304e217eb6971d0483c40b98296c80b |
|
| BLAKE2b-256 | cb22fc3524524ae1e2495de44fc69b1b110a96d7dcaee7a516c16d605f6d99fe |
Hashes for aiohttp-3.0.8-cp35-cp35m-macosx_10_11_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2a99c2b4bace2b8052be8f949ad28654de65c76ac012d79a4ccfda32468bf7eb |
|
| MD5 | 34d1f40c3a1747b9768cf5a86b54486c |
|
| BLAKE2b-256 | 2f555b42b5ad3a7a7d7d37f9c1b3ce73857c87a33060f7f5b8c4e113c51616b3 |
Hashes for aiohttp-3.0.8-cp35-cp35m-macosx_10_10_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 74de1b425f2a873136405100af5226274fa00845b91573a4131b863fa77e22d3 |
|
| MD5 | 7b47fee1345c3f8ea4050b5ecde45eaf |
|
| BLAKE2b-256 | 88212b7ab3cc5c87c6710d65ffde66ba9fbd9759282fb55d7afc4ccd117cd931 |
