Merge pull request #558 from chirizxc/starlette-integration

add warn for starlette integration

Author: Tishka17

docs/integrations/index.rst

@@ -69,7 +69,7 @@ Some of the integrations are supported by a community, refer to their documentat
      -
      - `Jobify <https://github.com/C3EQUALZz/dishka-jobify>`_ (:abbr:`com (Community support)`)
      -
-   * -  :ref:`Starlette`
+   * -  `Starlette <https://github.com/reagento/starlette-dishka>`_ (:abbr:`com (Community support)`)
      -
      -
      -

docs/integrations/starlette.rst

@@ -3,6 +3,12 @@
 Starlette
 ===========================================
 
+.. warning::
+   The integration has been moved to the `starlette-dishka <https://github.com/reagento/starlette-dishka>`_ package and will be removed in future versions.
+    .. code-block:: shell
+
+        pip install starlette-dishka
+
 Though it is not required, you can use *dishka-starlette* integration. It features:
 
 * automatic *REQUEST* and *SESSION* scope management using middleware

src/dishka/integrations/starlette.py

@@ -5,6 +5,7 @@
     "setup_dishka",
 ]
 
+import warnings
 from collections.abc import Callable
 from typing import ParamSpec, TypeVar
 
@@ -20,6 +21,14 @@
 T = TypeVar("T")
 P = ParamSpec("P")
 
+warnings.warn(
+    "`dishka.integrations.starlette` will be removed in `dishka==2.0`.\n"
+    "Use `starlette-dishka` package instead, as integrations "
+    "are now maintained in separate third-party packages for faster updates.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
 
 def inject(func: Callable[P, T]) -> Callable[P, T]:
     return wrap_injection(