u-boot.git/include/test/ut.h, branch master

test: document ut.h

2025-11-21T18:25:56+00:00

Add missing Sphinx comments in include/test/ut.h

Reviewed-by: Simon Glass 
Signed-off-by: Heinrich Schuchardt

test: Move stat-printing into its own function

2025-01-24T20:34:41+00:00

Add a function to show the stats, so we can decide when to print it.

This slightly adjusts the output, so that any 'test not found' message
appears on its own line after all other output.

The 'failures' message now appears in lower case so update pytest
accordingly.

Signed-off-by: Simon Glass

test: Pass the test-state into ut_run_list()

2025-01-24T20:34:39+00:00

Pass this into the function so that callers can inspect the state
afterwards.

Signed-off-by: Simon Glass

test: Rename test_get_state() to ut_get_state()

2025-01-24T20:34:39+00:00

Rename this function and test_set_state() so use the same ut_ prefix as
other functions in ut.h

Signed-off-by: Simon Glass

test: Rename unit-test flags

2024-08-27T00:51:48+00:00

The UT_TESTF_ macros read as 'unit test test flags' which is not right.
Rename to UTF ('unit test flags').

This has the benefit of being shorter, which helps keep UNIT_TEST()
declarations on a single line.

Give the enum a name and reference it from the UNIT_TEST() macros while
we are here.

Signed-off-by: Simon Glass

test: Add helper to skip to partial console line

2023-12-13T23:39:05+00:00

Sometimes we need to skip to a line but it includes addresses or other
information which can vary depending on the runtime conditions.

Add a new ut_assert_skip_to_linen() which is similar to the existing
ut_assert_skip_to_line() function but only checks that the console line
matches up to the length of the provided string.

Signed-off-by: Simon Glass

test: Restore test behaviour on failure

2023-07-14T16:54:50+00:00

A recent change makes test continue to run after failure. This results in
a lot of useless output and may lead to a segfault. Fix this by adding
back the 'return' statement.

Fixes: fa847bb409d ("test: Wrap assert macros in ({ ... }) and fix")

Signed-off-by: Simon Glass

test: Wrap assert macros in ({ ... }) and fix missing semicolons

2023-03-14T22:08:51+00:00

Wrap the assert macros in ({ ... }) so they can be safely used both as
right side argument as well as in conditionals without curly brackets
around them. In the process, find a bunch of missing semicolons, fix
them.

Reviewed-by: Simon Glass 
Signed-off-by: Marek Vasut

test: Add ut_assert_nextline_empty() empty line helper

2023-03-08T19:40:57+00:00

Add helper macro to test for empty lines, which is an inobvious
wrapper around ut_assert_nextline("%s", "") .

Signed-off-by: Marek Vasut 
Reviewed-by: Simon Glass

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