Skip to main content
Helper methods for Starlark to access testing infrastructure.

​
Members

​
analysis_test

None testing.analysis_test(name, implementation, attrs={}, fragments=[], toolchains=[], attr_values={})
Creates a new analysis test target. The number of transitive dependencies of the test are limited. The limit is controlled by --analysis_testing_deps_limit flag.

​
Parameters

ParameterDescriptionnamestring; required Name of the target. It should be a Starlark identifier, matching pattern ‘[A-Za-z_][A-Za-z0-9_]*’. implementationfunction; 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. attrsdict; default is {} Dictionary declaring the attributes. See the rule call. Attributes are allowed to use configuration transitions defined using analysis_test_transition. fragmentssequence of string s; default is [] List of configuration fragments that are available to the implementation of the analysis test. toolchainssequence; default is [] The set of toolchains the test requires. See the rule call. attr_valuesdict of string s; default is {} Dictionary of attribute values to pass to the implementation.

​
ExecutionInfo

ExecutionInfo testing.ExecutionInfo
testing.ExecutionInfo provider key/constructor

​
TestEnvironment

RunEnvironmentInfo testing.TestEnvironment(environment, inherited_environment=[])
Deprecated: Use RunEnvironmentInfo instead. Creates a new test environment provider. Use this provider to specify extra environment variables to be made available during test execution.

​
Parameters

ParameterDescriptionenvironmentdict; 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_environmentsequence of string s; 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.