From da04fe1d0076b159eb3e8979793d1a8f1d9db1a2 Mon Sep 17 00:00:00 2001 From: Dr Alex Mitre Date: Thu, 5 Mar 2026 13:34:42 -0600 Subject: [PATCH] Enhance capture-warnings documentation with filter examples Added information on passing multiple filters to pytest.mark.filterwarnings. --- doc/en/how-to/capture-warnings.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/en/how-to/capture-warnings.rst b/doc/en/how-to/capture-warnings.rst index 02da2dd7669..38e18b042d8 100644 --- a/doc/en/how-to/capture-warnings.rst +++ b/doc/en/how-to/capture-warnings.rst @@ -160,6 +160,15 @@ You can specify multiple filters with separate decorators: def test_one(): assert api_v1() == 1 +You can also pass multiple filters to a single mark by providing multiple arguments: + +.. code-block:: python + + # Later arguments take precedence, matching warnings.filterwarnings behavior. + @pytest.mark.filterwarnings("error", "ignore:api v1") + def test_one(): + assert api_v1() == 1 + .. important:: Regarding decorator order and filter precedence: