[PATCH v4 00/42] test: Refactor tests to have a single test runner
Simon Glass
sjg at chromium.org
Thu Mar 4 14:50:36 CET 2021
At present U-Boot has two broad sets of tests in the C code: driver model
tests which do a lot of pre-/post-init and command tests which do not.
This separation makes it slightly harder to write a test, since there are
two different test-state structures and different rules for running the
two different test types. At present these rules are determined by where
the test is (actually its prefix).
All unit tests can be run from the command line with the 'ut' command.
Since SPL does not have commands, it currently calls the test runner
directly and offers no control of which tests are run.
This seems like a good time to refactor the tests into a unified test
runner, allowing U-Boot proper and SPL to use the same path, perhaps with
some different conditions along the way.
This series sets up a unified runner called ut_run_list(), which runs a
set of tests from a linker_list. Driver model tests are distinguished by
a new UT_TESTF_DM flag so that the necessary init and cleanup can still
be done.
The runner is modified to support running SPL tests that are not solely
for driver model. An example test for FIT loading is added as a
demonstration.
In addition, some documentation is added to explain how to write tests.
This series is available at u-boot-dm/test-working
Changes in v4:
- Fix 'of-pldata' typo
- Rebase on master
- Add correct SPDX header
Changes in v3:
- Add new patch to re-enable test_ofplatdata
- Reword the SPL tests section for clarity
- Use test_set_state() throughout test-main.c instead of direct assignment
- Update the pytest collector as well
Changes in v2:
- Use correct rst format for 'Ad-hoc tests' section
- Expand docs on how each type of test is marked
- Put the docs in tests_sandbox since it is more related to sandbox
- Put in a mention of tests_sandbox in the main testing docs
- Add a note that SPL tests can in fact be run individualy
- Document how to run all C tests with 'ut all'
- Fix 'get list' typo
- Fix conditions so non-DM SPL tests are actually run
- Allow for prefix to be NULL, to match function comment
- Add new patches to cover running an SPL test
Simon Glass (42):
dm: core: Fix allocation of empty of-platdata
doc: Tidy up testing section
doc: Document make tcheck
sandbox: Drop the 'starting...' message unless testing
test: Re-enable test_ofplatdata
doc: Explain how to run tests without pytest
doc: Document how sandbox_spl_tests are run
test: Correct setexpr test prefix
test: Mark all driver model tests with a flag
test: Rename test-main.c to test-dm.c
test: Add an overall test runner
test: Create pre/post-run functions
test: Call test_pre/post_run() from driver model tests
test: Move dm_extended_scan() to test_pre_run()
test: Move do_autoprobe() to test_pre_run()
test: Move dm_scan_plat() to test_pre_run()
test: Drop mallinfo() work-around
test: Move console silencing to test_pre_run()
test: Move delay skipping to test_pre_run()
test: Handle driver model reinit in test_pre_run()
test: Drop struct dm_test_state
test: Move dm_test_init() into test-main.c
test: Move dm_test_destroy() into test-main.c
test: Move test running into a separate function
test: Use ut_run_test() to run driver model tests
test: Drop dm_do_test()
test: Add ut_run_test_live_flat() to run tests twice
test: Use a local variable for test state
test: Run driver-model tests using ut_run_list()
test: Use return values in dm_test_run()
test: Move the devicetree check into ut_run_list()
test: Move restoring of driver model state to ut_run_list()
test: log: Rename log main test file to log_ut.c
test: Add a macros for finding tests in linker_lists
test: Rename all linker lists to have a ut_ prefix
test: Allow SPL to run any available test
sandbox: Update os_find_u_boot() to find the .img file
spl: Convert spl_fit to work with sandbox
doc: Move coccinelle into its own section
spl: test: Add a test for spl_load_simple_fit()
test: sandbox: Move sandbox test docs into doc/develop
doc: Explain briefly how to write new tests
arch/sandbox/cpu/os.c | 8 +-
arch/sandbox/cpu/spl.c | 9 +-
arch/sandbox/cpu/start.c | 15 +-
arch/sandbox/include/asm/state.h | 1 +
common/spl/spl.c | 3 +-
common/spl/spl_fit.c | 27 +-
configs/sandbox_spl_defconfig | 2 +-
doc/arch/sandbox.rst | 48 +---
doc/develop/index.rst | 11 +-
doc/develop/py_testing.rst | 3 +-
doc/develop/testing.rst | 46 +++-
doc/develop/tests_sandbox.rst | 208 ++++++++++++++
doc/develop/tests_writing.rst | 339 +++++++++++++++++++++++
drivers/core/device.c | 17 +-
include/dm/test.h | 20 +-
include/os.h | 3 +-
include/spl.h | 9 +
include/test/test.h | 38 ++-
include/test/ut.h | 45 +++
test/Makefile | 3 +
test/bloblist.c | 5 +-
test/bootm.c | 4 +-
test/cmd/mem.c | 4 +-
test/cmd/setexpr.c | 28 +-
test/cmd_ut.c | 38 +--
test/compression.c | 5 +-
test/dm/Makefile | 2 +-
test/dm/core.c | 58 ++--
test/dm/test-dm.c | 51 ++++
test/dm/test-driver.c | 12 +-
test/dm/test-main.c | 230 ----------------
test/dm/test-uclass.c | 10 +-
test/env/cmd_ut_env.c | 4 +-
test/image/Makefile | 5 +
test/image/spl_load.c | 91 ++++++
test/lib/cmd_ut_lib.c | 4 +-
test/log/Makefile | 2 +-
test/log/{test-main.c => log_ut.c} | 4 +-
test/optee/cmd_ut_optee.c | 5 +-
test/overlay/cmd_ut_overlay.c | 5 +-
test/py/conftest.py | 2 +-
test/py/tests/test_log.py | 2 +-
test/py/tests/test_ofplatdata.py | 2 +-
test/str_ut.c | 5 +-
test/test-main.c | 426 +++++++++++++++++++++++++++++
test/unicode_ut.c | 4 +-
test/ut.c | 7 +
47 files changed, 1422 insertions(+), 448 deletions(-)
create mode 100644 doc/develop/tests_sandbox.rst
create mode 100644 doc/develop/tests_writing.rst
create mode 100644 test/dm/test-dm.c
delete mode 100644 test/dm/test-main.c
create mode 100644 test/image/Makefile
create mode 100644 test/image/spl_load.c
rename test/log/{test-main.c => log_ut.c} (75%)
create mode 100644 test/test-main.c
--
2.30.1.766.gb4fecdf3b7-goog
More information about the U-Boot
mailing list