This repository provides rules for building Rust projects with Bazel.
To use the Rust rules, add the following to your WORKSPACE
file to add the external repositories for the Rust toolchain:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive") http_archive( name = "rules_rust", sha256 = "18c0a02a007cd26c3f5b4d21dc26a80af776ef755460028a796bc61c649fdf3f", strip_prefix = "rules_rust-467a301fd665db344803c1d8a2401ec2bf8c74ce", urls = [ # Master branch as of 2021-04-23 "https://github.com/bazelbuild/rules_rust/archive/467a301fd665db344803c1d8a2401ec2bf8c74ce.tar.gz", ], ) load("@rules_rust//rust:repositories.bzl", "rust_repositories") rust_repositories()
The rules are under active development, as such the lastest commit on the main
branch should be used. main
is only tested against 3.5.0
as the minimum supported version of Bazel. Though previous versions may still be supported in certain environments.
build.rs
script from Bazel.You can also browse the full API in one page.
rust-project.json
files for rust-analyzerTo build with a particular version of the Rust compiler, pass that version to rust_repositories
:
rust_repositories(version = "1.52.0", edition="2018")
As well as an exact version, version
can be set to "nightly"
or "beta"
. If set to these values, iso_date
must also be set:
rust_repositories(version = "nightly", iso_date = "2020-12-30", edition="2018")
Similarly, rustfmt_version
may also be configured:
rust_repositories(rustfmt_version = "1.52.0")
Currently, the most common approach to managing external dependencies is using cargo-raze to generate BUILD
files for Cargo crates.