From: Brett Cannon Date: Thu, 8 May 2008 20:20:54 +0000 (+0000) Subject: Document the 'record' argument for test.test_support.catch_warning(). X-Git-Tag: v2.6b1~574 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=98b9c07ab76c7fa0b77c3cb683ab92c49ef3bbdc;p=python Document the 'record' argument for test.test_support.catch_warning(). --- diff --git a/Doc/library/test.rst b/Doc/library/test.rst index 69ead89428..818ff8e707 100644 --- a/Doc/library/test.rst +++ b/Doc/library/test.rst @@ -283,13 +283,15 @@ The :mod:`test.test_support` module defines the following functions: This will run all tests defined in the named module. -.. function:: catch_warning() +.. function:: catch_warning(record=True) - This is a context manager that guards the warnings filter from being + Return a context manager that guards the warnings filter from being permanently changed and records the data of the last warning that has been - issued. + issued. The ``record`` argument specifies whether any raised warnings are + captured by the object returned by :func:`warnings.catch_warning` or allowed + to propagate as normal. - Use like this:: + The context manager is typically used like this:: with catch_warning() as w: warnings.warn("foo")