Helper methods for Starlark to access testing infrastructure.
Members
analysis_test
None
testing.analysis_test(name, implementation, attrs={}, fragments=[], toolchains=[], attr_values={})
The number of transitive dependencies of the test are limited. The limit is controlled by --analysis_testing_deps_limit
flag.
Parameters
Parameter | Description |
---|---|
name
|
string;
required Name of the target. It should be a Starlark identifier, matching pattern '[A-Za-z_][A-Za-z0-9_]*'. |
implementation
|
function;
required The Starlark function implementing this analysis test. It must have exactly one parameter: ctx. The function is called during the analysis phase. It can access the attributes declared by attrs and populated via attr_values . The implementation function may not register actions. Instead, it must register a pass/fail result via providing AnalysisTestResultInfo.
|
attrs
|
dict;
default is {} Dictionary declaring the attributes. See the rule call. Attributes are allowed to use configuration transitions defined using analysis_test_transition. |
fragments
|
sequence of strings;
default is [] List of configuration fragments that are available to the implementation of the analysis test. |
toolchains
|
sequence;
default is [] The set of toolchains the test requires. See the rule call. |
attr_values
|
dict of strings;
default is {} Dictionary of attribute values to pass to the implementation. |
ExecutionInfo
ExecutionInfo testing.ExecutionInfo
TestEnvironment
RunEnvironmentInfo testing.TestEnvironment(environment, inherited_environment=[])
Parameters
Parameter | Description |
---|---|
environment
|
dict;
required A map of string keys and values that represent environment variables and their values. These will be made available during the test execution. |
inherited_environment
|
sequence of strings;
default is [] A sequence of names of environment variables. These variables are made available during the test execution with their current value taken from the shell environment. If a variable is contained in both environment and inherited_environment , the value inherited from the shell environment will take precedence if set.
|