Docs integrations restructure

docs/index.rst

@@ -3,11 +3,11 @@ openapi-core
 
 .. toctree::
     :hidden:
-    :maxdepth: 2
+    :maxdepth: 3
 
     unmarshalling
     validation
-    integrations
+    integrations/index
     customizations
     security
     extensions

docs/integrations.rst

@@ -491,22 +491,28 @@ This section describes integration with `Werkzeug <https://werkzeug.palletsproje
 Low level
 ~~~~~~~~~
 
-You can use ``WerkzeugOpenAPIRequest`` as a Werkzeug request factory:
+The integration defines ``WerkzeugOpenAPIRequest`` and ``WerkzeugOpenAPIResponse`` classes that convert
+Werkzeug requests and responses to OpenAPI ones.
 
-.. code-block:: python
+.. md-tab-set::
 
-    from openapi_core import unmarshal_request
-    from openapi_core.contrib.werkzeug import WerkzeugOpenAPIRequest
+    .. md-tab-item:: Request
 
-    openapi_request = WerkzeugOpenAPIRequest(werkzeug_request)
-    result = unmarshal_request(openapi_request, spec=spec)
+      .. code-block:: python
 
-You can use ``WerkzeugOpenAPIResponse`` as a Werkzeug response factory:
+         from openapi_core.contrib.werkzeug import WerkzeugOpenAPIRequest
 
-.. code-block:: python
+         openapi_request = WerkzeugOpenAPIRequest(werkzeug_request)
 
-    from openapi_core import unmarshal_response
-    from openapi_core.contrib.werkzeug import WerkzeugOpenAPIResponse
+         result = openapi.unmarshal_request(openapi_request)
 
-    openapi_response = WerkzeugOpenAPIResponse(werkzeug_response)
-    result = unmarshal_response(openapi_request, openapi_response, spec=spec)
+    .. md-tab-item:: Response
+
+      .. code-block:: python
+
+         from openapi_core.contrib.werkzeug import WerkzeugOpenAPIRequest, WerkzeugOpenAPIResponse
+
+         openapi_request = WerkzeugOpenAPIRequest(werkzeug_request)
+         openapi_response = WerkzeugOpenAPIResponse(werkzeug_response)
+
+         result = openapi.unmarshal_response(openapi_request, openapi_response)

docs/integrations/aiohttp.rst

@@ -0,0 +1,29 @@
+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)
+

docs/integrations/index.rst

@@ -0,0 +1,10 @@
+Integrations
+============
+
+.. toctree::
+    :maxdepth: 2
+
+    aiohttp
+    werkzeug
+
+Openapi-core integrates with your popular libraries and frameworks. Each integration offers different levels of integration that help validate and unmarshal your request and response data.

docs/integrations/werkzeug.rst

@@ -0,0 +1,33 @@
+Werkzeug
+========
+
+This section describes integration with `Werkzeug <https://werkzeug.palletsprojects.com>`__ a WSGI web application library.
+
+Low level
+~~~~~~~~~
+
+The integration defines ``WerkzeugOpenAPIRequest`` and ``WerkzeugOpenAPIResponse`` classes that convert
+Werkzeug requests and responses to OpenAPI ones.
+
+.. md-tab-set::
+
+    .. md-tab-item:: Request
+
+      .. code-block:: python
+
+         from openapi_core.contrib.werkzeug import WerkzeugOpenAPIRequest
+
+         openapi_request = WerkzeugOpenAPIRequest(werkzeug_request)
+
+         result = openapi.unmarshal_request(openapi_request)
+
+    .. md-tab-item:: Response
+
+      .. code-block:: python
+
+         from openapi_core.contrib.werkzeug import WerkzeugOpenAPIRequest, WerkzeugOpenAPIResponse
+
+         openapi_request = WerkzeugOpenAPIRequest(werkzeug_request)
+         openapi_response = WerkzeugOpenAPIResponse(werkzeug_response)
+
+         result = openapi.unmarshal_response(openapi_request, openapi_response)