From 3761d06ed4c1d56f3b9bce4695870464c3ac6326 Mon Sep 17 00:00:00 2001 From: "Erlend E. Aasland" Date: Sun, 2 May 2021 16:37:33 +0200 Subject: [PATCH] bpo-43988: Document test.support.check_disallow_instantiation --- Doc/library/test.rst | 8 ++++++++ Lib/test/support/__init__.py | 4 ++-- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/Doc/library/test.rst b/Doc/library/test.rst index e4f779bd83eb87..eb4f04f96e4f18 100644 --- a/Doc/library/test.rst +++ b/Doc/library/test.rst @@ -928,8 +928,16 @@ The :mod:`test.support` module defines the following functions: .. versionadded:: 3.10 +.. function:: check_disallow_instantiation(test_case, tp, *args, **kwds) + + Assert that type *tp* cannot be instantiated using *args* and *kwds*. + + .. versionadded:: 3.11 + + The :mod:`test.support` module defines the following classes: + .. class:: SuppressCrashReport() A context manager used to try to prevent crash dialog popups on tests that diff --git a/Lib/test/support/__init__.py b/Lib/test/support/__init__.py index 42ca614dce1ad1..34a9459b518fab 100644 --- a/Lib/test/support/__init__.py +++ b/Lib/test/support/__init__.py @@ -1987,9 +1987,9 @@ def skip_if_broken_multiprocessing_synchronize(): def check_disallow_instantiation(testcase, tp, *args, **kwds): """ - Helper for testing types with the Py_TPFLAGS_DISALLOW_INSTANTIATION flag. + Check that given type cannot be instantiated using *args and **kwds. - See bpo-43916. + See bpo-43916: Add Py_TPFLAGS_DISALLOW_INSTANTIATION type flag. """ mod = tp.__module__ name = tp.__name__