Version: 1.8.x
Usage
Commands
Build-Version: v1.3.3
Build-Commit: c877d4fad959bff3c84a1800d345bf4f70f561ba
Build-Date: 2021-12-02
Any command not named in the list is passed directly to bazel (e.g. 'bzl build //...')
Usage:
bzl [command]
Available Commands:
auth manage credentials for the Bezel Cloud SDK
cache start the remote disk cache
code Bazel codesearch operations
debug Attach to a starlark debug server (EXPERIMENTAL)
help Help about any command
install Install a version of bazel
license Perform license operations
lsp Perform languange server protocol operations
release Print bzl release version
serve Serve the UI
use Repository rule generator (defaults to http_archive)
Flags:
-h, --help help for bzl
Use "bzl [command] --help" for more information about a command.
Bazelisk-like features
The bzl
cli works like bazelisk: it recognizes the USE_BAZEL_VERSION
environment variable as well as the .bazelversion
file.
Any command not recognized by the CLI is passed through to bazel itself, so you
can use it as a drop-in replacement for the bazel
frontend.
note
The "bazelisk" features actually predate bazelisk; it's not a copycat. The
original interpreted the environment variable BAZEL_VERSION
as well as the
file .bazelversion
. This (and the filesystem layout for storing artifacts)
was later changed to USE_BAZEL_VERSION
to be bazelisk-compatible.
Common Flags
--base_dir string base directory where bzl caches data (defaults to {USER_CACHE_DIR}/bzl)
--base_url string base URL where the HTTP service is running (optional, used for link generation)
--license_file string path to license.key (overrides canonical location ~/.bzl/license.key)
--license_token string license token (content of the license file
--log_level string optional log-level (debug|info|warn|trace) (default "info")
Configuration File
The bzl
tool borrows the bazelrc
format used by bazel.
The user $HOME/.bzlrc
file is parsed on startup.
For example, you can change the bind port by adding the following to your
$HOME/.bzlrc
file:
serve --address=localhost:8085