.. attention::

This is the last :doc:aiohttp <index> release tested under
Python 3.6. The 3.9 stream is dropping it from the CI and the
distribution package metadata.

Bugfixes

• Increased the upper boundary of the :doc:multidict:index dependency
  to allow for the version 6 -- by :user:hugovk.

  It used to be limited below version 7 in :doc:aiohttp <index> v3.8.1 but
  was lowered in v3.8.2 via :pr:6550 and never brought back, causing
  problems with dependency pins when upgrading. :doc:aiohttp <index> v3.8.3
  fixes that by recovering the original boundary of < 7.
  (#6950)

3.8.2 (2022-09-20, subsequently yanked on 2022-09-21)

.. note::

This release has some compatibility fixes for Python 3.11 but it may
still have some quirks. Some tests are still flaky in the CI.

.. caution::

This release has been yanked from PyPI. Modern pip will not pick it
up automatically. The reason is that is has multidict < 6 set in
the distribution package metadata (see :pr:6950). Please, use
aiohttp ~= 3.8.3, != 3.8.1 instead, if you can.

Bugfixes

• Added support for registering :rfc:OPTIONS <9110#OPTIONS>
  HTTP method handlers via :py:class:~aiohttp.web.RouteTableDef.
  (#4663)

• Started supporting :rfc:authority-form <9112#authority-form> and
  :rfc:absolute-form <9112#absolute-form> URLs on the server-side.
  (#6227)

• Fixed Python 3.11 incompatibilities by using Cython 0.29.25.
  (#6396)

• Extended the sock argument typing declaration of the
  :py:func:~aiohttp.web.run_app function as optionally
  accepting iterables.
  (#6401)

• Fixed a regression where :py:exc:~asyncio.CancelledError
  occurs on client disconnection.
  (#6719)

• Started exporting :py:class:~aiohttp.web.PrefixedSubAppResource
  under :py:mod:aiohttp.web -- by :user:Dreamsorcerer.

  This fixes a regression introduced by :pr:3469.
  (#6889)

• Dropped the :class:object type possibility from
  the :py:attr:aiohttp.ClientSession.timeout
  property return type declaration.
  (#6917),
  (#6923)

Improved Documentation

• Added clarification on configuring the app object with
  settings such as a database connection.
  (#4137)
• Extended the sock argument typing declaration of the
  :py:func:~aiohttp.web.run_app function as optionally
  accepting iterables.
  (#6401)
• Dropped the :class:object type possibility from
  the :py:attr:aiohttp.ClientSession.timeout
  property return type declaration.
  (#6917),
  (#6923)

Deprecations and Removals

• Dropped Python 3.5 support, :doc:aiohttp <index> only works
  under Python 3.6 and higher from now on.
  (#4046)

Misc

• Removed a deprecated usage of :py:func:pytest.warns(None) <pytest.warns> in tests.
  (#6663)
• (#6369), (#6399), (#6550), (#6708), (#6757), (#6857), (#6872).