Deprecate WSGIMiddleware in favor of a2wsgi (#1504)

encode · Feb 11, 2022 · 38185f3 · 38185f3
1 parent e7c1858
commit 38185f3
Show file tree

Hide file tree

Showing 3 changed files with 12 additions and 0 deletions.
diff --git a/docs/middleware.md b/docs/middleware.md
@@ -305,3 +305,7 @@ can be used to profile and monitor distributed applications.
 
 A middleware class to emit timing information (cpu and wall time) for each request which
 passes through it.  Includes examples for how to emit these timings as statsd metrics.
+
+#### [WSGIMiddleware](https://github.com/abersheeran/a2wsgi)
+
+A middleware class in charge of converting a WSGI application into an ASGI one.
diff --git a/setup.cfg b/setup.cfg
@@ -29,6 +29,7 @@ filterwarnings=
     ignore: The 'variables' alias has been deprecated. Please use 'variable_values' instead\.:DeprecationWarning
     # Workaround for Python 3.9.7 (see https://bugs.python.org/issue45097)
     ignore:The loop argument is deprecated since Python 3\.8, and scheduled for removal in Python 3\.10\.:DeprecationWarning:asyncio
+    ignore: starlette\.middleware\.wsgi is deprecated and will be removed in a future release\.*:DeprecationWarning
 
 [coverage:run]
 source_pkgs = starlette, tests

diff --git a/starlette/middleware/wsgi.py b/starlette/middleware/wsgi.py
@@ -2,11 +2,18 @@
 import math
 import sys
 import typing
+import warnings
 
 import anyio
 
 from starlette.types import Receive, Scope, Send
 
+warnings.warn(
+    "starlette.middleware.wsgi is deprecated and will be removed in a future release. "
+    "Please refer to https://github.com/abersheeran/a2wsgi as a replacement.",
+    DeprecationWarning,
+)
+
 
 def build_environ(scope: Scope, body: bytes) -> dict:
     """