mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

Advertise “python -m test” over test.regrtest (r87296 followup)

Browse source
This commit is contained in:
Éric Araujo 2010-12-16 01:40:26 +00:00
parent 7f64c8a512
commit 1d55c7ea9b
1 changed files with 13 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

23
Doc/library/test.rst
View file

@ -154,28 +154,31 @@ guidelines to be followed:
.. _regrtest: .. _regrtest:
Running tests using :mod:`test.regrtest` Running tests using the command-line interface
---------------------------------------- ----------------------------------------------
:mod:`test.regrtest` can be used as a script to drive Python's regression test The :mod:`test` package can be run as a script to drive Python's regression
suite. Running the script by itself automatically starts running all regression test suite, thanks to the :option:`-m` option: :program:`python -m test`. Under
the hood, it uses :mod:`test.regrtest`; the call :program:`python -m
test.regrtest` used in previous Python versions still works).
Running the script by itself automatically starts running all regression
tests in the :mod:`test` package. It does this by finding all modules in the tests in the :mod:`test` package. It does this by finding all modules in the
package whose name starts with ``test_``, importing them, and executing the package whose name starts with ``test_``, importing them, and executing the
function :func:`test_main` if present. The names of tests to execute may also function :func:`test_main` if present. The names of tests to execute may also
be passed to the script. Specifying a single regression test (:program:`python be passed to the script. Specifying a single regression test (:program:`python
regrtest.py test_spam.py`) will minimize output and only print -m test test_spam`) will minimize output and only print
whether the test passed or failed and thus minimize output. whether the test passed or failed and thus minimize output.
Running :mod:`test.regrtest` directly allows what resources are available for Running :mod:`test` directly allows what resources are available for
tests to use to be set. You do this by using the ``-u`` command-line tests to use to be set. You do this by using the ``-u`` command-line
option. Run :program:`python -m regrtest -uall` to turn on all option. Run :program:`python -m test -uall` to turn on all
resources; specifying ``all`` as an option for ``-u`` enables all resources; specifying ``all`` as an option for ``-u`` enables all
possible resources. If all but one resource is desired (a more common case), a possible resources. If all but one resource is desired (a more common case), a
comma-separated list of resources that are not desired may be listed after comma-separated list of resources that are not desired may be listed after
``all``. The command :program:`python -m regrtest -uall,-audio,-largefile` ``all``. The command :program:`python -m test -uall,-audio,-largefile`
will run :mod:`test.regrtest` with all resources except the ``audio`` and will run :mod:`test` with all resources except the ``audio`` and
``largefile`` resources. For a list of all resources and more command-line ``largefile`` resources. For a list of all resources and more command-line
options, run :program:`python -m regrtest -h`. options, run :program:`python -m test -h`.
Some other ways to execute the regression tests depend on what platform the Some other ways to execute the regression tests depend on what platform the
tests are being executed on. On Unix, you can run :program:`make test` at the tests are being executed on. On Unix, you can run :program:`make test` at the