summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorVictor Stinner <vstinner@python.org>2023-09-26 15:22:50 (GMT)
committerGitHub <noreply@github.com>2023-09-26 15:22:50 (GMT)
commit859618c8cd5de86a975e68d7e5d20c04bc5db2e5 (patch)
treed46b75bdda563aead0bd9587387905b3dea37d59 /Doc
parent19bf3986958fc8269a1eb6d741bb60c91d6b5e58 (diff)
downloadcpython-859618c8cd5de86a975e68d7e5d20c04bc5db2e5.zip
cpython-859618c8cd5de86a975e68d7e5d20c04bc5db2e5.tar.gz
cpython-859618c8cd5de86a975e68d7e5d20c04bc5db2e5.tar.bz2
gh-109566, regrtest: Add --fast-ci and --slow-ci options (#109570)
* Add --fast-ci and --slow-ci options to libregrtest: * --fast-ci uses a default timeout of 10 minutes and "-u all,-cpu" (skip slowest tests). * --slow-ci uses a default timeout of 20 minues and "-u all" (run all tests). * regrtest header now lists test resources. * Makefile changes: * "make test", "make hostrunnertest" and "make coverage-report" now use --fast-ci option and TESTTIMEOUT variable. * "make buildbottest" now uses "--slow-ci". Remove options which became redundant with "--slow-ci". * "make testall" and "make testuniversal" now use --slow-ci option and TESTTIMEOUT variable. * "make testall" now uses "find -exec rm ..." instead of "find ... -print|xargs rm ...", same as "make clean". * GitHub Actions workflow: * Ubuntu and Address Sanitizer jobs now use "make test". Remove options which became redundant with "--fast-ci". * Windows jobs now use --fast-ci option. * Use -j0 to detect the number of CPUs. * Set Makefile TESTTIMEOUT default to an empty string, since --slow-ci and --fast-ci use different default timeout. It's now accepted to pass "--timeout=" to regrtest: treated as not timeout. * Tools/scripts/run_tests.py now uses --fast-ci option. * Tools/buildbot/test.bat now uses --slow-ci option. Remove --timeout=1200 option, redundant with --slow-ci.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/using/configure.rst15
1 files changed, 12 insertions, 3 deletions
diff --git a/Doc/using/configure.rst b/Doc/using/configure.rst
index 763f977..8207475 100644
--- a/Doc/using/configure.rst
+++ b/Doc/using/configure.rst
@@ -964,9 +964,18 @@ Main Makefile targets
You can use the configure :option:`--enable-optimizations` option to make
this the default target of the ``make`` command (``make all`` or just
``make``).
-* ``make buildbottest``: Build Python and run the Python test suite, the same
- way than buildbots test Python. Set ``TESTTIMEOUT`` variable (in seconds)
- to change the test timeout (1200 by default: 20 minutes).
+
+* ``make test``: Build Python and run the Python test suite with ``--slow-ci``
+ option. Variables:
+
+ * ``TESTOPTS``: additional regrtest command line options.
+ * ``TESTPYTHONOPTS``: additional Python command line options.
+ * ``TESTTIMEOUT``: timeout in seconds (default: 20 minutes).
+
+* ``make buildbottest``: Similar to ``make test``, but use ``--slow-ci``
+ option and default timeout of 20 minutes, instead of ``--fast-ci`` option
+ and a default timeout of 10 minutes.
+
* ``make install``: Build and install Python.
* ``make regen-all``: Regenerate (almost) all generated files;
``make regen-stdlib-module-names`` and ``autoconf`` must be run separately