buildtest.cli.inspect

This module implements methods for buildtest inspect command that can be used to retrieve test record from report file in JSON format.

Module Contents

Functions

inspect_cmd(args, configuration[, report_file])	Entry point for buildtest inspect command
fetch_test_names(report, names)	Return a list of builders given input test names by search the report file for valid records. If test is found it will be returned as a builder name. If names
print_builders(report)	This method prints all the builders.
print_terse(table[, no_header, console_color])	This method prints output of builders in terse mode which is run via command buildtest inspect list --terse
inspect_list(report[, terse, no_header, builder, ...])	This method list an output of test id, name, and buildspec file from the report cache. The default
print_by_query(report, args)	This method prints the test records when they are queried using buildtest inspect query command.
inspect_query(report, args[, pager])	Entry point for buildtest inspect query command.
inspect_buildspec(report, input_buildspecs, all_records)	This method implements command buildtest inspect buildspec
print_by_name(report, names)	This method prints test records by given name in JSON format.
inspect_by_name(report, names[, pager])	Implements command buildtest inspect name which will print all test records by given name in JSON format.

buildtest.cli.inspect.inspect_cmd(args, configuration, report_file=None)

Entry point for buildtest inspect command

Parameters

args (dict) – Parsed arguments from ArgumentParser.parse_args

buildtest.cli.inspect.fetch_test_names(report, names)

Return a list of builders given input test names by search the report file for valid records. If test is found it will be returned as a builder name. If names are specified without test ID then we retrieve latest record for test name. If names are specified with ID we find the first matching test record.

Parameters

• report (buildtest.cli.report.Report) – An instance of Report class

• names (list) – A list of test names

buildtest.cli.inspect.print_builders(report)

This method prints all the builders.

Parameters

report (str) – Path to report file

buildtest.cli.inspect.print_terse(table, no_header=None, console_color=None)

This method prints output of builders in terse mode which is run via command buildtest inspect list --terse

Parameters

• table (dict) – Table with columns required for the buildtest inspect list command.

• no_header (bool, optional) – Determine whether to print header in terse format.

• console_color (bool, optional) – Select desired color when displaying results

buildtest.cli.inspect.inspect_list(report, terse=None, no_header=None, builder=None, color=None, pager=None, row_count=None)

This method list an output of test id, name, and buildspec file from the report cache. The default behavior is to display output in table format though this can be changed with terse format which will display in parseable format. This method implements command buildtest inspect list

Parameters

• report (str) – Path to report file

• terse (bool, optional) – Print output in terse format

• no_header (bool, optional) – Determine whether to print header in terse format.

• builder (bool, optional) – Print output in builder format which can be done via buildtest inspect list --builder

• color (bool, optional) – Print table output of buildtest inspect list with selected color

• pager (bool, optional) – Print output in paging format

• row_count (bool, optional) – Print total number of test runs

buildtest.cli.inspect.print_by_query(report, args)

This method prints the test records when they are queried using buildtest inspect query command.

Parameters

• report (str) – Path to report file

• args (dict) –

  Parsed arguments from ArgumentParser.parse_args

buildtest.cli.inspect.inspect_query(report, args, pager=None)

Entry point for buildtest inspect query command.

Parameters

• report (str) – Path to report file

• args (dict) –

  Parsed arguments from ArgumentParser.parse_args

• pager (bool, optional) – Print output in paging format

buildtest.cli.inspect.inspect_buildspec(report, input_buildspecs, all_records, pager=None)

This method implements command buildtest inspect buildspec

Parameters

• report (str) – Path to report file

• input_buildspecs (list) – List of buildspecs to search in report file. This is specified as positional arguments to buildtest inspect buildspec

• all_records (bool) – Determine whether to display all records for every test that matches the buildspec. By default we retrieve the latest record.

• pager (bool, optional) – Print output in paging format

buildtest.cli.inspect.print_by_name(report, names)

This method prints test records by given name in JSON format.

Parameters

• report (str) – Path to report file

• names (list) – List of test names to search in report file. This is specified as positional arguments to buildtest inspect name

buildtest.cli.inspect.inspect_by_name(report, names, pager=None)

Implements command buildtest inspect name which will print all test records by given name in JSON format.

# get last run for test exit1_fail
buildtest inspect name exit1_fail

# get record exit1_fail that starts with id 123
buildtest inspect name exit1_fail/123

Parameters

• report (str) – Path to report file

• names (list) – List of test names to search in report file. This is specified as positional arguments to buildtest inspect name

• pager (bool, optional) – Print output in paging format