https://github.com/python/cpython/commit/847474ce5d7087bb5678085893af41c7da386f1c
commit: 847474ce5d7087bb5678085893af41c7da386f1c
branch: 3.14
author: Miss Islington (bot) <[email protected]>
committer: hugovk <[email protected]>
date: 2025-10-07T00:30:00+03:00
summary:

[3.14] Add warnings filter suggestions to PEP 765 entry in What's New 
(GH-139658) (#139676)

Co-authored-by: Alyssa Coghlan <[email protected]>
Co-authored-by: Irit Katriel <[email protected]>
Co-authored-by: Adam Turner <[email protected]>

files:
M Doc/whatsnew/3.14.rst

diff --git a/Doc/whatsnew/3.14.rst b/Doc/whatsnew/3.14.rst
index 9b7be2847ab6dd..00314cd49a668c 100644
--- a/Doc/whatsnew/3.14.rst
+++ b/Doc/whatsnew/3.14.rst
@@ -937,6 +937,19 @@ The compiler now emits a :exc:`SyntaxWarning` when a 
:keyword:`return`,
 leaving a :keyword:`finally` block.
 This change is specified in :pep:`765`.
 
+In situations where this change is inconvenient (such as those where the
+warnings are redundant due to code linting), the :ref:`warning filter
+<warning-filter>` can be used to turn off all syntax warnings by adding
+``ignore::SyntaxWarning`` as a filter. This can be specified in combination
+with a filter that converts other warnings to errors (for example, passing
+``-Werror -Wignore::SyntaxWarning`` as CLI options, or setting
+``PYTHONWARNINGS=error,ignore::SyntaxWarning``).
+
+Note that applying such a filter at runtime using the :mod:`warnings` module
+will only suppress the warning in code that is compiled *after* the filter is
+adjusted. Code that is compiled prior to the filter adjustment (for example,
+when a module is imported) will still emit the syntax warning.
+
 (Contributed by Irit Katriel in :gh:`130080`.)
 
 

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to