aiohttp 1.0 release
The first officially stable release.
We are working hard on aiohttp stability.
This release is tagged as 1.0
-- the library is mature enough for this.
Backward compatibility with previous releases is kept as usual.
Deprecation period is 1.5 years.
The list of changes is pretty long, but the most significant ones are:
Common
- HTTP headers are title-cased (
Content-Length
) now, they was upper-cased (CONTENT-LENGTH
) in previous releases. aiohttp.Timeout
is alias forasync_timeout.timeout
Client
- Client cookies support was rewritten in backward incompatible manner to split cookies with the same name but belonging to different domains #1173
ProxyConnector
is deprecated, regular methods likeClientSession.get()
acceptsproxy
andproxy_auth
parameters explicitly #998- Default settings for
aiohttp.TCPConnector
uses asynchronous DNS requests and cache for given DNS resolutions #1152
Server
- Router has handy methods for route adding like
app.router.add_get()
,app.router.add_post()
etc. #986 Request
has.multipart()
methods for easy access to multipart encoded data #1067
Testing
- Significant improvements in aiohttp testing suite: new parameters for tuning test server and client are added
Full list of changes
- Change default size for client session's connection pool from
unlimited to 20 #977 - Add IE support for cookie deletion. #994
- Remove deprecated
WebSocketResponse.wait_closed
method (BACKWARD
INCOMPATIBLE) - Remove deprecated
force
parameter forClientResponse.close
method (BACKWARD INCOMPATIBLE) - Avoid using of mutable CIMultiDict kw param in make_mocked_request
#997 - Make WebSocketResponse.close a little bit faster by avoiding new
task creating just for timeout measurement - Add
proxy
andproxy_auth
params toclient.get()
and family,
deprecateProxyConnector
#998 - Add support for websocket send_json and receive_json, synchronize
server and client API for websockets #984 - Implement router shourtcuts for most useful HTTP methods, use
app.router.add_get()
,app.router.add_post()
etc. instead of
app.router.add_route()
#986 - Support SSL connections for gunicorn worker #1003
- Move obsolete examples to legacy folder
- Switch to multidict 2.0 and title-cased strings #1015
{FOO}e
logger format is case-sensitive now- Fix logger report for unix socket 8e8469b
- Rename aiohttp.websocket to aiohttp._ws_impl
- Rename aiohttp.MsgType tp aiohttp.WSMsgType
- Introduce aiohttp.WSMessage officially
- Rename Message -> WSMessage
- Remove deprecated decode param from resp.read(decode=True)
- Use 5min default client timeout #1028
- Relax HTTP method validation in UrlDispatcher #1037
- Pin minimal supported asyncio version to 3.4.2+ (
loop.is_close()
should be present) - Remove aiohttp.websocket module (BACKWARD IMCOMPATIBLE)
Please use high-level client and server approaches - Link header for 451 status code is mandatory
- Fix test_client fixture to allow multiple clients per test #1072
- make_mocked_request now accepts dict as headers #1073
- Add Python 3.5.2/3.6+ compatibility patch for async generator
protocol change #1082 - Improvement test_client can accept instance object #1083
- Simplify ServerHttpProtocol implementation #1060
- Add a flag for optional showing directory index for static file
handling #921 - Define
web.Application.on_startup()
signal handler #1103 - Drop ChunkedParser and LinesParser #1111
- Call
Application.startup
in GunicornWebWorker #1105 - Fix client handling hostnames with 63 bytes when a port is given in
the url #1044 - Implement proxy support for ClientSession.ws_connect #1025
- Return named tuple from WebSocketResponse.can_prepare #1016
- Fix access_log_format in
GunicornWebWorker
#1117 - Setup Content-Type to application/octet-stream by default #1124
- Deprecate debug parameter from app.make_handler(), use
Application(debug=True)
instead #1121 - Remove fragment string in request path #846
- Use aiodns.DNSResolver.gethostbyname() if available #1136
- Fix static file sending on uvloop when sendfile is available #1093
- Make prettier urls if query is empty dict #1143
- Fix redirects for HEAD requests #1147
- Default value for
StreamReader.read_nowait
is -1 from now #1150 aiohttp.StreamReader
is not inherited fromasyncio.StreamReader
from now
(BACKWARD INCOMPATIBLE) #1150- Streams documentation added #1150
- Add
multipart
coroutine method for web Request object #1067 - Publish ClientSession.loop property #1149
- Fix static file with spaces #1140
- Fix piling up asyncio loop by cookie expiration callbacks #1061
- Drop
Timeout
class for sake ofasync_timeout
external library.
aiohttp.Timeout
is an alias forasync_timeout.timeout
use_dns_cache
parameter ofaiohttp.TCPConnector
isTrue
by
default (BACKWARD INCOMPATIBLE) #1152aiohttp.TCPConnector
uses asynchronous DNS resolver if available by
default (BACKWARD INCOMPATIBLE) #1152- Conform to RFC3986 - do not include url fragments in client requests #1174
- Drop
ClientSession.cookies
(BACKWARD INCOMPATIBLE) #1173 - Refactor
AbstractCookieJar
public API (BACKWARD INCOMPATIBLE) #1173 - Fix clashing cookies with have the same name but belong to different
domains (BACKWARD INCOMPATIBLE) #1125 - Support binary Content-Transfer-Encoding #1169