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[, 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
inspect_list(report[, terse, header, builder, color])	This method list an output of test id, name, and buildspec file from the report cache. The default
inspect_query(report, args)	Entry point for buildtest inspect query command.
inspect_buildspec(report, input_buildspecs, all_records)	This method implements command buildtest inspect buildspec
inspect_by_name(report, names)	Implements command buildtest inspect name which will print all test records by given name in JSON format.

buildtest.cli.inspect.inspect_cmd(args, 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.inspect_list(report, terse=None, header=None, builder=None, color=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

• 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

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

Entry point for buildtest inspect query command.

Parameters

• args (dict) –

  Parsed arguments from ArgumentParser.parse_args

• report (str) – Path to report file

buildtest.cli.inspect.inspect_buildspec(report, input_buildspecs, all_records)

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.

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

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