zephyr/scripts/tests/twister
Dmitrii Golovanov 47da4e2e76 twister: Improve recording at Harness
The Console Harness is able to parse its log with patterns to compose
extracted fields into records in 'recording.csv' file in the test's build
directory. This feature allows to extract custom test results like
performance counters.
With this change the extracted records are also written into 'twister.json'
as a part of each test suite object. This makes easier to store
all the data collected by the test for its further processing.

Other improvements:
 - compile parsing pattern only once instead of at each input line;
 - quote fields in '.csv' to avoid unexpected field separators;
 - make 'regex' a required schema field of 'harness_config';
 - Twister documentation update.

Signed-off-by: Dmitrii Golovanov <dmitrii.golovanov@intel.com>
2023-12-06 10:26:35 -05:00
..
pytest_integration scripts/pylib/twister/twisterlib: Support multiple --pytest-args 2023-11-30 10:03:01 +01:00
test_data tests: twister: Add tests for required_snippets functionality 2023-09-06 16:40:53 +02:00
conftest.py scripts: tests: Expand environment.py tests 2023-07-18 16:20:54 +02:00
README.md
test_cmakecache.py scripts: tests: twister: CMakeCache test expansion 2023-07-25 09:11:26 +02:00
test_environment.py twister: increase resilience when running outside of git. 2023-08-22 14:42:51 +02:00
test_errors.py scripts: tests: twister: Add error testing 2023-10-30 08:27:43 -04:00
test_handlers.py twister: Improve recording at Harness 2023-12-06 10:26:35 -05:00
test_hardwaremap.py scripts: tests: twister: Hardware map unit testing 2023-11-06 10:08:44 +01:00
test_harness.py twister: Improve recording at Harness 2023-12-06 10:26:35 -05:00
test_jobserver.py scripts: tests: twister: Jobserver tests 2023-10-30 08:28:02 -04:00
test_log_helper.py scripts: tests: twister: Add log_helper tests 2023-10-03 15:22:08 +01:00
test_mixins.py scripts: tests: twister: Mixin test 2023-09-06 09:40:38 -04:00
test_quarantine.py twister: Fix quarantine performance issue 2023-10-04 14:49:38 +01:00
test_runner.py twister: tests: adapt test for new option 2023-11-28 14:48:03 +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: unittests: Use mock for os.name in unittests 2023-10-30 11:50:48 -04:00
test_testplan_class.py tests: twister: Add tests for required_snippets functionality 2023-09-06 16:40:53 +02:00
test_testsuite.py twister: Add options deciding if paths be included in tests' names 2023-09-29 16:29:16 +02:00
test_twister.py scripts: Twister ConfigurationError Fix 2023-05-26 05:50:20 -04: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.