From 0fee56c86344386bde8486ab803f564cb8a5203b Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Sat, 14 Oct 2017 23:16:57 -0400 Subject: [PATCH] [3.6] bpo-25588: Document autotest in idle_test/README.txt. (GH-4000) (#4001) Follow-up to Victor's patch that enabled autotest to run in IDLE's Shell. (cherry picked from commit 620f70e) --- Lib/idlelib/idle_test/README.txt | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/Lib/idlelib/idle_test/README.txt b/Lib/idlelib/idle_test/README.txt index c580fb9e79352a..5f3678fc7e1de3 100644 --- a/Lib/idlelib/idle_test/README.txt +++ b/Lib/idlelib/idle_test/README.txt @@ -144,9 +144,18 @@ green. Idle tests must not disturb the environment in a way that makes other tests fail (issue 18081). To run an individual Testcase or test method, extend the dotted name -given to unittest on the command line. +given to unittest on the command line or use the test -m option. The +latter allows use of other regrtest options. When using the latter, +all components of the pattern must be present, but any can be replaced +by '*'. python -m unittest -v idlelib.idle_test.test_xyz.Test_case.test_meth +python -m test -m idlelib.idle_test.text_xyz.Test_case.test_meth test_idle + +The test suite can be run in an IDLE user process from Shell. +>>> import test.autotest # Issue 25588, 2017/10/13, 3.6.4, 3.7.0a2. +There are currently failures not usually present, and this does not +work when run from the editor. 4. Human-mediated Tests