FM / idle

/usr/lib64/python2.7/idlelib/idle_test

Name	Size	Mode	Actions
htest.py	13779	0644	edit dl rm
htest.pyc	12600	0644	edit dl rm
htest.pyo	12600	0644	edit dl rm
mock_idle.py	1597	0644	edit dl rm
mock_idle.pyc	2879	0644	edit dl rm
mock_idle.pyo	2879	0644	edit dl rm
mock_tk.py	11574	0644	edit dl rm
mock_tk.pyc	12362	0644	edit dl rm
mock_tk.pyo	12362	0644	edit dl rm
README.txt	5492	0644	edit dl rm
test_autocomplete.py	4922	0644	edit dl rm
test_autocomplete.pyc	5860	0644	edit dl rm
test_autocomplete.pyo	5860	0644	edit dl rm
test_autoexpand.py	4122	0644	edit dl rm
test_autoexpand.pyc	4806	0644	edit dl rm
test_autoexpand.pyo	4806	0644	edit dl rm
test_calltips.py	7140	0644	edit dl rm
test_calltips.pyc	12131	0644	edit dl rm
test_calltips.pyo	12131	0644	edit dl rm
test_configdialog.py	782	0644	edit dl rm
test_configdialog.pyc	1655	0644	edit dl rm
test_configdialog.pyo	1655	0644	edit dl rm
test_config_name.py	2472	0644	edit dl rm
test_config_name.pyc	4012	0644	edit dl rm
test_config_name.pyo	4012	0644	edit dl rm
test_delegator.py	1294	0644	edit dl rm
test_delegator.pyc	1319	0644	edit dl rm
test_delegator.pyo	1319	0644	edit dl rm
test_editmenu.py	3167	0644	edit dl rm
test_editmenu.pyc	4439	0644	edit dl rm
test_editmenu.pyo	4439	0644	edit dl rm
test_formatparagraph.py	14344	0644	edit dl rm
test_formatparagraph.pyc	14318	0644	edit dl rm
test_formatparagraph.pyo	14318	0644	edit dl rm
test_grep.py	2762	0644	edit dl rm
test_grep.pyc	3760	0644	edit dl rm
test_grep.pyo	3760	0644	edit dl rm
test_helpabout.py	1611	0644	edit dl rm
test_helpabout.pyc	2363	0644	edit dl rm
test_helpabout.pyo	2363	0644	edit dl rm
test_hyperparser.py	5684	0644	edit dl rm
test_hyperparser.pyc	6734	0644	edit dl rm
test_hyperparser.pyo	6734	0644	edit dl rm
test_idlehistory.py	5495	0644	edit dl rm
test_idlehistory.pyc	8142	0644	edit dl rm
test_idlehistory.pyo	8142	0644	edit dl rm
test_io.py	9505	0644	edit dl rm
test_io.pyc	11533	0644	edit dl rm
test_io.pyo	11533	0644	edit dl rm
test_parenmatch.py	3822	0644	edit dl rm
test_parenmatch.pyc	5456	0644	edit dl rm
test_parenmatch.pyo	5456	0644	edit dl rm
test_pathbrowser.py	940	0644	edit dl rm
test_pathbrowser.pyc	1485	0644	edit dl rm
test_pathbrowser.pyo	1485	0644	edit dl rm
test_rstrip.py	1613	0644	edit dl rm
test_rstrip.pyc	1773	0644	edit dl rm
test_rstrip.pyo	1773	0644	edit dl rm
test_searchdialogbase.py	5863	0644	edit dl rm
test_searchdialogbase.pyc	6827	0644	edit dl rm
test_searchdialogbase.pyo	6827	0644	edit dl rm
test_searchengine.py	11487	0644	edit dl rm
test_searchengine.pyc	12649	0644	edit dl rm
test_searchengine.pyo	12649	0644	edit dl rm
test_text.py	6744	0644	edit dl rm
test_text.pyc	8148	0644	edit dl rm
test_text.pyo	8148	0644	edit dl rm
test_textview.py	2802	0644	edit dl rm
test_textview.pyc	4531	0644	edit dl rm
test_textview.pyo	4531	0644	edit dl rm
test_warning.py	2757	0644	edit dl rm
test_warning.pyc	3286	0644	edit dl rm
test_warning.pyo	3286	0644	edit dl rm
test_widgetredir.py	4177	0644	edit dl rm
test_widgetredir.pyc	6384	0644	edit dl rm
test_widgetredir.pyo	6384	0644	edit dl rm
__init__.py	650	0644	edit dl rm
__init__.pyc	915	0644	edit dl rm
__init__.pyo	915	0644	edit dl rm

