1#!/usr/bin/env python3 2# SPDX-License-Identifier: GPL-2.0 3# 4# A collection of tests for tools/testing/kunit/kunit.py 5# 6# Copyright (C) 2019, Google LLC. 7# Author: Brendan Higgins <brendanhiggins@google.com> 8 9import unittest 10from unittest import mock 11 12import tempfile, shutil # Handling test_tmpdir 13 14import itertools 15import json 16import os 17import signal 18import subprocess 19from typing import Iterable 20 21import kunit_config 22import kunit_parser 23import kunit_kernel 24import kunit_json 25import kunit 26from kunit_printer import stdout 27 28test_tmpdir = '' 29abs_test_data_dir = '' 30 31def setUpModule(): 32 global test_tmpdir, abs_test_data_dir 33 test_tmpdir = tempfile.mkdtemp() 34 abs_test_data_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), 'test_data')) 35 36def tearDownModule(): 37 shutil.rmtree(test_tmpdir) 38 39def _test_data_path(path): 40 return os.path.join(abs_test_data_dir, path) 41 42class KconfigTest(unittest.TestCase): 43 44 def test_is_subset_of(self): 45 kconfig0 = kunit_config.Kconfig() 46 self.assertTrue(kconfig0.is_subset_of(kconfig0)) 47 48 kconfig1 = kunit_config.Kconfig() 49 kconfig1.add_entry('TEST', 'y') 50 self.assertTrue(kconfig1.is_subset_of(kconfig1)) 51 self.assertTrue(kconfig0.is_subset_of(kconfig1)) 52 self.assertFalse(kconfig1.is_subset_of(kconfig0)) 53 54 def test_read_from_file(self): 55 kconfig_path = _test_data_path('test_read_from_file.kconfig') 56 57 kconfig = kunit_config.parse_file(kconfig_path) 58 59 expected_kconfig = kunit_config.Kconfig() 60 expected_kconfig.add_entry('UML', 'y') 61 expected_kconfig.add_entry('MMU', 'y') 62 expected_kconfig.add_entry('TEST', 'y') 63 expected_kconfig.add_entry('EXAMPLE_TEST', 'y') 64 expected_kconfig.add_entry('MK8', 'n') 65 66 self.assertEqual(kconfig, expected_kconfig) 67 68 def test_write_to_file(self): 69 kconfig_path = os.path.join(test_tmpdir, '.config') 70 71 expected_kconfig = kunit_config.Kconfig() 72 expected_kconfig.add_entry('UML', 'y') 73 expected_kconfig.add_entry('MMU', 'y') 74 expected_kconfig.add_entry('TEST', 'y') 75 expected_kconfig.add_entry('EXAMPLE_TEST', 'y') 76 expected_kconfig.add_entry('MK8', 'n') 77 78 expected_kconfig.write_to_file(kconfig_path) 79 80 actual_kconfig = kunit_config.parse_file(kconfig_path) 81 self.assertEqual(actual_kconfig, expected_kconfig) 82 83class KUnitParserTest(unittest.TestCase): 84 def setUp(self): 85 self.print_mock = mock.patch('kunit_printer.Printer.print').start() 86 self.addCleanup(mock.patch.stopall) 87 88 def noPrintCallContains(self, substr: str): 89 for call in self.print_mock.mock_calls: 90 self.assertNotIn(substr, call.args[0]) 91 92 def assertContains(self, needle: str, haystack: kunit_parser.LineStream): 93 # Clone the iterator so we can print the contents on failure. 94 copy, backup = itertools.tee(haystack) 95 for line in copy: 96 if needle in line: 97 return 98 raise AssertionError(f'"{needle}" not found in {list(backup)}!') 99 100 def test_output_isolated_correctly(self): 101 log_path = _test_data_path('test_output_isolated_correctly.log') 102 with open(log_path) as file: 103 result = kunit_parser.extract_tap_lines(file.readlines()) 104 self.assertContains('TAP version 14', result) 105 self.assertContains('# Subtest: example', result) 106 self.assertContains('1..2', result) 107 self.assertContains('ok 1 - example_simple_test', result) 108 self.assertContains('ok 2 - example_mock_test', result) 109 self.assertContains('ok 1 - example', result) 110 111 def test_output_with_prefix_isolated_correctly(self): 112 log_path = _test_data_path('test_pound_sign.log') 113 with open(log_path) as file: 114 result = kunit_parser.extract_tap_lines(file.readlines()) 115 self.assertContains('TAP version 14', result) 116 self.assertContains('# Subtest: kunit-resource-test', result) 117 self.assertContains('1..5', result) 118 self.assertContains('ok 1 - kunit_resource_test_init_resources', result) 119 self.assertContains('ok 2 - kunit_resource_test_alloc_resource', result) 120 self.assertContains('ok 3 - kunit_resource_test_destroy_resource', result) 121 self.assertContains('foo bar #', result) 122 self.assertContains('ok 4 - kunit_resource_test_cleanup_resources', result) 123 self.assertContains('ok 5 - kunit_resource_test_proper_free_ordering', result) 124 self.assertContains('ok 1 - kunit-resource-test', result) 125 self.assertContains('foo bar # non-kunit output', result) 126 self.assertContains('# Subtest: kunit-try-catch-test', result) 127 self.assertContains('1..2', result) 128 self.assertContains('ok 1 - kunit_test_try_catch_successful_try_no_catch', 129 result) 130 self.assertContains('ok 2 - kunit_test_try_catch_unsuccessful_try_does_catch', 131 result) 132 self.assertContains('ok 2 - kunit-try-catch-test', result) 133 self.assertContains('# Subtest: string-stream-test', result) 134 self.assertContains('1..3', result) 135 self.assertContains('ok 1 - string_stream_test_empty_on_creation', result) 136 self.assertContains('ok 2 - string_stream_test_not_empty_after_add', result) 137 self.assertContains('ok 3 - string_stream_test_get_string', result) 138 self.assertContains('ok 3 - string-stream-test', result) 139 140 def test_parse_successful_test_log(self): 141 all_passed_log = _test_data_path('test_is_test_passed-all_passed.log') 142 with open(all_passed_log) as file: 143 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 144 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 145 self.assertEqual(result.counts.errors, 0) 146 147 def test_parse_successful_nested_tests_log(self): 148 all_passed_log = _test_data_path('test_is_test_passed-all_passed_nested.log') 149 with open(all_passed_log) as file: 150 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 151 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 152 self.assertEqual(result.counts.errors, 0) 153 154 def test_kselftest_nested(self): 155 kselftest_log = _test_data_path('test_is_test_passed-kselftest.log') 156 with open(kselftest_log) as file: 157 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 158 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 159 self.assertEqual(result.counts.errors, 0) 160 161 def test_parse_failed_test_log(self): 162 failed_log = _test_data_path('test_is_test_passed-failure.log') 163 with open(failed_log) as file: 164 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 165 self.assertEqual(kunit_parser.TestStatus.FAILURE, result.status) 166 self.assertEqual(result.counts.errors, 0) 167 168 def test_parse_failed_nested_tests_log(self): 169 nested_log = _test_data_path('test_is_test_passed-failure-nested.log') 170 with open(nested_log) as file: 171 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 172 self.assertEqual(kunit_parser.TestStatus.FAILURE, result.status) 173 self.assertEqual(result.counts.failed, 2) 174 self.assertEqual(kunit_parser.TestStatus.FAILURE, result.subtests[0].status) 175 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.subtests[0].subtests[0].status) 176 self.assertEqual(kunit_parser.TestStatus.FAILURE, result.subtests[1].status) 177 self.assertEqual(kunit_parser.TestStatus.FAILURE, result.subtests[1].subtests[0].status) 178 179 def test_no_header(self): 180 empty_log = _test_data_path('test_is_test_passed-no_tests_run_no_header.log') 181 with open(empty_log) as file: 182 result = kunit_parser.parse_run_tests( 183 kunit_parser.extract_tap_lines(file.readlines()), stdout) 184 self.assertEqual(0, len(result.subtests)) 185 self.assertEqual(kunit_parser.TestStatus.FAILURE_TO_PARSE_TESTS, result.status) 186 self.assertEqual(result.counts.errors, 1) 187 188 def test_missing_test_plan(self): 189 missing_plan_log = _test_data_path('test_is_test_passed-' 190 'missing_plan.log') 191 with open(missing_plan_log) as file: 192 result = kunit_parser.parse_run_tests( 193 kunit_parser.extract_tap_lines( 194 file.readlines()), stdout) 195 # A missing test plan is not an error. 196 self.assertEqual(result.counts, kunit_parser.TestCounts(passed=10, errors=0)) 197 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 198 199 def test_no_tests(self): 200 header_log = _test_data_path('test_is_test_passed-no_tests_run_with_header.log') 201 with open(header_log) as file: 202 result = kunit_parser.parse_run_tests( 203 kunit_parser.extract_tap_lines(file.readlines()), stdout) 204 self.assertEqual(0, len(result.subtests)) 205 self.assertEqual(kunit_parser.TestStatus.NO_TESTS, result.status) 206 self.assertEqual(result.counts.errors, 1) 207 208 def test_no_tests_no_plan(self): 209 no_plan_log = _test_data_path('test_is_test_passed-no_tests_no_plan.log') 210 with open(no_plan_log) as file: 211 result = kunit_parser.parse_run_tests( 212 kunit_parser.extract_tap_lines(file.readlines()), stdout) 213 self.assertEqual(0, len(result.subtests[0].subtests[0].subtests)) 214 self.assertEqual( 215 kunit_parser.TestStatus.NO_TESTS, 216 result.subtests[0].subtests[0].status) 217 self.assertEqual(result.counts, kunit_parser.TestCounts(passed=1, errors=1)) 218 219 220 def test_no_kunit_output(self): 221 crash_log = _test_data_path('test_insufficient_memory.log') 222 print_mock = mock.patch('kunit_printer.Printer.print').start() 223 with open(crash_log) as file: 224 result = kunit_parser.parse_run_tests( 225 kunit_parser.extract_tap_lines(file.readlines()), stdout) 226 print_mock.assert_any_call(StrContains('Could not find any KTAP output.')) 227 print_mock.stop() 228 self.assertEqual(0, len(result.subtests)) 229 self.assertEqual(result.counts.errors, 1) 230 231 def test_skipped_test(self): 232 skipped_log = _test_data_path('test_skip_tests.log') 233 with open(skipped_log) as file: 234 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 235 236 # A skipped test does not fail the whole suite. 237 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 238 self.assertEqual(result.counts, kunit_parser.TestCounts(passed=4, skipped=1)) 239 240 def test_skipped_all_tests(self): 241 skipped_log = _test_data_path('test_skip_all_tests.log') 242 with open(skipped_log) as file: 243 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 244 245 self.assertEqual(kunit_parser.TestStatus.SKIPPED, result.status) 246 self.assertEqual(result.counts, kunit_parser.TestCounts(skipped=5)) 247 248 def test_ignores_hyphen(self): 249 hyphen_log = _test_data_path('test_strip_hyphen.log') 250 with open(hyphen_log) as file: 251 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 252 253 # A skipped test does not fail the whole suite. 254 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 255 self.assertEqual( 256 "sysctl_test", 257 result.subtests[0].name) 258 self.assertEqual( 259 "example", 260 result.subtests[1].name) 261 262 def test_ignores_prefix_printk_time(self): 263 prefix_log = _test_data_path('test_config_printk_time.log') 264 with open(prefix_log) as file: 265 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 266 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 267 self.assertEqual('kunit-resource-test', result.subtests[0].name) 268 self.assertEqual(result.counts.errors, 0) 269 270 def test_ignores_multiple_prefixes(self): 271 prefix_log = _test_data_path('test_multiple_prefixes.log') 272 with open(prefix_log) as file: 273 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 274 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 275 self.assertEqual('kunit-resource-test', result.subtests[0].name) 276 self.assertEqual(result.counts.errors, 0) 277 278 def test_prefix_mixed_kernel_output(self): 279 mixed_prefix_log = _test_data_path('test_interrupted_tap_output.log') 280 with open(mixed_prefix_log) as file: 281 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 282 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 283 self.assertEqual('kunit-resource-test', result.subtests[0].name) 284 self.assertEqual(result.counts.errors, 0) 285 286 def test_prefix_poundsign(self): 287 pound_log = _test_data_path('test_pound_sign.log') 288 with open(pound_log) as file: 289 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 290 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 291 self.assertEqual('kunit-resource-test', result.subtests[0].name) 292 self.assertEqual(result.counts.errors, 0) 293 294 def test_kernel_panic_end(self): 295 panic_log = _test_data_path('test_kernel_panic_interrupt.log') 296 with open(panic_log) as file: 297 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 298 self.assertEqual(kunit_parser.TestStatus.TEST_CRASHED, result.status) 299 self.assertEqual('kunit-resource-test', result.subtests[0].name) 300 self.assertGreaterEqual(result.counts.errors, 1) 301 302 def test_pound_no_prefix(self): 303 pound_log = _test_data_path('test_pound_no_prefix.log') 304 with open(pound_log) as file: 305 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 306 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 307 self.assertEqual('kunit-resource-test', result.subtests[0].name) 308 self.assertEqual(result.counts.errors, 0) 309 310 def test_summarize_failures(self): 311 output = """ 312 KTAP version 1 313 1..2 314 # Subtest: all_failed_suite 315 1..2 316 not ok 1 - test1 317 not ok 2 - test2 318 not ok 1 - all_failed_suite 319 # Subtest: some_failed_suite 320 1..2 321 ok 1 - test1 322 not ok 2 - test2 323 not ok 1 - some_failed_suite 324 """ 325 result = kunit_parser.parse_run_tests(output.splitlines(), stdout) 326 self.assertEqual(kunit_parser.TestStatus.FAILURE, result.status) 327 328 self.assertEqual(kunit_parser._summarize_failed_tests(result), 329 'Failures: all_failed_suite, some_failed_suite.test2') 330 331 def test_ktap_format(self): 332 ktap_log = _test_data_path('test_parse_ktap_output.log') 333 with open(ktap_log) as file: 334 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 335 self.assertEqual(result.counts, kunit_parser.TestCounts(passed=3)) 336 self.assertEqual('suite', result.subtests[0].name) 337 self.assertEqual('case_1', result.subtests[0].subtests[0].name) 338 self.assertEqual('case_2', result.subtests[0].subtests[1].name) 339 340 def test_parse_subtest_header(self): 341 ktap_log = _test_data_path('test_parse_subtest_header.log') 342 with open(ktap_log) as file: 343 kunit_parser.parse_run_tests(file.readlines(), stdout) 344 self.print_mock.assert_any_call(StrContains('suite (1 subtest)')) 345 346 def test_parse_attributes(self): 347 ktap_log = _test_data_path('test_parse_attributes.log') 348 with open(ktap_log) as file: 349 result = kunit_parser.parse_run_tests(file.readlines(), stdout) 350 351 # Test should pass with no errors 352 self.assertEqual(result.counts, kunit_parser.TestCounts(passed=1, errors=0)) 353 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 354 355 # Ensure suite header is parsed correctly 356 self.print_mock.assert_any_call(StrContains('suite (1 subtest)')) 357 358 # Ensure attributes in correct test log 359 self.assertContains('# module: example', result.subtests[0].log) 360 self.assertContains('# test.speed: slow', result.subtests[0].subtests[0].log) 361 362 def test_show_test_output_on_failure(self): 363 output = """ 364 KTAP version 1 365 1..1 366 Test output. 367 Indented more. 368 not ok 1 test1 369 """ 370 result = kunit_parser.parse_run_tests(output.splitlines(), stdout) 371 self.assertEqual(kunit_parser.TestStatus.FAILURE, result.status) 372 373 self.print_mock.assert_any_call(StrContains('Test output.')) 374 self.print_mock.assert_any_call(StrContains(' Indented more.')) 375 self.noPrintCallContains('not ok 1 test1') 376 377 def test_parse_late_test_plan(self): 378 output = """ 379 TAP version 13 380 ok 4 test4 381 1..4 382 """ 383 result = kunit_parser.parse_run_tests(output.splitlines(), stdout) 384 # Missing test results after test plan should alert a suspected test crash. 385 self.assertEqual(kunit_parser.TestStatus.SUCCESS, result.status) 386 self.assertEqual(result.counts, kunit_parser.TestCounts(passed=1, errors=2)) 387 388def line_stream_from_strs(strs: Iterable[str]) -> kunit_parser.LineStream: 389 return kunit_parser.LineStream(enumerate(strs, start=1)) 390 391class LineStreamTest(unittest.TestCase): 392 393 def test_basic(self): 394 stream = line_stream_from_strs(['hello', 'world']) 395 396 self.assertTrue(stream, msg='Should be more input') 397 self.assertEqual(stream.line_number(), 1) 398 self.assertEqual(stream.peek(), 'hello') 399 self.assertEqual(stream.pop(), 'hello') 400 401 self.assertTrue(stream, msg='Should be more input') 402 self.assertEqual(stream.line_number(), 2) 403 self.assertEqual(stream.peek(), 'world') 404 self.assertEqual(stream.pop(), 'world') 405 406 self.assertFalse(stream, msg='Should be no more input') 407 with self.assertRaisesRegex(ValueError, 'LineStream: going past EOF'): 408 stream.pop() 409 410 def test_is_lazy(self): 411 called_times = 0 412 def generator(): 413 nonlocal called_times 414 for _ in range(1,5): 415 called_times += 1 416 yield called_times, str(called_times) 417 418 stream = kunit_parser.LineStream(generator()) 419 self.assertEqual(called_times, 0) 420 421 self.assertEqual(stream.pop(), '1') 422 self.assertEqual(called_times, 1) 423 424 self.assertEqual(stream.pop(), '2') 425 self.assertEqual(called_times, 2) 426 427class LinuxSourceTreeTest(unittest.TestCase): 428 429 def setUp(self): 430 mock.patch.object(signal, 'signal').start() 431 self.addCleanup(mock.patch.stopall) 432 433 def test_invalid_kunitconfig(self): 434 with self.assertRaisesRegex(kunit_kernel.ConfigError, 'nonexistent.* does not exist'): 435 kunit_kernel.LinuxSourceTree('', kunitconfig_paths=['/nonexistent_file']) 436 437 def test_valid_kunitconfig(self): 438 with tempfile.NamedTemporaryFile('wt') as kunitconfig: 439 kunit_kernel.LinuxSourceTree('', kunitconfig_paths=[kunitconfig.name]) 440 441 def test_dir_kunitconfig(self): 442 with tempfile.TemporaryDirectory('') as dir: 443 with open(os.path.join(dir, '.kunitconfig'), 'w'): 444 pass 445 kunit_kernel.LinuxSourceTree('', kunitconfig_paths=[dir]) 446 447 def test_multiple_kunitconfig(self): 448 want_kconfig = kunit_config.Kconfig() 449 want_kconfig.add_entry('KUNIT', 'y') 450 want_kconfig.add_entry('KUNIT_TEST', 'm') 451 452 with tempfile.TemporaryDirectory('') as dir: 453 other = os.path.join(dir, 'otherkunitconfig') 454 with open(os.path.join(dir, '.kunitconfig'), 'w') as f: 455 f.write('CONFIG_KUNIT=y') 456 with open(other, 'w') as f: 457 f.write('CONFIG_KUNIT_TEST=m') 458 pass 459 460 tree = kunit_kernel.LinuxSourceTree('', kunitconfig_paths=[dir, other]) 461 self.assertTrue(want_kconfig.is_subset_of(tree._kconfig), msg=tree._kconfig) 462 463 464 def test_multiple_kunitconfig_invalid(self): 465 with tempfile.TemporaryDirectory('') as dir: 466 other = os.path.join(dir, 'otherkunitconfig') 467 with open(os.path.join(dir, '.kunitconfig'), 'w') as f: 468 f.write('CONFIG_KUNIT=y') 469 with open(other, 'w') as f: 470 f.write('CONFIG_KUNIT=m') 471 472 with self.assertRaisesRegex(kunit_kernel.ConfigError, '(?s)Multiple values.*CONFIG_KUNIT'): 473 kunit_kernel.LinuxSourceTree('', kunitconfig_paths=[dir, other]) 474 475 476 def test_kconfig_add(self): 477 want_kconfig = kunit_config.Kconfig() 478 want_kconfig.add_entry('NOT_REAL', 'y') 479 480 tree = kunit_kernel.LinuxSourceTree('', kunitconfig_paths=[os.devnull], 481 kconfig_add=['CONFIG_NOT_REAL=y']) 482 self.assertTrue(want_kconfig.is_subset_of(tree._kconfig), msg=tree._kconfig) 483 484 def test_invalid_arch(self): 485 with self.assertRaisesRegex(kunit_kernel.ConfigError, 'not a valid arch, options are.*x86_64'): 486 kunit_kernel.LinuxSourceTree('', arch='invalid') 487 488 def test_run_kernel_hits_exception(self): 489 def fake_start(unused_args, unused_build_dir): 490 return subprocess.Popen(['echo "hi\nbye"'], shell=True, text=True, stdout=subprocess.PIPE) 491 492 with tempfile.TemporaryDirectory('') as build_dir: 493 tree = kunit_kernel.LinuxSourceTree(build_dir, kunitconfig_paths=[os.devnull]) 494 mock.patch.object(tree._ops, 'start', side_effect=fake_start).start() 495 496 with self.assertRaises(ValueError): 497 for line in tree.run_kernel(build_dir=build_dir): 498 self.assertEqual(line, 'hi\n') 499 raise ValueError('uh oh, did not read all output') 500 501 with open(kunit_kernel.get_outfile_path(build_dir), 'rt') as outfile: 502 self.assertEqual(outfile.read(), 'hi\nbye\n', msg='Missing some output') 503 504 def test_build_reconfig_no_config(self): 505 with tempfile.TemporaryDirectory('') as build_dir: 506 with open(kunit_kernel.get_kunitconfig_path(build_dir), 'w') as f: 507 f.write('CONFIG_KUNIT=y') 508 509 tree = kunit_kernel.LinuxSourceTree(build_dir) 510 # Stub out the source tree operations, so we don't have 511 # the defaults for any given architecture get in the 512 # way. 513 tree._ops = kunit_kernel.LinuxSourceTreeOperations('none', None) 514 mock_build_config = mock.patch.object(tree, 'build_config').start() 515 516 # Should generate the .config 517 self.assertTrue(tree.build_reconfig(build_dir, make_options=[])) 518 mock_build_config.assert_called_once_with(build_dir, []) 519 520 def test_build_reconfig_existing_config(self): 521 with tempfile.TemporaryDirectory('') as build_dir: 522 # Existing .config is a superset, should not touch it 523 with open(kunit_kernel.get_kunitconfig_path(build_dir), 'w') as f: 524 f.write('CONFIG_KUNIT=y') 525 with open(kunit_kernel.get_old_kunitconfig_path(build_dir), 'w') as f: 526 f.write('CONFIG_KUNIT=y') 527 with open(kunit_kernel.get_kconfig_path(build_dir), 'w') as f: 528 f.write('CONFIG_KUNIT=y\nCONFIG_KUNIT_TEST=y') 529 530 tree = kunit_kernel.LinuxSourceTree(build_dir) 531 # Stub out the source tree operations, so we don't have 532 # the defaults for any given architecture get in the 533 # way. 534 tree._ops = kunit_kernel.LinuxSourceTreeOperations('none', None) 535 mock_build_config = mock.patch.object(tree, 'build_config').start() 536 537 self.assertTrue(tree.build_reconfig(build_dir, make_options=[])) 538 self.assertEqual(mock_build_config.call_count, 0) 539 540 def test_build_reconfig_remove_option(self): 541 with tempfile.TemporaryDirectory('') as build_dir: 542 # We removed CONFIG_KUNIT_TEST=y from our .kunitconfig... 543 with open(kunit_kernel.get_kunitconfig_path(build_dir), 'w') as f: 544 f.write('CONFIG_KUNIT=y') 545 with open(kunit_kernel.get_old_kunitconfig_path(build_dir), 'w') as f: 546 f.write('CONFIG_KUNIT=y\nCONFIG_KUNIT_TEST=y') 547 with open(kunit_kernel.get_kconfig_path(build_dir), 'w') as f: 548 f.write('CONFIG_KUNIT=y\nCONFIG_KUNIT_TEST=y') 549 550 tree = kunit_kernel.LinuxSourceTree(build_dir) 551 # Stub out the source tree operations, so we don't have 552 # the defaults for any given architecture get in the 553 # way. 554 tree._ops = kunit_kernel.LinuxSourceTreeOperations('none', None) 555 mock_build_config = mock.patch.object(tree, 'build_config').start() 556 557 # ... so we should trigger a call to build_config() 558 self.assertTrue(tree.build_reconfig(build_dir, make_options=[])) 559 mock_build_config.assert_called_once_with(build_dir, []) 560 561 # TODO: add more test cases. 562 563 564class KUnitJsonTest(unittest.TestCase): 565 def setUp(self): 566 self.print_mock = mock.patch('kunit_printer.Printer.print').start() 567 self.addCleanup(mock.patch.stopall) 568 569 def _json_for(self, log_file): 570 with open(_test_data_path(log_file)) as file: 571 test_result = kunit_parser.parse_run_tests(file, stdout) 572 json_obj = kunit_json.get_json_result( 573 test=test_result, 574 metadata=kunit_json.Metadata()) 575 return json.loads(json_obj) 576 577 def test_failed_test_json(self): 578 result = self._json_for('test_is_test_passed-failure.log') 579 self.assertEqual( 580 {'name': 'example_simple_test', 'status': 'FAIL'}, 581 result["sub_groups"][1]["test_cases"][0]) 582 583 def test_crashed_test_json(self): 584 result = self._json_for('test_kernel_panic_interrupt.log') 585 self.assertEqual( 586 {'name': '', 'status': 'ERROR'}, 587 result["sub_groups"][2]["test_cases"][1]) 588 589 def test_skipped_test_json(self): 590 result = self._json_for('test_skip_tests.log') 591 self.assertEqual( 592 {'name': 'example_skip_test', 'status': 'SKIP'}, 593 result["sub_groups"][1]["test_cases"][1]) 594 595 def test_no_tests_json(self): 596 result = self._json_for('test_is_test_passed-no_tests_run_with_header.log') 597 self.assertEqual(0, len(result['sub_groups'])) 598 599 def test_nested_json(self): 600 result = self._json_for('test_is_test_passed-all_passed_nested.log') 601 self.assertEqual( 602 {'name': 'example_simple_test', 'status': 'PASS'}, 603 result["sub_groups"][0]["sub_groups"][0]["test_cases"][0]) 604 605class StrContains(str): 606 def __eq__(self, other): 607 return self in other 608 609class KUnitMainTest(unittest.TestCase): 610 def setUp(self): 611 path = _test_data_path('test_is_test_passed-all_passed.log') 612 with open(path) as file: 613 all_passed_log = file.readlines() 614 615 self.print_mock = mock.patch('kunit_printer.Printer.print').start() 616 mock.patch.dict(os.environ, clear=True).start() 617 self.addCleanup(mock.patch.stopall) 618 619 self.mock_linux_init = mock.patch.object(kunit_kernel, 'LinuxSourceTree').start() 620 self.linux_source_mock = self.mock_linux_init.return_value 621 self.linux_source_mock.build_reconfig.return_value = True 622 self.linux_source_mock.build_kernel.return_value = True 623 self.linux_source_mock.run_kernel.return_value = all_passed_log 624 625 def test_config_passes_args_pass(self): 626 kunit.main(['config', '--build_dir=.kunit']) 627 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 628 self.assertEqual(self.linux_source_mock.run_kernel.call_count, 0) 629 630 def test_build_passes_args_pass(self): 631 kunit.main(['build']) 632 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 633 self.linux_source_mock.build_kernel.assert_called_once_with(kunit.get_default_jobs(), '.kunit', None) 634 self.assertEqual(self.linux_source_mock.run_kernel.call_count, 0) 635 636 def test_exec_passes_args_pass(self): 637 kunit.main(['exec']) 638 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 0) 639 self.assertEqual(self.linux_source_mock.run_kernel.call_count, 1) 640 self.linux_source_mock.run_kernel.assert_called_once_with( 641 args=None, build_dir='.kunit', filter_glob='', filter='', filter_action=None, timeout=300) 642 self.print_mock.assert_any_call(StrContains('Testing complete.')) 643 644 def test_run_passes_args_pass(self): 645 kunit.main(['run']) 646 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 647 self.assertEqual(self.linux_source_mock.run_kernel.call_count, 1) 648 self.linux_source_mock.run_kernel.assert_called_once_with( 649 args=None, build_dir='.kunit', filter_glob='', filter='', filter_action=None, timeout=300) 650 self.print_mock.assert_any_call(StrContains('Testing complete.')) 651 652 def test_exec_passes_args_fail(self): 653 self.linux_source_mock.run_kernel = mock.Mock(return_value=[]) 654 with self.assertRaises(SystemExit) as e: 655 kunit.main(['exec']) 656 self.assertEqual(e.exception.code, 1) 657 658 def test_run_passes_args_fail(self): 659 self.linux_source_mock.run_kernel = mock.Mock(return_value=[]) 660 with self.assertRaises(SystemExit) as e: 661 kunit.main(['run']) 662 self.assertEqual(e.exception.code, 1) 663 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 664 self.assertEqual(self.linux_source_mock.run_kernel.call_count, 1) 665 self.print_mock.assert_any_call(StrContains('Could not find any KTAP output.')) 666 667 def test_exec_no_tests(self): 668 self.linux_source_mock.run_kernel = mock.Mock(return_value=['TAP version 14', '1..0']) 669 with self.assertRaises(SystemExit) as e: 670 kunit.main(['run']) 671 self.assertEqual(e.exception.code, 1) 672 self.linux_source_mock.run_kernel.assert_called_once_with( 673 args=None, build_dir='.kunit', filter_glob='', filter='', filter_action=None, timeout=300) 674 self.print_mock.assert_any_call(StrContains(' 0 tests run!')) 675 676 def test_exec_raw_output(self): 677 self.linux_source_mock.run_kernel = mock.Mock(return_value=[]) 678 kunit.main(['exec', '--raw_output']) 679 self.assertEqual(self.linux_source_mock.run_kernel.call_count, 1) 680 for call in self.print_mock.call_args_list: 681 self.assertNotEqual(call, mock.call(StrContains('Testing complete.'))) 682 self.assertNotEqual(call, mock.call(StrContains(' 0 tests run!'))) 683 684 def test_run_raw_output(self): 685 self.linux_source_mock.run_kernel = mock.Mock(return_value=[]) 686 kunit.main(['run', '--raw_output']) 687 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 688 self.assertEqual(self.linux_source_mock.run_kernel.call_count, 1) 689 for call in self.print_mock.call_args_list: 690 self.assertNotEqual(call, mock.call(StrContains('Testing complete.'))) 691 self.assertNotEqual(call, mock.call(StrContains(' 0 tests run!'))) 692 693 def test_run_raw_output_kunit(self): 694 self.linux_source_mock.run_kernel = mock.Mock(return_value=[]) 695 kunit.main(['run', '--raw_output=kunit']) 696 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 697 self.assertEqual(self.linux_source_mock.run_kernel.call_count, 1) 698 for call in self.print_mock.call_args_list: 699 self.assertNotEqual(call, mock.call(StrContains('Testing complete.'))) 700 self.assertNotEqual(call, mock.call(StrContains(' 0 tests run'))) 701 702 def test_run_raw_output_invalid(self): 703 self.linux_source_mock.run_kernel = mock.Mock(return_value=[]) 704 with self.assertRaises(SystemExit) as e: 705 kunit.main(['run', '--raw_output=invalid']) 706 self.assertNotEqual(e.exception.code, 0) 707 708 def test_run_raw_output_does_not_take_positional_args(self): 709 # --raw_output is a string flag, but we don't want it to consume 710 # any positional arguments, only ones after an '=' 711 self.linux_source_mock.run_kernel = mock.Mock(return_value=[]) 712 kunit.main(['run', '--raw_output', 'filter_glob']) 713 self.linux_source_mock.run_kernel.assert_called_once_with( 714 args=None, build_dir='.kunit', filter_glob='filter_glob', filter='', filter_action=None, timeout=300) 715 716 def test_exec_timeout(self): 717 timeout = 3453 718 kunit.main(['exec', '--timeout', str(timeout)]) 719 self.linux_source_mock.run_kernel.assert_called_once_with( 720 args=None, build_dir='.kunit', filter_glob='', filter='', filter_action=None, timeout=timeout) 721 self.print_mock.assert_any_call(StrContains('Testing complete.')) 722 723 def test_run_timeout(self): 724 timeout = 3453 725 kunit.main(['run', '--timeout', str(timeout)]) 726 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 727 self.linux_source_mock.run_kernel.assert_called_once_with( 728 args=None, build_dir='.kunit', filter_glob='', filter='', filter_action=None, timeout=timeout) 729 self.print_mock.assert_any_call(StrContains('Testing complete.')) 730 731 def test_run_builddir(self): 732 build_dir = '.kunit' 733 kunit.main(['run', '--build_dir=.kunit']) 734 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 735 self.linux_source_mock.run_kernel.assert_called_once_with( 736 args=None, build_dir=build_dir, filter_glob='', filter='', filter_action=None, timeout=300) 737 self.print_mock.assert_any_call(StrContains('Testing complete.')) 738 739 @mock.patch.dict(os.environ, {'KBUILD_OUTPUT': '/tmp'}) 740 def test_run_builddir_from_env(self): 741 build_dir = '/tmp/.kunit' 742 kunit.main(['run']) 743 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 744 self.linux_source_mock.run_kernel.assert_called_once_with( 745 args=None, build_dir=build_dir, filter_glob='', filter='', filter_action=None, timeout=300) 746 self.print_mock.assert_any_call(StrContains('Testing complete.')) 747 748 @mock.patch.dict(os.environ, {'KBUILD_OUTPUT': '/tmp'}) 749 def test_run_builddir_override(self): 750 build_dir = '.kunit' 751 kunit.main(['run', '--build_dir=.kunit']) 752 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 753 self.linux_source_mock.run_kernel.assert_called_once_with( 754 args=None, build_dir=build_dir, filter_glob='', filter='', filter_action=None, timeout=300) 755 self.print_mock.assert_any_call(StrContains('Testing complete.')) 756 757 def test_config_builddir(self): 758 build_dir = '.kunit' 759 kunit.main(['config', '--build_dir', build_dir]) 760 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 761 762 def test_build_builddir(self): 763 build_dir = '.kunit' 764 jobs = kunit.get_default_jobs() 765 kunit.main(['build', '--build_dir', build_dir]) 766 self.linux_source_mock.build_kernel.assert_called_once_with(jobs, build_dir, None) 767 768 def test_exec_builddir(self): 769 build_dir = '.kunit' 770 kunit.main(['exec', '--build_dir', build_dir]) 771 self.linux_source_mock.run_kernel.assert_called_once_with( 772 args=None, build_dir=build_dir, filter_glob='', filter='', filter_action=None, timeout=300) 773 self.print_mock.assert_any_call(StrContains('Testing complete.')) 774 775 def test_run_kunitconfig(self): 776 kunit.main(['run', '--kunitconfig=mykunitconfig']) 777 # Just verify that we parsed and initialized it correctly here. 778 self.mock_linux_init.assert_called_once_with('.kunit', 779 kunitconfig_paths=['mykunitconfig'], 780 kconfig_add=None, 781 arch='um', 782 cross_compile=None, 783 qemu_config_path=None, 784 extra_qemu_args=[]) 785 786 def test_config_kunitconfig(self): 787 kunit.main(['config', '--kunitconfig=mykunitconfig']) 788 # Just verify that we parsed and initialized it correctly here. 789 self.mock_linux_init.assert_called_once_with('.kunit', 790 kunitconfig_paths=['mykunitconfig'], 791 kconfig_add=None, 792 arch='um', 793 cross_compile=None, 794 qemu_config_path=None, 795 extra_qemu_args=[]) 796 797 def test_config_alltests(self): 798 kunit.main(['config', '--kunitconfig=mykunitconfig', '--alltests']) 799 # Just verify that we parsed and initialized it correctly here. 800 self.mock_linux_init.assert_called_once_with('.kunit', 801 kunitconfig_paths=[kunit_kernel.ALL_TESTS_CONFIG_PATH, 'mykunitconfig'], 802 kconfig_add=None, 803 arch='um', 804 cross_compile=None, 805 qemu_config_path=None, 806 extra_qemu_args=[]) 807 808 809 @mock.patch.object(kunit_kernel, 'LinuxSourceTree') 810 def test_run_multiple_kunitconfig(self, mock_linux_init): 811 mock_linux_init.return_value = self.linux_source_mock 812 kunit.main(['run', '--kunitconfig=mykunitconfig', '--kunitconfig=other']) 813 # Just verify that we parsed and initialized it correctly here. 814 mock_linux_init.assert_called_once_with('.kunit', 815 kunitconfig_paths=['mykunitconfig', 'other'], 816 kconfig_add=None, 817 arch='um', 818 cross_compile=None, 819 qemu_config_path=None, 820 extra_qemu_args=[]) 821 822 def test_run_kconfig_add(self): 823 kunit.main(['run', '--kconfig_add=CONFIG_KASAN=y', '--kconfig_add=CONFIG_KCSAN=y']) 824 # Just verify that we parsed and initialized it correctly here. 825 self.mock_linux_init.assert_called_once_with('.kunit', 826 kunitconfig_paths=[], 827 kconfig_add=['CONFIG_KASAN=y', 'CONFIG_KCSAN=y'], 828 arch='um', 829 cross_compile=None, 830 qemu_config_path=None, 831 extra_qemu_args=[]) 832 833 def test_run_qemu_args(self): 834 kunit.main(['run', '--arch=x86_64', '--qemu_args', '-m 2048']) 835 # Just verify that we parsed and initialized it correctly here. 836 self.mock_linux_init.assert_called_once_with('.kunit', 837 kunitconfig_paths=[], 838 kconfig_add=None, 839 arch='x86_64', 840 cross_compile=None, 841 qemu_config_path=None, 842 extra_qemu_args=['-m', '2048']) 843 844 def test_run_kernel_args(self): 845 kunit.main(['run', '--kernel_args=a=1', '--kernel_args=b=2']) 846 self.assertEqual(self.linux_source_mock.build_reconfig.call_count, 1) 847 self.linux_source_mock.run_kernel.assert_called_once_with( 848 args=['a=1','b=2'], build_dir='.kunit', filter_glob='', filter='', filter_action=None, timeout=300) 849 self.print_mock.assert_any_call(StrContains('Testing complete.')) 850 851 def test_list_tests(self): 852 want = ['suite.test1', 'suite.test2', 'suite2.test1'] 853 self.linux_source_mock.run_kernel.return_value = ['TAP version 14', 'init: random output'] + want 854 855 got = kunit._list_tests(self.linux_source_mock, 856 kunit.KunitExecRequest(None, None, False, False, '.kunit', 300, 'suite*', '', None, None, 'suite', False, False)) 857 self.assertEqual(got, want) 858 # Should respect the user's filter glob when listing tests. 859 self.linux_source_mock.run_kernel.assert_called_once_with( 860 args=['kunit.action=list'], build_dir='.kunit', filter_glob='suite*', filter='', filter_action=None, timeout=300) 861 862 @mock.patch.object(kunit, '_list_tests') 863 def test_run_isolated_by_suite(self, mock_tests): 864 mock_tests.return_value = ['suite.test1', 'suite.test2', 'suite2.test1'] 865 kunit.main(['exec', '--run_isolated=suite', 'suite*.test*']) 866 867 # Should respect the user's filter glob when listing tests. 868 mock_tests.assert_called_once_with(mock.ANY, 869 kunit.KunitExecRequest(None, None, False, False, '.kunit', 300, 'suite*.test*', '', None, None, 'suite', False, False)) 870 self.linux_source_mock.run_kernel.assert_has_calls([ 871 mock.call(args=None, build_dir='.kunit', filter_glob='suite.test*', filter='', filter_action=None, timeout=300), 872 mock.call(args=None, build_dir='.kunit', filter_glob='suite2.test*', filter='', filter_action=None, timeout=300), 873 ]) 874 875 @mock.patch.object(kunit, '_list_tests') 876 def test_run_isolated_by_test(self, mock_tests): 877 mock_tests.return_value = ['suite.test1', 'suite.test2', 'suite2.test1'] 878 kunit.main(['exec', '--run_isolated=test', 'suite*']) 879 880 # Should respect the user's filter glob when listing tests. 881 mock_tests.assert_called_once_with(mock.ANY, 882 kunit.KunitExecRequest(None, None, False, False, '.kunit', 300, 'suite*', '', None, None, 'test', False, False)) 883 self.linux_source_mock.run_kernel.assert_has_calls([ 884 mock.call(args=None, build_dir='.kunit', filter_glob='suite.test1', filter='', filter_action=None, timeout=300), 885 mock.call(args=None, build_dir='.kunit', filter_glob='suite.test2', filter='', filter_action=None, timeout=300), 886 mock.call(args=None, build_dir='.kunit', filter_glob='suite2.test1', filter='', filter_action=None, timeout=300), 887 ]) 888 889if __name__ == '__main__': 890 unittest.main() 891