zephyr/scripts/tests/twister
Dmitrii Golovanov b4d22420e9 twister: harness: recording: Allow multiple patterns
Extend Twister Harness 'recording' feature to allow multiple
regular expression patterns to extract different types of records
from test output.

Add 'merge' recording mode to collect all extracted data fields
into a single record object of the test instance.

Export to CSV file now takes all field names occurred in the collected
records, sort it alphabetically, and then use it for columns instead of
using only the first record's fields. This is done to address possible
situation when records have different set of fields.

Adjust Twister documentation and test suite to the above changes.

Signed-off-by: Dmitrii Golovanov <dmitrii.golovanov@intel.com>
2025-01-16 22:38:51 +01:00
..
pytest_integration twister: support testing multiple toolchain variants 2025-01-08 12:58:59 +01:00
test_data python: Format trivial files where only newlines were missing 2024-11-21 20:10:51 +01:00
conftest.py twister: support testing multiple toolchain variants 2025-01-08 12:58:59 +01:00
README.md
test_cmakecache.py scripts: tests: twister: CMakeCache test expansion 2023-07-25 09:11:26 +02:00
test_config_parser.py scripts: twister: drop support for space-separated lists 2024-12-04 14:14:53 -05:00
test_environment.py scripts: Fix CMake spelling 2024-10-30 16:32:24 -05:00
test_errors.py twister: test: update test case 2024-12-04 02:03:33 +01:00
test_handlers.py twister: handlers: Pass harness reason to instance 2024-12-17 11:37:40 +00:00
test_hardwaremap.py scripts: Fix twisterlib for ruff - UP015 2024-11-29 15:29:31 +01:00
test_harness.py twister: harness: recording: Allow multiple patterns 2025-01-16 22:38:51 +01: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 python: Format and sort imports 2024-11-25 10:07:13 +01:00
test_platform.py scripts: twisterlib: Enable multiple simulator support in twister 2024-11-25 08:31:28 +01:00
test_quarantine.py scripts: twisterlib: Enable multiple simulator support in twister 2024-11-25 08:31:28 +01:00
test_runner.py twister: support testing multiple toolchain variants 2025-01-08 12:58:59 +01:00
test_scl.py twister: fix utf-8 encoding for device handler 2023-09-19 15:23:52 +01:00
test_testinstance.py twister: support testing multiple toolchain variants 2025-01-08 12:58:59 +01:00
test_testplan.py twister: support testing multiple toolchain variants 2025-01-08 12:58:59 +01:00
test_testsuite.py twister: test: update test case 2024-12-04 02:03:33 +01:00
test_twister.py scripts: Fix twisterlib for ruff - B028 2024-11-29 15:29:31 +01: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.