Integrations compatibility info

Author: p1c2u

README.md

@@ -38,6 +38,20 @@ and [OpenAPI v3.1](https://github.com/OAI/OpenAPI-Specification/blob/main/versio
 
 Check documentation to see more details about the features. All documentation is in the "docs" directory and online at [openapi-core.readthedocs.io](https://openapi-core.readthedocs.io)
 
+## Integrations compatibility matrix
+
+Supported [Integrations](https://openapi-core.readthedocs.io/en/latest/integrations.html) and it's variants:
+
+| Integration | Variant(s) |
+| --- | --- |
+| `aiohttp` | versions 3.8+ and 3.11+ tracks |
+| `django` | versions 4 and 5 |
+| `falcon` | version 4 |
+| `fastapi` | versions 0.11x and 0.12x |
+| `flask` | versions 2 and 3 |
+| `requests` | default dependency set |
+| `starlette` | versions 0.4x and 0.5x |
+| `werkzeug` | default dependency set |
 
 ## Installation
 

docs/contributing.md

@@ -71,3 +71,16 @@ pre-commit run --all-files
 ```
 
 Pre-commit check results are also attached to your PR through integration with GitHub Actions.
+
+### Integration compatibility matrix
+
+Contrib integrations are tested in CI against framework version variants and
+Python versions. The matrix source of truth is:
+
+- `.github/workflows/integration-tests.yml`
+
+When changing integration compatibility, update both:
+
+- dependency constraints in `pyproject.toml`
+- integration variants in `.github/workflows/integration-tests.yml`
+- information in `docs/integrations` and `README.md`

docs/integrations/aiohttp.md

@@ -2,6 +2,10 @@
 
 This section describes integration with [aiohttp.web](https://docs.aiohttp.org/en/stable/web.html) framework.
 
+## Supported versions
+
+- aiohttp versions 3.8+ and 3.11+ tracks
+
 ## Low level
 
 The integration defines classes useful for low level integration.

docs/integrations/django.md

@@ -3,6 +3,10 @@
 This section describes the integration with the [Django](https://www.djangoproject.com) web framework.
 The integration supports Django version 3.0 and above.
 
+## Supported versions
+
+- Django versions 4 and 5
+
 ## Middleware
 
 Django can be integrated using [middleware](https://docs.djangoproject.com/en/5.0/topics/http/middleware/) to apply OpenAPI validation to your entire application.

docs/integrations/falcon.md

@@ -3,6 +3,10 @@
 This section describes the integration with the [Falcon](https://falconframework.org) web framework.
 The integration supports Falcon version 3.0 and above.
 
+## Supported versions
+
+- Falcon version 4
+
 !!! warning
 
     This integration does not support multipart form body requests.

docs/integrations/fastapi.md

@@ -2,6 +2,10 @@
 
 This section describes integration with [FastAPI](https://fastapi.tiangolo.com) ASGI framework.
 
+## Supported versions
+
+- FastAPI versions 0.11x and 0.12x
+
 !!! note
 
     FastAPI also provides OpenAPI support. The main difference is that, unlike FastAPI's code-first approach, OpenAPI-core allows you to leverage your existing specification that aligns with the API-First approach. You can read more about API-first vs. code-first in the [Guide to API-first](https://www.postman.com/api-first/).

docs/integrations/flask.md

@@ -2,6 +2,10 @@
 
 This section describes integration with the [Flask](https://flask.palletsprojects.com) web framework.
 
+## Supported versions
+
+- Flask versions 2 and 3
+
 ## View decorator
 
 Flask can be integrated using a [view decorator](https://flask.palletsprojects.com/en/latest/patterns/viewdecorators/) to apply OpenAPI validation to your application's specific views.

docs/integrations/starlette.md

@@ -2,6 +2,10 @@
 
 This section describes integration with the [Starlette](https://www.starlette.io) ASGI framework.
 
+## Supported versions
+
+- Starlette versions 0.4x and 0.5x
+
 ## Middleware
 
 Starlette can be integrated using [middleware](https://www.starlette.io/middleware/) to apply OpenAPI validation to your entire application.