Add docs for aiohttp integration and some comments to the test suite.

Author: sean

docs/integrations.rst

@@ -336,3 +336,33 @@ You can use ``WerkzeugOpenAPIResponse`` as a Werkzeug response factory:
 
    openapi_response = WerkzeugOpenAPIResponse(werkzeug_response)
    result = unmarshal_response(openapi_request, openapi_response, spec=spec)
+
+
+aiohttp.web
+---------
+
+This section describes integration with `aiohttp.web <https://docs.aiohttp.org/en/stable/web.html>`__ framework.
+
+Low level
+~~~~~~~~~
+
+You can use ``AIOHTTPOpenAPIWebRequest`` as an aiohttp request factory:
+
+.. code-block:: python
+
+   from openapi_core import unmarshal_request
+   from openapi_core.contrib.aiohttp import AIOHTTPOpenAPIWebRequest
+
+   request_body = await aiohttp_request.text()
+   openapi_request = AIOHTTPOpenAPIWebRequest(aiohttp_request, body=request_body)
+   result = unmarshal_request(openapi_request, spec=spec)
+
+You can use ``AIOHTTPOpenAPIWebRequest`` as an aiohttp response factory:
+
+.. code-block:: python
+
+   from openapi_core import unmarshal_response
+   from openapi_core.contrib.starlette import AIOHTTPOpenAPIWebRequest
+
+   openapi_response = StarletteOpenAPIResponse(aiohttp_response)
+   result = unmarshal_response(openapi_request, openapi_response, spec=spec)

tests/integration/contrib/aiohttp/conftest.py

@@ -22,6 +22,7 @@ def spec(factory):
 
 @pytest.fixture
 def response_getter() -> mock.MagicMock:
+    # Using a mock here allows us to control the return value for different scenarios.
     return mock.MagicMock(return_value={"data": "data"})
 
 

tests/integration/contrib/aiohttp/test_aiohttp_validation.py

@@ -26,6 +26,7 @@ async def test_aiohttp_integration_valid_input(client: TestClient):
         headers=given_headers,
     )
     response_data = await response.json()
+    # Then
     assert response.status == expected_status_code
     assert response_data == expected_response_data
 
@@ -52,5 +53,6 @@ async def test_aiohttp_integration_invalid_input(
         headers=given_headers,
     )
     response_data = await response.json()
+    # Then
     assert response.status == expected_status_code
     assert response_data == expected_response_data