summaryrefslogtreecommitdiffstats
path: root/Lib/idlelib
diff options
context:
space:
mode:
authorTerry Jan Reedy <tjreedy@udel.edu>2016-06-04 06:32:09 (GMT)
committerTerry Jan Reedy <tjreedy@udel.edu>2016-06-04 06:32:09 (GMT)
commit0ba3c803ea2881a4b518019a913f9ad0f7cdd1a1 (patch)
treea1a81c22a27d1fd510df35b837247ad14b30278c /Lib/idlelib
parentb5f487a0902c82a914cd2398ffd1b5e57715431a (diff)
downloadcpython-0ba3c803ea2881a4b518019a913f9ad0f7cdd1a1.zip
cpython-0ba3c803ea2881a4b518019a913f9ad0f7cdd1a1.tar.gz
cpython-0ba3c803ea2881a4b518019a913f9ad0f7cdd1a1.tar.bz2
IDLE test README: 'gui' to 'GUI', except in "'gui'" and '-ugui'.
Diffstat (limited to 'Lib/idlelib')
-rw-r--r--Lib/idlelib/idle_test/README.txt26
1 files changed, 13 insertions, 13 deletions
diff --git a/Lib/idlelib/idle_test/README.txt b/Lib/idlelib/idle_test/README.txt
index 53c37b8..6967d70 100644
--- a/Lib/idlelib/idle_test/README.txt
+++ b/Lib/idlelib/idle_test/README.txt
@@ -42,15 +42,15 @@ if __name__ == "__main__":
2. GUI Tests
-When run as part of the Python test suite, Idle gui tests need to run
-test.support.requires('gui') (test.test_support in 2.7). A test is a gui test
+When run as part of the Python test suite, Idle GUI tests need to run
+test.test_support.requires('gui') (test.support in 3.x). A test is a GUI test
if it creates a Tk root or master object either directly or indirectly by
instantiating a tkinter or idle class. For the benefit of test processes that
-either have no graphical environment available or are not allowed to use it, gui
+either have no graphical environment available or are not allowed to use it, GUI
tests must be 'guarded' by "requires('gui')" in a setUp function or method.
This will typically be setUpClass.
-To avoid interfering with other gui tests, all gui objects must be destroyed and
+To avoid interfering with other GUI tests, all GUI objects must be destroyed and
deleted by the end of the test. The Tk root created in a setUpX function should
be destroyed in the corresponding tearDownX and the module or class attribute
deleted. Others widgets should descend from the single root and the attributes
@@ -73,24 +73,24 @@ See https://bugs.python.org/issue18910
Requires('gui') causes the test(s) it guards to be skipped if any of
these conditions are met:
-
+
- The tests are being run by regrtest.py, and it was started without enabling
the "gui" resource with the "-u" command line option.
-
+
- The tests are being run on Windows by a service that is not allowed to
interact with the graphical environment.
- - The tests are being run on Linux and X window is not available.
-
+ - The tests are being run on Linux and X Windows is not available.
+
- The tests are being run on Mac OSX in a process that cannot make a window
manager connection.
-
+
- tkinter.Tk cannot be successfully instantiated for some reason.
-
+
- test.support.use_resources has been set by something other than
regrtest.py and does not contain "gui".
-
-Tests of non-gui operations should avoid creating tk widgets. Incidental uses of
+
+Tests of non-GUI operations should avoid creating tk widgets. Incidental uses of
tk variables and messageboxes can be replaced by the mock classes in
idle_test/mock_tk.py. The mock text handles some uses of the tk Text widget.
@@ -105,7 +105,7 @@ when developing tests. The 'exit=False' option is needed in xyx.py files when an
htest follows.
The following command lines also run all test methods, including
-gui tests, in test_xyz.py. (Both '-m idlelib' and '-m idlelib.idle' start
+GUI tests, in test_xyz.py. (Both '-m idlelib' and '-m idlelib.idle' start
Idle and so cannot run tests.)
python -m idlelib.xyz