========================
Bug fixes
---------
- Fixed server response headers for ``Content-Type`` and ``Content-Encoding`` for
static compressed files -- by :user:`steverep`.
Server will now respond with a ``Content-Type`` appropriate for the compressed
file (e.g. ``"application/gzip"``), and omit the ``Content-Encoding`` header.
Users should expect that most clients will no longer decompress such responses
by default.
*Related issues and pull requests on GitHub:*
:issue:`4462`.
- Fixed duplicate cookie expiration calls in the CookieJar implementation
*Related issues and pull requests on GitHub:*
:issue:`7784`.
- Adjusted ``FileResponse`` to check file existence and access when preparing the response -- by :user:`steverep`.
The :py:class:`~aiohttp.web.FileResponse` class was modified to respond with
403 Forbidden or 404 Not Found as appropriate. Previously, it would cause a
server error if the path did not exist or could not be accessed. Checks for
existence, non-regular files, and permissions were expected to be done in the
route handler. For static routes, this now permits a compressed file to exist
without its uncompressed variant and still be served. In addition, this
changes the response status for files without read permission to 403, and for
non-regular files from 404 to 403 for consistency.
*Related issues and pull requests on GitHub:*
:issue:`8182`.
- Fixed ``AsyncResolver`` to match ``ThreadedResolver`` behavior
-- by :user:`bdraco`.
On system with IPv6 support, the :py:class:`~aiohttp.resolver.AsyncResolver` would not fallback
to providing A records when AAAA records were not available.
Additionally, unlike the :py:class:`~aiohttp.resolver.ThreadedResolver`, the :py:class:`~aiohttp.resolver.AsyncResolver`
did not handle link-local addresses correctly.
This change makes the behavior consistent with the :py:class:`~aiohttp.resolver.ThreadedResolver`.
*Related issues and pull requests on GitHub:*
:issue:`8270`.
- Fixed ``ws_connect`` not respecting `receive_timeout`` on WS(S) connection.
-- by :user:`arcivanov`.
*Related issues and pull requests on GitHub:*
:issue:`8444`.
- Removed blocking I/O in the event loop for static resources and refactored
exception handling -- by :user:`steverep`.
File system calls when handling requests for static routes were moved to a
separate thread to potentially improve performance. Exception handling
was tightened in order to only return 403 Forbidden or 404 Not Found responses
for expected scenarios; 500 Internal Server Error would be returned for any
unknown errors.
*Related issues and pull requests on GitHub:*
:issue:`8507`.
Features
--------
- Added a Request.wait_for_disconnection() method, as means of allowing request handlers to be notified of premature client disconnections.
*Related issues and pull requests on GitHub:*
:issue:`2492`.
- Added 5 new exceptions: :py:exc:`~aiohttp.InvalidUrlClientError`, :py:exc:`~aiohttp.RedirectClientError`,
:py:exc:`~aiohttp.NonHttpUrlClientError`, :py:exc:`~aiohttp.InvalidUrlRedirectClientError`,
:py:exc:`~aiohttp.NonHttpUrlRedirectClientError`
:py:exc:`~aiohttp.InvalidUrlRedirectClientError`, :py:exc:`~aiohttp.NonHttpUrlRedirectClientError`
are raised instead of :py:exc:`ValueError` or :py:exc:`~aiohttp.InvalidURL` when the redirect URL is invalid. Classes
:py:exc:`~aiohttp.InvalidUrlClientError`, :py:exc:`~aiohttp.RedirectClientError`,
:py:exc:`~aiohttp.NonHttpUrlClientError` are base for them.
The :py:exc:`~aiohttp.InvalidURL` now exposes a ``description`` property with the text explanation of the error details.
-- by :user:`setla`, :user:`AraHaan`, and :user:`bdraco`
*Related issues and pull requests on GitHub:*
:issue:`2507`, :issue:`3315`, :issue:`6722`, :issue:`8481`, :issue:`8482`.
- Added a feature to retry closed connections automatically for idempotent methods. -- by :user:`Dreamsorcerer`
*Related issues and pull requests on GitHub:*
:issue:`7297`.
- Implemented filter_cookies() with domain-matching and path-matching on the keys, instead of testing every single cookie.
This may break existing cookies that have been saved with `CookieJar.save()`. Cookies can be migrated with this script::
import pickle
with file_path.open("rb") as f:
cookies = pickle.load(f)
morsels = [(name, m) for c in cookies.values() for name, m in c.items()]
cookies.clear()
for name, m in morsels:
cookies[(m["domain"], m["path"].rstrip("/"))][name] = m
with file_path.open("wb") as f:
pickle.dump(cookies, f, pickle.HIGHEST_PROTOCOL)
*Related issues and pull requests on GitHub:*
:issue:`7583`, :issue:`8535`.
- Separated connection and socket timeout errors, from ServerTimeoutError.
*Related issues and pull requests on GitHub:*
:issue:`7801`.
- Implemented happy eyeballs
*Related issues and pull requests on GitHub:*
:issue:`7954`.
- Added server capability to check for static files with Brotli compression via a ``.br`` extension -- by :user:`steverep`.
*Related issues and pull requests on GitHub:*
:issue:`8062`.
Removals and backward incompatible breaking changes
---------------------------------------------------
- The shutdown logic in 3.9 waited on all tasks, which caused issues with some libraries.
In 3.10 we've changed this logic to only wait on request handlers. This means that it's
important for developers to correctly handle the lifecycle of background tasks using a
library such as ``aiojobs``. If an application is using ``handler_cancellation=True`` then
it is also a good idea to ensure that any :func:`asyncio.shield` calls are replaced with
:func:`aiojobs.aiohttp.shield`.
Please read the updated documentation on these points: \
https://docs.aiohttp.org/en/stable/web_advanced.html#graceful-shutdown \
https://docs.aiohttp.org/en/stable/web_advanced.html#web-handler-cancellation
-- by :user:`Dreamsorcerer`
*Related issues and pull requests on GitHub:*
:issue:`8495`.
Improved documentation
----------------------
- Added documentation for ``aiohttp.web.FileResponse``.
*Related issues and pull requests on GitHub:*
:issue:`3958`.
- Improved the docs for the `ssl` params.
*Related issues and pull requests on GitHub:*
:issue:`8403`.
Contributor-facing changes
--------------------------
- Enabled HTTP parser tests originally intended for 3.9.2 release -- by :user:`pajod`.
*Related issues and pull requests on GitHub:*
:issue:`8088`.
Miscellaneous internal changes
------------------------------
- Improved URL handler resolution time by indexing resources in the UrlDispatcher.
For applications with a large number of handlers, this should increase performance significantly.
-- by :user:`bdraco`
*Related issues and pull requests on GitHub:*
:issue:`7829`.
- Added `nacl_middleware <https://github.com/CosmicDNA/nacl_middleware>`_ to the list of middlewares in the third party section of the documentation.
*Related issues and pull requests on GitHub:*
:issue:`8346`.
- Minor improvements to static typing -- by :user:`Dreamsorcerer`.
*Related issues and pull requests on GitHub:*
:issue:`8364`.
- Added a 3.11-specific overloads to ``ClientSession`` -- by :user:`max-muoto`.
*Related issues and pull requests on GitHub:*
:issue:`8463`.
- Simplified path checks for ``UrlDispatcher.add_static()`` method -- by :user:`steverep`.
*Related issues and pull requests on GitHub:*
:issue:`8491`.
- Avoided creating a future on every websocket receive -- by :user:`bdraco`.
*Related issues and pull requests on GitHub:*
:issue:`8498`.
- Updated identity checks for all ``WSMsgType`` type compares -- by :user:`bdraco`.
*Related issues and pull requests on GitHub:*
:issue:`8501`.
- When using Python 3.12 or later, the writer is no longer scheduled on the event loop if it can finish synchronously. Avoiding event loop scheduling reduces latency and improves performance. -- by :user:`bdraco`.
*Related issues and pull requests on GitHub:*
:issue:`8510`.
- Restored :py:class:`~aiohttp.resolver.AsyncResolver` to be the default resolver. -- by :user:`bdraco`.
:py:class:`~aiohttp.resolver.AsyncResolver` was disabled by default because
of IPv6 compatibility issues. These issues have been resolved and
:py:class:`~aiohttp.resolver.AsyncResolver` is again now the default resolver.
*Related issues and pull requests on GitHub:*
:issue:`8522`.
----