https://github.com/python/cpython/commit/2f7793196a8feac9d5ce96ae0a8df0723ef1b044 commit: 2f7793196a8feac9d5ce96ae0a8df0723ef1b044 branch: 3.13 author: Miss Islington (bot) <[email protected]> committer: ncoghlan <[email protected]> date: 2024-11-02T11:43:30Z summary:
[3.13] gh-125761: Clarify repeated warning suppression criteria in warnings module (gh-126330) (cherry picked from commit 10eeec2d4ffb6b09a6d925877b6d9ef6aa6bb59d) Co-authored-by: 고병찬 <[email protected]> files: M Doc/library/warnings.rst diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst index e4942fa0c184bc..40b96080a3c990 100644 --- a/Doc/library/warnings.rst +++ b/Doc/library/warnings.rst @@ -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 _______________________________________________ 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]
