change to DeprecationWarning (#497)

davidism · web-flow · commit dec39fef9239 · 2025-05-28T19:43:56.000-07:00
diff --git a/CHANGES.rst b/CHANGES.rst
@@ -3,6 +3,9 @@ Version 3.0.3
 
 Unreleased
 
+-   ``__version__`` raises ``DeprecationWarning`` instead of ``UserWarning``.
+    :issue:`487`
+
 
 Version 3.0.2
 -------------
diff --git a/src/markupsafe/__init__.py b/src/markupsafe/__init__.py
@@ -388,6 +388,7 @@ def __getattr__(name: str) -> t.Any:
             "The '__version__' attribute is deprecated and will be removed in"
             " MarkupSafe 3.1. Use feature detection, or"
             ' `importlib.metadata.version("markupsafe")`, instead.',
+            DeprecationWarning,
             stacklevel=2,
         )
         return importlib.metadata.version("markupsafe")

Original file line number	Diff line number	Diff line change
`@@ -388,6 +388,7 @@ def __getattr__(name: str) -> t.Any:`
`388`	`388`	`"The '__version__' attribute is deprecated and will be removed in"`
`389`	`389`	`" MarkupSafe 3.1. Use feature detection, or"`
`390`	`390`	' `importlib.metadata.version("markupsafe")`, instead.',
	`391`	`+ DeprecationWarning,`
`391`	`392`	`stacklevel=2,`
`392`	`393`	`)`
`393`	`394`	`return importlib.metadata.version("markupsafe")`