[issue42272] Warning filter message/module documentation is misleading

[Ananya Datta]

Ananya Datta  added the comment:

No comments

--
nosy: +ananyadatta88
Added file: https://bugs.python.org/file50238/D365 Finance cert learning 
path.pdf

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue42272] Warning filter message/module documentation is misleading

[Kevin Locke]

Change by Kevin Locke :


--
keywords: +patch
pull_requests: +22084
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/23172

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue42272] Warning filter message/module documentation is misleading

[Kevin Locke]

New submission from Kevin Locke :

"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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com