2
0
Fork 0
mirror of https://github.com/bazelbuild/bazel-skylib synced 2024-11-27 05:43:25 +00:00
bazel-skylib/docs/analysis_test_doc.md
Alexandre Rostovtsev 99ffbbf8a4
Prepare release 1.6.0 (#496)
And take the opportunity to reformat docs using a more modern Stardoc release
2024-04-24 17:40:06 -04:00

1.7 KiB
Executable file

A test verifying other targets can be successfully analyzed as part of a bazel test

analysis_test

analysis_test(name, targets)

Test rule checking that other targets can be successfully analyzed.

This rule essentially verifies that all targets under targets would generate no errors when analyzed with bazel build [targets] --nobuild. Action success/failure for the targets and their transitive dependencies are not verified. An analysis test simply ensures that each target in the transitive dependencies propagate providers appropriately and register actions for their outputs appropriately.

NOTE: If the targets fail to analyze, instead of the analysis_test failing, the analysis_test will fail to build. Ideally, it would instead result in a test failure. This is a current infrastructure limitation that may be fixed in the future.

Typical usage:

load("@bazel_skylib//rules:analysis_test.bzl", "analysis_test") analysis_test( name = "my_analysis_test", targets = [ "//some/package:rule", ], )

Args: name: The name of the test rule. targets: A list of targets to ensure build.

ATTRIBUTES

Name Description Type Mandatory Default
name A unique name for this target. Name required
targets - List of labels required