testing

Helper methods for Starlark to access testing infrastructure.

Members

analysis_test
ExecutionInfo
TestEnvironment

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

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

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

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.

Concepts

Writing rules

Distributing rules

Platforms & toolchains

API Reference Overview

Starlark Builtins

Core Types

Providers

Global Functions

Configuration Fragments

Toplevel APIs

Repo rules

Module system

Members

analysis_test

Parameters

ExecutionInfo

TestEnvironment

Parameters

​Members

​analysis_test

​Parameters

​ExecutionInfo

​TestEnvironment

​Parameters

Members

analysis_test

Parameters

ExecutionInfo

TestEnvironment

Parameters