[pull] master from aio-libs:master

CHANGES/10945.feature.rst

@@ -0,0 +1 @@
+9732.feature.rst

CHANGES/10961.feature.rst

@@ -0,0 +1 @@
+10520.feature.rst

CHANGES/10962.feature.rst

@@ -0,0 +1 @@
+10520.feature.rst

CHANGES/10968.bugfix.rst

@@ -0,0 +1 @@
+Fixed double compression issue when :py:meth:`~aiohttp.web.StreamResponse.enable_compression` is called on a response with pre-existing Content-Encoding header -- by :user:`bdraco`.

CHANGES/10968.feature.rst

@@ -0,0 +1 @@
+9732.feature.rst

CHANGES/10972.feature.rst

@@ -0,0 +1 @@
+Upgraded to LLHTTP 9.3.0 -- by :user:`Dreamsorcerer`.

aiohttp/web_response.py

@@ -186,6 +186,13 @@ def enable_compression(
         strategy: Optional[int] = None,
     ) -> None:
         """Enables response compression encoding."""
+        # Don't enable compression if content is already encoded.
+        # This prevents double compression and provides a safe, predictable behavior
+        # without breaking existing code that may call enable_compression() on
+        # responses that already have Content-Encoding set (e.g., FileResponse
+        # serving pre-compressed files).
+        if hdrs.CONTENT_ENCODING in self._headers:
+            return
         self._compression = True
         self._compression_force = force
         self._compression_strategy = strategy

docs/client.rst

@@ -14,6 +14,7 @@ The page contains all information about aiohttp Client API:
 
    Quickstart <client_quickstart>
    Advanced Usage <client_advanced>
+   Client Middleware Cookbook <client_middleware_cookbook>
    Reference <client_reference>
    Tracing Reference <tracing_reference>
    The aiohttp Request Lifecycle <http_request_lifecycle>

docs/client_advanced.rst

@@ -133,6 +133,8 @@ Client Middleware
 The client supports middleware to intercept requests and responses. This can be
 useful for authentication, logging, request/response modification, and retries.
 
+For practical examples and common middleware patterns, see the :ref:`aiohttp-client-middleware-cookbook`.
+
 Creating Middleware
 ^^^^^^^^^^^^^^^^^^^
 
@@ -713,12 +715,26 @@ make all sockets respect 9*7200 = 18 hours::
   import socket
 
   def socket_factory(addr_info):
-      family, type_, proto, _, _, _ = addr_info
+      family, type_, proto, _, _ = addr_info
       sock = socket.socket(family=family, type=type_, proto=proto)
       sock.setsockopt(socket.SOL_SOCKET,  socket.SO_KEEPALIVE,  True)
       sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPIDLE,  7200)
       sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPCNT,      9)
       return sock
+
+  conn = aiohttp.TCPConnector(socket_factory=socket_factory)
+
+``socket_factory`` may also be used for binding to the specific network
+interface on supported platforms::
+
+  def socket_factory(addr_info):
+      family, type_, proto, _, _ = addr_info
+      sock = socket.socket(family=family, type=type_, proto=proto)
+      sock.setsockopt(
+          socket.SOL_SOCKET, socket.SO_BINDTODEVICE, b'eth0'
+      )
+      return sock
+
   conn = aiohttp.TCPConnector(socket_factory=socket_factory)