zephyr/scripts/tests/twister
Dmitrii Golovanov a72244f2d0 twister: ztest: harness: Fix missed TestCase statuses
Fix a problem of Ztest suite names not taken into account by Twister
to identify a TestCase, so in some situations a Ztest test's status
was not assigned to the proper TestCase and it remains 'None'
whereas the actual status value lost, eventually the resulting total
execution counters not correct.

The issue was observed in these situations:
 * Ztest application with multiple test suites having same test names.
 * Ztest suite is 'skipped' entirely on execution with all its tests.

The proposed solution extends Twister test case name for Ztest to
include Ztest suite name, so the resulting identifier looks like:
   `<test_scenario_name>.<ztest_suite_name>.<ztest_name>`

The above naming scheme now requires ztest_suite_name part to be
provided for `--sub-test` command line option.

Testcase identifiers in twister.json and testplan.json will also
include ztest_suite_name component.

The Twister Ztest(Test) Harness is improved to track all state changes
known from the test application's log for Ztest suites and test cases,
so now it parses log output from a Ztest application more scurpulously.
Regular expressions to match log records are extended and optimized
to compile them only once and, in some cases, fixed (suite summary).

Signed-off-by: Dmitrii Golovanov <dmitrii.golovanov@intel.com>
2024-11-22 08:26:59 -05:00
..
pytest_integration twister: pytest: Change the order or pytest-args 2024-08-23 15:50:19 +01:00
test_data python: Format trivial files where only newlines were missing 2024-11-21 20:10:51 +01:00
conftest.py
README.md
test_cmakecache.py
test_config_parser.py scripts: twister: check for deprecation notice for space-separated lists 2024-09-12 10:03:44 +02:00
test_environment.py scripts: Fix CMake spelling 2024-10-30 16:32:24 -05:00
test_errors.py scripts: twister: Elevate Status Error 2024-09-09 09:28:37 +02:00
test_handlers.py twister: Allow sharing hardware platform between variants 2024-11-21 14:48:03 +01:00
test_hardwaremap.py twister: hwmap: add script parameter support 2024-09-16 10:03:53 +02:00
test_harness.py twister: ztest: harness: Fix missed TestCase statuses 2024-11-22 08:26:59 -05:00
test_jobserver.py scripts: twister: Fix Unit Tests on Windows systems 2024-05-15 17:08:06 +02:00
test_log_helper.py scripts: tests: twister: Add log_helper tests 2023-10-03 15:22:08 +01:00
test_mixins.py
test_platform.py twister: test udpates for new board handling 2024-10-22 18:31:09 -04:00
test_quarantine.py twister: Fix quarantine performance issue 2023-10-04 14:49:38 +01:00
test_runner.py twister: ztest: harness: Fix missed TestCase statuses 2024-11-22 08:26:59 -05:00
test_scl.py
test_testinstance.py twister: test udpates for new board handling 2024-10-22 18:31:09 -04:00
test_testplan.py twister: ztest: harness: Fix missed TestCase statuses 2024-11-22 08:26:59 -05:00
test_testsuite.py twister: ztest: harness: Fix missed TestCase statuses 2024-11-22 08:26:59 -05:00
test_twister.py scripts: twister: Solve deprecation notice when running tests 2024-09-12 10:03:44 +02:00

Twister Testing

Running the tests require the environment variable ZEPHYR_BASE to be set.

Twister Testsuite are located in $ZEPHYR_BASE/scripts/tests directory with all the data files in $ZEPHYR_BASE/scripts/test_data directory.

Dependencies

Install all the dependencies using

pip install -r $ZEPHYR_BASE/scripts/requirements-build-test.txt

Executing testsuite

The testcases can be executed from the root directory using

pytest $ZEPHYR_BASE/scripts/tests/twister

Twister Coverage

The coverage for all the tests can be run using the command below. This will collect all the tests available.

coverage run -m pytest $ZEPHYR_BASE/scripts/tests/twister/

Then we can generate the coverage report for just twister script using

coverage report -m $ZEPHYR_BASE/scripts/pylib/twister/

To generate the coverage report for twister script use below command

coverage report -m $ZEPHYR_BASE/scripts/twister

The html coverage report for twister can be generated using

coverage html twister

If needed,the full coverage html report can be generated in every run of "pytest" in the tests directory using configuration file (setup.cfg).

Organization of tests

  • conftest.py: Contains common fixtures for use in testing the twister tool.
  • test_twister.py : Contains basic testcases for environment variables, verifying testcase & platform schema's.
  • test_testsuite_class.py : Contains testcases for Testsuite class (except reporting functionality) in twisterlib.py.
  • test_testinstance.py : Contains testcases for Testinstance and Testcase class.
  • test_reporting_testsuite.py : Contains testcases for reporting functionality of Testsuite class of twister.