testing/kunit/kunit_parser.py

150 	(line#, text).
165 		"""Advances the LineSteam to the next line, if necessary."""
176 		"""Returns the current line, without advancing the LineStream.
182 		"""Returns the current line and advances the LineStream to
183 		the next line.
187 			raise ValueError(f'LineStream: going past EOF, last line was {s}')
205 		"""Returns the line number of the current line."""
223 		for line in kernel_output:
225 			line = line.rstrip()  # remove trailing \n
226 			if not started and KTAP_START.search(line):
228 				# to number of characters before version line
230 					line.split('KTAP version')[0])
232 				yield line_num, line[prefix_len:]
233 			elif not started and TAP_START.search(line):
235 				# to number of characters before version line
236 				prefix_len = len(line.split('TAP version')[0])
238 				yield line_num, line[prefix_len:]
239 			elif started and KTAP_END.search(line):
244 				line = line[prefix_len:]
245 				yield line_num, line
246 			elif EXECUTOR_ERROR.search(line):
247 				yield line_num, line
261 		header line
264 		version line.
274 	Parses KTAP/TAP header line and checks version number.
275 	Returns False if fails to parse KTAP/TAP header line.
286 	True if successfully parsed KTAP/TAP header line
306 	Returns False if fails to parse test header line.
316 	True if successfully parsed test header line
329 	Parses test plan line and stores the expected number of subtests in
342 	True if successfully parsed test plan line
359 	Matches current line with the format of a test result line and checks
372 	True if matched a test result line and the name matching the
375 	line = lines.peek()
376 	match = TEST_RESULT.match(line)
385 	Parses test result line and stores the status and name in the test
388 	Returns False if fails to parse test result line.
403 	True if successfully parsed a test result line.
405 	line = lines.peek()
406 	match = TEST_RESULT.match(line)
407 	skip_match = TEST_RESULT_SKIP.match(line)
409 	# Check if line matches test result line format
437 	Parse lines that do not match the format of a test result line or
438 	test header line and returns them in list.
440 	Line formats that are not parsed:
472 	message - message to be centered in divider line
503 		# is provided using a "# Subtest" header line.
515 	for line in formatted.splitlines():
516 		stdout.print_with_timestamp(stdout.yellow(line))
546 	Prints result line with status of test.
606 	Prints summary line of test object. Color of line is dependent on
608 	skipped, and red if the test fails or crashes. Summary line contains
675 	- Subtest header (must include either the KTAP version line or
676 	  "# Subtest" header line)
678 	Example (preferred format with both KTAP version line and
679 	"# Subtest" line):
687 	Example (only "# Subtest" line):
694 	Example (only KTAP version line, compliant with KTAP v1 spec):
701 	- Test result line
725 		# If parsing the main/top-level test, parse KTAP version line and
734 		# the KTAP version line and/or subtest header line
739 			# If KTAP version line and/or subtest header is found, attempt
751 		# result line with matching name to subtest header is found
775 		# If not main test, look for test result line
778 			test.add_error('missing subtest result line!')
804 	results and print condensed test results and summary line.