Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

[3.13] gh-125761: Clarify repeated warning suppression criteria in warnings module (gh-126330) 

(cherry picked from commit 10eeec2d4f)

Co-authored-by: 고병찬 <70642609+byungchanKo99@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2024-11-02 12:43:30 +01:00 committed by GitHub
parent 79ec946c16
commit 2f7793196a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 13 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Doc/library/warnings.rst
View File

@ -178,6 +178,19 @@ If a warning is reported and doesn't match any registered filter then the
"default" action is applied (hence its name).
.. _repeated-warning-suppression-criteria:
Repeated Warning Suppression Criteria
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The filters that suppress repeated warnings apply the following criteria to determine if a warning is considered a repeat:
- ``"default"``: A warning is considered a repeat only if the (*message*, *category*, *module*, *lineno*) are all the same.
- ``"module"``: A warning is considered a repeat if the (*message*, *category*, *module*) are the same, ignoring the line number.
- ``"once"``: A warning is considered a repeat if the (*message*, *category*) are the same, ignoring the module and line number.
.. _describing-warning-filters:
Describing Warning Filters