Add a note about -W vs filterwarnings. (#10713)

Closes #10687

Signed-off-by: mvashishtha <mahesh@ponder.io>
This commit is contained in:
Mahesh Vashishtha 2023-02-07 16:27:34 -06:00 committed by GitHub
parent a2b7db7655
commit af99040123
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 0 deletions

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``