diff options
| author | Simon Glass <sjg@chromium.org> | 2021-09-19 15:14:51 -0600 |
|---|---|---|
| committer | Tom Rini <trini@konsulko.com> | 2021-10-05 08:50:15 -0400 |
| commit | 5f8cefb7b1f3c1ba3d3f698345bf173038da2b0c (patch) | |
| tree | fafc547a63660da2fff18b51028da0bd808a6b0b /doc/develop | |
| parent | 17d1fe1c4483d57edd3de5647973168713129374 (diff) | |
doc: test: Explain how to run pytests in parallel
Add documentation for this so people can try it out. At present it does
not fully work.
Signed-off-by: Simon Glass <sjg@chromium.org>
Diffstat (limited to 'doc/develop')
| -rw-r--r-- | doc/develop/py_testing.rst | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/doc/develop/py_testing.rst b/doc/develop/py_testing.rst index c4cecc0a01..4f1e1f66e7 100644 --- a/doc/develop/py_testing.rst +++ b/doc/develop/py_testing.rst @@ -103,6 +103,36 @@ will be written to `${build_dir}/test-log.html`. This is best viewed in a web browser, but may be read directly as plain text, perhaps with the aid of the `html2text` utility. +Running tests in parallel +~~~~~~~~~~~~~~~~~~~~~~~~~ + +Note: This does not fully work yet and is documented only so you can try to +fix the problems. + +First install support for parallel tests:: + + pip3 install pytest-xdist + +Then build sandbox in a suitable build directory. It is not possible to use +the --build flag with xdist. + +Finally, run the tests in parallel using the -n flag:: + + # build sandbox first, in a suitable build directory. It is not possible + # to use the --build flag with -n + test/py/test.py -B sandbox --build-dir /tmp/b/sandbox -q -k 'not slow' -n32 + +At least the following non-slow tests are known to fail: + +- test_fit_ecdsa +- test_bind_unbind_with_uclass +- ut_dm_spi_flash +- test_gpt_rename_partition +- test_gpt_swap_partitions +- test_pinmux_status +- test_sqfs_load + + Testing under a debugger ~~~~~~~~~~~~~~~~~~~~~~~~ |