Edit: /usr/lib64/python2.7/idlelib/idle_test/README.txt (5492B)

README FOR IDLE TESTS IN IDLELIB.IDLE_TEST

0. Quick Start

Automated unit tests were added in 2.7 for Python 2.x and 3.3 for Python 3.x.
To run the tests from a command line:

python -m test.test_idle

Human-mediated tests were added later in 2.7 and in 3.4.

python -m idlelib.idle_test.htest

1. Test Files

The idle directory, idlelib, has over 60 xyz.py files. The idle_test
subdirectory should contain a test_xyz.py for each, where 'xyz' is lowercased
even if xyz.py is not. Here is a possible template, with the blanks after
'.' and 'as', and before and after '_' to be filled in.

import unittest
from test.support import requires
import idlelib. as

class _Test(unittest.TestCase):

def test_(self):

if __name__ == '__main__':
    unittest.main(verbosity=2)

Add the following at the end of xyy.py, with the appropriate name added after
'test_'. Some files already have something like this for htest.  If so, insert
the import and unittest.main lines before the htest lines.

if __name__ == "__main__":
    import unittest
    unittest.main('idlelib.idle_test.test_', verbosity=2, exit=False)

2. GUI Tests

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
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
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
deleted BEFORE root is destroyed.  See https://bugs.python.org/issue20567.

@classmethod
    def setUpClass(cls):
        requires('gui')
        cls.root = tk.Tk()
        cls.text = tk.Text(root)

@classmethod
    def tearDownClass(cls):
        del cls.text
        cls.root.destroy()
        del cls.root

WARNING: In 2.7, "requires('gui') MUST NOT be called at module scope.
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 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
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.

3. Running Unit Tests

Assume that xyz.py and test_xyz.py both end with a unittest.main() call.
Running either from an Idle editor runs all tests in the test_xyz file with the
version of Python running Idle.  Test output appears in the Shell window.  The
'verbosity=2' option lists all test methods in the file, which is appropriate
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
Idle and so cannot run tests.)

python -m idlelib.xyz
python -m idlelib.idle_test.test_xyz

The following runs all idle_test/test_*.py tests interactively.

>>> import unittest
>>> unittest.main('idlelib.idle_test', verbosity=2)

The following run all Idle tests at a command line.  Option '-v' is the same as
'verbosity=2'.  (For 2.7, replace 'test' in the second line with
'test.regrtest'.)

python -m unittest -v idlelib.idle_test
python -m test -v -ugui test_idle
python -m test.test_idle

The idle tests are 'discovered' by idlelib.idle_test.__init__.load_tests,
which is also imported into test.test_idle. Normally, neither file should be
changed when working on individual test modules. The third command runs
unittest indirectly through regrtest. The same happens when the entire test
suite is run with 'python -m test'. So that command must work for buildbots
to stay 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.

python -m unittest -v idlelib.idle_test.test_xyz.Test_case.test_meth

4. Human-mediated Tests

Human-mediated tests are widget tests that cannot be automated but need human
verification. They are contained in idlelib/idle_test/htest.py, which has
instructions.  (Some modules need an auxiliary function, identified with # htest
# on the header line.)  The set is about complete, though some tests need
improvement. To run all htests, run the htest file from an editor or from the
command line with:

python -m idlelib.idle_test.htest

cmd: