| #!/usr/bin/env python3 |
| # Copyright (c) 2020 Intel Corporation |
| # |
| # SPDX-License-Identifier: Apache-2.0 |
| |
| ''' |
| This test file contains testcases for Testsuite class of twister |
| ''' |
| import sys |
| import os |
| import csv |
| import pytest |
| from mock import call, patch, MagicMock |
| |
| ZEPHYR_BASE = os.getenv("ZEPHYR_BASE") |
| sys.path.insert(0, os.path.join(ZEPHYR_BASE, "scripts/pylib/twister")) |
| |
| from twisterlib import TestCase, TestSuite, TestInstance, Platform |
| |
| def test_testsuite_add_testcases(class_testsuite): |
| """ Testing add_testcase function of Testsuite class in twister """ |
| # Test 1: Check the list of testcases after calling add testcases function is as expected |
| class_testsuite.SAMPLE_FILENAME = 'test_sample_app.yaml' |
| class_testsuite.TESTCASE_FILENAME = 'test_data.yaml' |
| class_testsuite.add_testcases() |
| tests_rel_dir = 'scripts/tests/twister/test_data/testcases/tests/' |
| expected_testcases = ['test_b.check_1', |
| 'test_b.check_2', |
| 'test_c.check_1', |
| 'test_c.check_2', |
| 'test_a.check_1', |
| 'test_a.check_2', |
| 'sample_test.app'] |
| testcase_list = [] |
| for key in sorted(class_testsuite.testcases.keys()): |
| testcase_list.append(os.path.basename(os.path.normpath(key))) |
| assert sorted(testcase_list) == sorted(expected_testcases) |
| |
| # Test 2 : Assert Testcase name is expected & all testcases values are testcase class objects |
| testcase = class_testsuite.testcases.get(tests_rel_dir + 'test_a/test_a.check_1') |
| assert testcase.name == tests_rel_dir + 'test_a/test_a.check_1' |
| assert all(isinstance(n, TestCase) for n in class_testsuite.testcases.values()) |
| |
| @pytest.mark.parametrize("board_root_dir", [("board_config_file_not_exist"), ("board_config")]) |
| def test_add_configurations(test_data, class_testsuite, board_root_dir): |
| """ Testing add_configurations function of TestSuite class in Twister |
| Test : Asserting on default platforms list |
| """ |
| class_testsuite.board_roots = os.path.abspath(test_data + board_root_dir) |
| suite = TestSuite(class_testsuite.board_roots, class_testsuite.roots, class_testsuite.outdir) |
| if board_root_dir == "board_config": |
| suite.add_configurations() |
| assert sorted(suite.default_platforms) == sorted(['demo_board_1', 'demo_board_3']) |
| elif board_root_dir == "board_config_file_not_exist": |
| suite.add_configurations() |
| assert sorted(suite.default_platforms) != sorted(['demo_board_1']) |
| |
| def test_get_all_testcases(class_testsuite, all_testcases_dict): |
| """ Testing get_all_testcases function of TestSuite class in Twister """ |
| class_testsuite.testcases = all_testcases_dict |
| expected_tests = ['sample_test.app', 'test_a.check_1.1a', 'test_a.check_1.1c', |
| 'test_a.check_1.2a', 'test_a.check_1.2b', 'test_a.check_1.Unit_1c', 'test_a.check_1.unit_1a', 'test_a.check_1.unit_1b', 'test_a.check_2.1a', 'test_a.check_2.1c', 'test_a.check_2.2a', 'test_a.check_2.2b', 'test_a.check_2.Unit_1c', 'test_a.check_2.unit_1a', 'test_a.check_2.unit_1b', 'test_b.check_1', 'test_b.check_2', 'test_c.check_1', 'test_c.check_2'] |
| assert len(class_testsuite.get_all_tests()) == 19 |
| assert sorted(class_testsuite.get_all_tests()) == sorted(expected_tests) |
| |
| def test_get_platforms(class_testsuite, platforms_list): |
| """ Testing get_platforms function of TestSuite class in Twister """ |
| class_testsuite.platforms = platforms_list |
| platform = class_testsuite.get_platform("demo_board_1") |
| assert isinstance(platform, Platform) |
| assert platform.name == "demo_board_1" |
| |
| def test_load_from_file(test_data, class_testsuite, |
| platforms_list, all_testcases_dict, caplog, tmpdir_factory): |
| """ Testing load_from_file function of TestSuite class in Twister """ |
| # Scenario 1 : Validating the error raised if file to load from doesn't exist |
| with pytest.raises(SystemExit): |
| class_testsuite.load_from_file(test_data +"twister_test.csv") |
| assert "Couldn't find input file with list of tests." in caplog.text |
| |
| # Scenario 2: Testing if the 'instances' dictionary in Testsuite class contains |
| # the expected values after execution of load_from_file function |
| # Note: tmp_dir is the temporary directory created so that the contents |
| # get deleted after invocation of this testcase. |
| tmp_dir = tmpdir_factory.mktemp("tmp") |
| class_testsuite.outdir = tmp_dir |
| class_testsuite.platforms = platforms_list |
| class_testsuite.testcases = all_testcases_dict |
| instance_name_list = [] |
| failed_platform_list = [] |
| with open(os.path.join(test_data, "twister.csv"), "r") as filepath: |
| for row in csv.DictReader(filepath): |
| testcase_root = os.path.join(ZEPHYR_BASE, |
| "scripts/tests/twister/test_data/testcases") |
| workdir = row['test'].split('/')[-3] + "/" + row['test'].split('/')[-2] |
| test_name = os.path.basename(os.path.normpath(row['test'])) |
| testcase = TestCase(testcase_root, workdir, test_name) |
| testcase.build_only = False |
| instance_name = row["platform"] + "/" + row["test"] |
| instance_name_list.append(instance_name) |
| class_testsuite.load_from_file(test_data + "twister.csv") |
| assert list(class_testsuite.instances.keys()) == instance_name_list |
| |
| #Scenario 3 : Assert the number of times mock method (get_platform) is called, |
| # equals to the number of testcases failed |
| failed_platform_list = [row["platform"] |
| for row in csv.DictReader(filepath) |
| if row["status"] == "failed"] |
| for row in failed_platform_list: |
| with patch.object(TestSuite, 'get_platform') as mock_method: |
| class_testsuite.load_from_file(class_testsuite.outdir + "twister.csv", |
| filter_status=["Skipped", "Passed"]) |
| calls = [call(row)] |
| mock_method.assert_has_calls(calls, any_order=True) |
| assert mock_method.call_count == len(failed_platform_list) |
| |
| # Scenario 4 : Assert add_instances function is called from load_from_file function |
| class_testsuite.add_instances = MagicMock(side_effect=class_testsuite.add_instances) |
| class_testsuite.load_from_file(test_data + "twister.csv") |
| class_testsuite.add_instances.assert_called() |
| |
| # Scenario 5 : Validate if the Keyerror is raised in case if a header expected is missing |
| with pytest.raises(SystemExit): |
| class_testsuite.load_from_file(test_data + "twister_keyerror.csv") |
| assert "Key error while parsing tests file.('status')" in caplog.text |
| |
| TESTDATA_PART1 = [ |
| ("toolchain_allow", ['gcc'], None, None, "Not in testcase toolchain allow list"), |
| ("platform_allow", ['demo_board_1'], None, None, "Not in testcase platform allow list"), |
| ("toolchain_exclude", ['zephyr'], None, None, "In test case toolchain exclude"), |
| ("platform_exclude", ['demo_board_2'], None, None, "In test case platform exclude"), |
| ("arch_exclude", ['x86_demo'], None, None, "In test case arch exclude"), |
| ("arch_allow", ['arm'], None, None, "Not in test case arch allow list"), |
| ("skip", True, None, None, "Skip filter"), |
| ("tags", set(['sensor', 'bluetooth']), "ignore_tags", ['bluetooth'], "Excluded tags per platform (exclude_tags)"), |
| ("min_flash", "2024", "flash", "1024", "Not enough FLASH"), |
| ("min_ram", "500", "ram", "256", "Not enough RAM"), |
| ("None", "None", "env", ['BSIM_OUT_PATH', 'demo_env'], "Environment (BSIM_OUT_PATH, demo_env) not satisfied"), |
| ("build_on_all", True, None, None, "Platform is excluded on command line."), |
| (None, None, "supported_toolchains", ['gcc'], "Not supported by the toolchain"), |
| ] |
| |
| |
| @pytest.mark.parametrize("tc_attribute, tc_value, plat_attribute, plat_value, expected_discards", |
| TESTDATA_PART1) |
| def test_apply_filters_part1(class_testsuite, all_testcases_dict, platforms_list, |
| tc_attribute, tc_value, plat_attribute, plat_value, expected_discards): |
| """ Testing apply_filters function of TestSuite class in Twister |
| Part 1: Response of apply_filters function (discard dictionary) have |
| appropriate values according to the filters |
| """ |
| if tc_attribute is None and plat_attribute is None: |
| discards = class_testsuite.apply_filters() |
| assert not discards |
| |
| class_testsuite.platforms = platforms_list |
| class_testsuite.testcases = all_testcases_dict |
| for plat in class_testsuite.platforms: |
| if plat_attribute == "ignore_tags": |
| plat.ignore_tags = plat_value |
| if plat_attribute == "flash": |
| plat.flash = plat_value |
| if plat_attribute == "ram": |
| plat.ram = plat_value |
| if plat_attribute == "env": |
| plat.env = plat_value |
| plat.env_satisfied = False |
| if plat_attribute == "supported_toolchains": |
| plat.supported_toolchains = plat_value |
| for _, testcase in class_testsuite.testcases.items(): |
| if tc_attribute == "toolchain_allow": |
| testcase.toolchain_allow = tc_value |
| if tc_attribute == "platform_allow": |
| testcase.platform_allow = tc_value |
| if tc_attribute == "toolchain_exclude": |
| testcase.toolchain_exclude = tc_value |
| if tc_attribute == "platform_exclude": |
| testcase.platform_exclude = tc_value |
| if tc_attribute == "arch_exclude": |
| testcase.arch_exclude = tc_value |
| if tc_attribute == "arch_allow": |
| testcase.arch_allow = tc_value |
| if tc_attribute == "skip": |
| testcase.skip = tc_value |
| if tc_attribute == "tags": |
| testcase.tags = tc_value |
| if tc_attribute == "min_flash": |
| testcase.min_flash = tc_value |
| if tc_attribute == "min_ram": |
| testcase.min_ram = tc_value |
| |
| if tc_attribute == "build_on_all": |
| for _, testcase in class_testsuite.testcases.items(): |
| testcase.build_on_all = tc_value |
| discards = class_testsuite.apply_filters(exclude_platform=['demo_board_1']) |
| elif plat_attribute == "supported_toolchains": |
| discards = class_testsuite.apply_filters(force_toolchain=False, |
| exclude_platform=['demo_board_1'], |
| platform=['demo_board_2']) |
| elif tc_attribute is None and plat_attribute is None: |
| discards = class_testsuite.apply_filters() |
| else: |
| discards = class_testsuite.apply_filters(exclude_platform=['demo_board_1'], |
| platform=['demo_board_2']) |
| |
| for x in [expected_discards]: |
| assert x in discards.values() |
| |
| TESTDATA_PART2 = [ |
| ("runnable", "True", "Not runnable on device"), |
| ("exclude_tag", ['test_a'], "Command line testcase exclude filter"), |
| ("run_individual_tests", ['scripts/tests/twister/test_data/testcases/tests/test_a/test_a.check_1'], "Testcase name filter"), |
| ("arch", ['arm_test'], "Command line testcase arch filter"), |
| ("tag", ['test_d'], "Command line testcase tag filter") |
| ] |
| |
| |
| @pytest.mark.parametrize("extra_filter, extra_filter_value, expected_discards", TESTDATA_PART2) |
| def test_apply_filters_part2(class_testsuite, all_testcases_dict, |
| platforms_list, extra_filter, extra_filter_value, expected_discards): |
| """ Testing apply_filters function of TestSuite class in Twister |
| Part 2 : Response of apply_filters function (discard dictionary) have |
| appropriate values according to the filters |
| """ |
| |
| class_testsuite.platforms = platforms_list |
| class_testsuite.testcases = all_testcases_dict |
| kwargs = { |
| extra_filter : extra_filter_value, |
| "exclude_platform" : [ |
| 'demo_board_1' |
| ], |
| "platform" : [ |
| 'demo_board_2' |
| ] |
| } |
| discards = class_testsuite.apply_filters(**kwargs) |
| assert discards |
| for d in discards.values(): |
| assert d == expected_discards |
| |
| |
| TESTDATA_PART3 = [ |
| (20, 20, -1, 0), |
| (-2, -1, 10, 20), |
| (0, 0, 0, 0) |
| ] |
| |
| @pytest.mark.parametrize("tc_min_flash, plat_flash, tc_min_ram, plat_ram", |
| TESTDATA_PART3) |
| def test_apply_filters_part3(class_testsuite, all_testcases_dict, platforms_list, |
| tc_min_flash, plat_flash, tc_min_ram, plat_ram): |
| """ Testing apply_filters function of TestSuite class in Twister |
| Part 3 : Testing edge cases for ram and flash values of platforms & testcases |
| """ |
| class_testsuite.platforms = platforms_list |
| class_testsuite.testcases = all_testcases_dict |
| |
| for plat in class_testsuite.platforms: |
| plat.flash = plat_flash |
| plat.ram = plat_ram |
| for _, testcase in class_testsuite.testcases.items(): |
| testcase.min_ram = tc_min_ram |
| testcase.min_flash = tc_min_flash |
| discards = class_testsuite.apply_filters(exclude_platform=['demo_board_1'], |
| platform=['demo_board_2']) |
| assert not discards |
| |
| def test_add_instances(test_data, class_testsuite, all_testcases_dict, platforms_list): |
| """ Testing add_instances() function of TestSuite class in Twister |
| Test 1: instances dictionary keys have expected values (Platform Name + Testcase Name) |
| Test 2: Values of 'instances' dictionary in Testsuite class are an |
| instance of 'TestInstance' class |
| Test 3: Values of 'instances' dictionary have expected values. |
| """ |
| class_testsuite.outdir = test_data |
| class_testsuite.platforms = platforms_list |
| platform = class_testsuite.get_platform("demo_board_2") |
| instance_list = [] |
| for _, testcase in all_testcases_dict.items(): |
| instance = TestInstance(testcase, platform, class_testsuite.outdir) |
| instance_list.append(instance) |
| class_testsuite.add_instances(instance_list) |
| assert list(class_testsuite.instances.keys()) == \ |
| [platform.name + '/' + s for s in list(all_testcases_dict.keys())] |
| assert all(isinstance(n, TestInstance) for n in list(class_testsuite.instances.values())) |
| assert list(class_testsuite.instances.values()) == instance_list |
