New submission from Kevin Locke <ke...@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 <rep...@bugs.python.org>
<https://bugs.python.org/issue42272>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to