floraachy
/
pytest2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[7.2.x] DOCS-#10687: Add a note about -W vs filterwarnings.

This commit is contained in:
Mahesh Vashishtha 2023-02-07 16:27:34 -06:00 committed by pytest bot
parent d61f83c030
commit 7e1549dfb6
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/en/how-to/capture-warnings.rst
View File

@ -109,6 +109,18 @@ When a warning matches more than one option in the list, the action for the last
is performed. is performed.
.. note::
The ``-W`` flag and the ``filterwarnings`` ini option use warning filters that are
similar in structure, but each configuration option interprets its filter
differently. For example, *message* in ``filterwarnings`` is a string containing a
regular expression that the start of the warning message must match,
case-insensitively, while *message* in ``-W`` is a literal string that the start of
the warning message must contain (case-insensitively), ignoring any whitespace at
the start or end of message. Consult the `warning filter`_ documentation for more
details.
.. _`filterwarnings`: .. _`filterwarnings`:
``@pytest.mark.filterwarnings`` ``@pytest.mark.filterwarnings``