u-boot.git/doc/develop/tests_sandbox.rst, branch next

global: Use CONFIG_XPL_BUILD instead of CONFIG_SPL_BUILD

2024-10-11T17:44:48+00:00

Complete this rename for all directories outside arch/ board/ drivers/
and include/

Use the new symbol to refer to any 'SPL' build, including TPL and VPL

Signed-off-by: Simon Glass

Fix references to trace doc

2024-04-13T09:14:29+00:00

The README.trace has been moved and converted to rst in commit dce26c7d56ed
("doc: move README.trace to HTML documentation"); fix all the remaining
references to this file.

Signed-off-by: Vincent Stehlé 
Cc: Tom Rini 
Cc: Simon Glass 
Cc: Heinrich Schuchardt 
Reviewed-by: Heinrich Schuchardt

test: Add a way to detect a test that breaks another

2022-11-07T23:24:30+00:00

When running unit tests, some may have side effects which cause a
subsequent test to break. This can sometimes be seen when using 'ut dm'
or similar.

Add a new argument which allows a particular (failing) test to be run
immediately after a certain number of tests have run. This allows the
test causing the failure to be determined.

Update the documentation also.

Signed-off-by: Simon Glass

test: Allow running tests multiple times

2022-09-02T20:21:44+00:00

Some tests can have race conditions which are hard to detect on a single
one. Add a way to run tests more than once, to help with this.

Each individual test is run the requested number of times before moving
to the next test. If any runs failed, a message is shown.

This is most useful when running a single test, since running all tests
multiple times can take a while.

Signed-off-by: Simon Glass

doc: Correct position of gdb '--args' parameter

2022-04-29T15:11:36+00:00

The '--args' parameter to gdb comes before the binary that the debugger
will be attached to rather than after the binary and before the
arguments. Fix that in the docs.

Signed-off-by: Andrew Scull 
Cc: Simon Glass 
Reviewed-by: Simon Glass

doc: Explain briefly how to write new tests

2021-03-12T14:57:31+00:00

Add a second on writing tests, covering when to use Python and C, where
to put the tests, etc. Add a link to the existing Python test
documentation.

Signed-off-by: Simon Glass

test: sandbox: Move sandbox test docs into doc/develop

2021-03-12T14:57:31+00:00

At present some of the documentation about running sandbox tests is in the
sandbox docs. It makes more sense to put it in with the other testing
docs, with a link there from sandbox. Update the documentation
accordingly.

Also add a paragraph explaining why sandbox exists and the test philosophy
that it uses.

Signed-off-by: Simon Glass

doc: Document how sandbox_spl_tests are run

2021-03-12T14:57:29+00:00

Add a few notes about the sandbox_spl tests, since they are special.

Signed-off-by: Simon Glass 
Acked-by: Pratyush Yadav

doc: Explain how to run tests without pytest

2021-03-12T14:57:29+00:00

Add details about how to run a sandbox test directly, without using
pytest. This is more convenient for rapid development, since it is faster
and allows easier use of a debugger. Also mention sandbox_flattree as an
example of the different sandbox builds available.

Signed-off-by: Simon Glass