[issue42272] Warning filter message/module documentation is misleading

New submission from Kevin Locke <kevin@kevinlocke.name>: "The Warnings Filter" section of the documentation for the warnings module describes the message and module filters as "a string containing a regular expression". While that is true when they are arguments to the filterwarnings function, it is not true when they appear in -W or $PYTHONWARNINGS where they are matched literally (after stripping any starting/ending whitespace). Additionally, in the "Describing Warning Filters" section, the example "error:::mymodule[.*]" does not behave as described. If it were used as an argument to filterwarnings, where it would be treated as a regular expression, it would match the (invalid) module names mymodule. or mymodule* while it would match mymodule[.*] literally if passed via -W or $PYTHONWARNINGS. ---------- assignee: docs@python components: Documentation messages: 380429 nosy: docs@python, kevinoid priority: normal severity: normal status: open title: Warning filter message/module documentation is misleading type: enhancement versions: Python 3.10 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue42272> _______________________________________

Change by Kevin Locke <kevin@kevinlocke.name>: ---------- keywords: +patch pull_requests: +22084 stage: -> patch review pull_request: https://github.com/python/cpython/pull/23172 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue42272> _______________________________________
participants (1)
-
Kevin Locke