./run_tests.py automatically add tmuxp.testsuite to testmodule names

Author: tony

CHANGES

@@ -11,6 +11,8 @@ Here you can find the recent changes to tmuxp.
 - [internal] `pep257`_ fixes.
 - [internal] [tests] - :class:`Pane` now has :meth:`Pane.set_width` and
   :meth:`Pane.set_height`.
+- [tests] ``./run_tests.py --tests`` now automatically prepends
+  ``tmuxp.testsuite`` to names.
 
 2013-10-27
 ----------

doc/developing.rst

@@ -74,7 +74,22 @@ If you found a problem or are trying to write a test, you can file an
 Choose tests to run
 """""""""""""""""""
 
-Testing specific testsuites, testcase and tests
+.. note::
+
+    As of v0.0.20, ``--tests`` automatically assume the namespace of
+    ``tmuxp.testsuite``.
+
+    .. code-block:: bash
+
+        $ ./run_tests.py --tests test_config.ImportExportTest
+
+    Is now equivalent to:
+
+    .. code-block:: bash
+
+        $ ./run_tests.py --tests tmuxp.testsuite.test_config.ImportExportTest
+
+Testing specific TestSuites, TestCase and tests
 
 .. code-block:: bash
 
@@ -87,26 +102,26 @@ By :py:class:`unittest.TestSuite` / module:
 
 .. code-block:: bash
 
-    $ ./run_tests.py tmuxp.testsuite.test_config
+    $ ./run_tests.py test_config
 
 by :py:class:`unittest.TestCase`:
 
 .. code-block:: bash
 
-    $ ./run_tests.py --tests tmuxp.testsuite.test_config.ImportExportTest
+    $ ./run_tests.py --tests test_config.ImportExportTest
 
 individual tests:
 
 .. code-block:: bash
 
-    $ ./run_tests.py --tests tmuxp.testsuite.test_config.ImportExportTest.test_export_json
+    $ ./run_tests.py --tests test_config.ImportExportTest.test_export_json
 
 Multiple can be separated by spaces:
 
 .. code-block:: bash
 
-    $ ./run_tests.py --tests tmuxp.testsuite.test_config.ImportExportTest.test_export_json \
-        testsuite.test_config.ImportExportTest.test_window
+    $ ./run_tests.py --tests ImportExportTest.test_export_json \
+        ImportExportTest.test_window
 
 .. _test_builder_visually:
 
@@ -237,9 +252,9 @@ In this, I will also begin documenting the API.
 the use of:
 
 Session
-Session.new_window() - returns a new Window object bound to the session,
+:meth:`Session.new_window()` - returns a new Window object bound to the session,
 also uses ``tmux new-window``.
-Session.new_session() - class method - returns a new Session object.
+:meth:`Session.new_session()` - class method - returns a new Session object.
 
 Differences from tmux
 ---------------------

run_tests.py

@@ -131,16 +131,24 @@ def output(line):
         Test individual, TestCase or TestSuites, or multiple. Example for test_config TestSuite:
 
         by TestSuite (module):
-            $ ./run_tests.py tmuxp.testsuite.test_config
+            $ ./run_tests.py test_config
 
         by TestCase:
-            $ ./run_tests.py tmuxp.testsuite.test_config.ImportExportTest
+            $ ./run_tests.py test_config.ImportExportTest
         individual tests:
-            $ ./run_tests.py tmuxp.testsuite.test_config.ImportExportTest.test_export_json
+            $ ./run_tests.py test_config.ImportExportTest.test_export_json
 
         Multiple can be separated by spaces:
-            $ ./run_tests.py tmuxp.testsuite.test_config.ImportExportTest.test_export_json \\
-                testsuite.test_config.ImportExportTest.test_window
+            $ ./run_tests.py test_config.ImportExportTest.test_export_json \\
+                test_config.ImportExportTest.test_window
+
+        ./run_tests will automatically assume the package namespace ``tmuxp.testsuite``.
+
+            $ ./run_tests.py test_config.ImportExportTest
+
+        is the same as:
+
+            $ ./run_tests.py tmuxp.testsuite.test_config.ImportExportTest
         '''
     )
     parser.add_argument('-l', '--log-level', dest='log_level', default='INFO',
@@ -171,6 +179,10 @@ def output(line):
         else:
             sys.exit(1)
     if args.tests and len(args.tests) > int(0):
+        for arg in args.tests:
+            if not arg.startswith('tmuxp.testsuite'):
+                loc = args.tests.index(arg)
+                args.tests[loc] = 'tmuxp.testsuite.%s' % arg
         suites = unittest.TestLoader().loadTestsFromNames(args.tests)
         result = unittest.TextTestRunner(verbosity=verbosity, failfast=args.failfast).run(suites)
     else: