1 # [Rules rust](https://github.com/bazelbuild/rules_rust)
5 This repository provides rules for building [Rust][rust] projects with [Bazel][bazel].
7 [bazel]: https://bazel.build/
8 [rust]: http://www.rust-lang.org/
10 <!-- TODO: Render generated docs on the github pages site again, https://bazelbuild.github.io/rules…
16 To use the Rust rules, add the following to your `WORKSPACE` file to add the external repositories …
26 …urls = ["https://github.com/bazelbuild/rules_rust/releases/download/0.31.0/rules_rust-v0.31.0.tar.…
36 The rules are released, and releases can be found on [the GitHub Releases page](https://github.com/…
38 ## Rules  section in [Rules rust](https://github.com/bazelbuild/rules_rust)
40 - [defs](defs.md): standard rust rules for building and testing libraries and binaries.
41 - [rust_doc](rust_doc.md): rules for generating and testing rust documentation.
42 - [rust_clippy](rust_clippy.md): rules for running [clippy](https://github.com/rust-lang/rust-clipp…
43 - [rust_fmt](rust_fmt.md): rules for running [rustfmt](https://github.com/rust-lang/rustfmt#readme).
44 - [rust_proto](rust_proto.md): rules for generating [protobuf](https://developers.google.com/protoc…
45 - [rust_bindgen](rust_bindgen.md): rules for generating C++ bindings.
46 - [rust_wasm_bindgen](rust_wasm_bindgen.md): rules for generating [WebAssembly](https://www.rust-la…
47 - [cargo](cargo.md): Rules dedicated to Cargo compatibility. ie: [`build.rs` scripts](https://doc.r…
48 - [crate_universe](crate_universe.md): Rules for generating Bazel targets for external crate depend…
52 ### Experimental rules
54 - [rust_analyzer](rust_analyzer.md): rules for generating `rust-project.json` files for [rust-analy…
58 To build with a particular version of the Rust compiler, pass that version to [`rust_register_toolc…
75         "nightly/2022-12-15",
81 …is from the `nightly` or `beta` release channels (i.e. __not__ `stable`), then a build setting must
85 build --@rules_rust//rust/toolchain/channel=nightly
88 Failure to do so will result in rules attempting to match a `stable` toolchain when one was not reg…
92 …d to fetch dependencies. Additionally, [cargo-raze](https://github.com/google/cargo-raze) is an ol…
98 We test these rules against the latest rolling releases of Bazel, and aim for compatibility with th…
106 …--enable_runfiles` to be passed to Bazel, we recommend putting it in your bazelrc. See [Using Baze…