Bazel¶

Warning

This feature is experimental and subject to breaking changes. See the Conan stability section for more information.

The Bazel build helper is a wrapper around the command line invocation of bazel. It will abstract the calls like bazel <rcpaths> build <configs> <targets> into Python method calls.

The helper is intended to be used in the conanfile.py build() method, to call Bazel commands automatically when a package is being built directly by Conan (create, install)

from conan import ConanFile
from conan.tools.google import Bazel

class App(ConanFile):
    settings = "os", "arch", "compiler", "build_type"

    def build(self):
        bz = Bazel(self)
        bz.build(target="//main:hello-world")

Reference¶

class Bazel(conanfile)¶

Parameters:: conanfile – < ConanFile object > The current recipe object. Always use self.

build(args=None, target='//...', clean=True)¶

Runs “bazel <rcpaths> build <configs> <args> <targets>” command where:

rcpaths: adds --bazelrc=xxxx per rc-file path. It listens to BazelToolchain (--bazelrc=conan_bzl.rc), and tools.google.bazel:bazelrc_path conf.
configs: adds --config=xxxx per bazel-build configuration. It listens to BazelToolchain (--config=conan-config), and tools.google.bazel:configs conf.
args: they are any extra arguments to add to the bazel build execution.
targets: all the target labels.

Parameters:

target – It is the target label. By default, it’s “//…” which runs all the targets.
args – list of extra arguments to pass to the CLI.
clean – boolean that indicates to run a “bazel clean” before running the “bazel build”. Notice that this is important to ensure a fresh bazel cache every

test(target=None)¶: Runs “bazel test <targets>” command.

Properties¶

The following properties affect the Bazel build helper:

tools.build:skip_test=<bool> (boolean) if True, it runs the bazel test <target>.

conf¶

Bazel is affected by these [conf] variables:

tools.google.bazel:bazelrc_path: List of paths to other bazelrc files to be used as bazel --bazelrc=rcpath1 ... build.
tools.google.bazel:configs: List of Bazel configurations to be used as bazel build --config=config1 ....