<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>docs/flatten.md - fork/rules_rust @ 0.7.0</title>
<meta name="description" content="docs/flatten.md in fork/rules_rust at 0.7.0.">
<meta property="og:title" content="docs/flatten.md - fork/rules_rust @ 0.7.0">
<meta property="og:description" content="docs/flatten.md in fork/rules_rust at 0.7.0.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="0.7.0" data-tip="389c58fcb1d8d56c12311e0b6d28dfbdf82c2305">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/rules_rust</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/rules_rust</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Krasimir Georgiev</span><span class="commit-message" data-commit="da75146d0a753ef3618279af7e78803573f0aeca">Do not attempt to instrument rust code for coverage if rust_toolchain.llvm-cov is None (#1432)</span><span class="snapshot-sha sha" data-commit="da75146d0a753ef3618279af7e78803573f0aeca">da75146d</span><time datetime="2022-07-05T16:56:52+02:00" title="2022-07-05 16:56:52 +0200">2022-07-05</time></p>
<header class="topbar"><details class="switcher"><summary>0.7.0</summary><div class="menu"><strong>branches</strong><a href="/fork/rules_rust/ref/cleanup/">cleanup</a><a href="/fork/rules_rust/ref/gh-pages/">gh-pages</a><a href="/fork/rules_rust/ref/main/">main</a><a href="/fork/rules_rust/ref/patching/">patching</a><a href="/fork/rules_rust/ref/rust-analyzer/">rust-analyzer</a><strong>tags</strong><a href="/fork/rules_rust/ref/0.10.0/">0.10.0</a><a href="/fork/rules_rust/ref/0.11.0/">0.11.0</a><a href="/fork/rules_rust/ref/0.5.0/">0.5.0</a><a href="/fork/rules_rust/ref/0.6.0/">0.6.0</a><a class="current" href="/fork/rules_rust/ref/0.7.0/">0.7.0</a><a href="/fork/rules_rust/ref/0.8.0/">0.8.0</a><a href="/fork/rules_rust/ref/0.8.1/">0.8.1</a><a href="/fork/rules_rust/ref/0.9.0/">0.9.0</a><a class="all" href="/fork/rules_rust/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/rules_rust/">rules_rust</a> / <a href="/fork/rules_rust/ref/0.7.0/tree/docs/">docs</a> / <span class="cur">flatten.md</span></nav>
<span class="view-stats"><span>133.2 KiB</span><span>1937 lines</span></span><span class="actions"><a class="raw" href="/fork/rules_rust/raw/12c4d415775938e58a774362042204adcbf662ec/docs/flatten.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><h1>Rust rules</h1>
<ul>
<li><a href="#CrateInfo">CrateInfo</a></li>
<li><a href="#DepInfo">DepInfo</a></li>
<li><a href="#StdLibInfo">StdLibInfo</a></li>
<li><a href="#capture_clippy_output">capture_clippy_output</a></li>
<li><a href="#cargo_bootstrap_repository">cargo_bootstrap_repository</a></li>
<li><a href="#cargo_build_script">cargo_build_script</a></li>
<li><a href="#cargo_env">cargo_env</a></li>
<li><a href="#error_format">error_format</a></li>
<li><a href="#extra_rustc_flags">extra_rustc_flags</a></li>
<li><a href="#fail_when_enabled">fail_when_enabled</a></li>
<li><a href="#incompatible_flag">incompatible_flag</a></li>
<li><a href="#rules_rust_dependencies">rules_rust_dependencies</a></li>
<li><a href="#rust_analyzer_aspect">rust_analyzer_aspect</a></li>
<li><a href="#rust_binary">rust_binary</a></li>
<li><a href="#rust_bindgen">rust_bindgen</a></li>
<li><a href="#rust_bindgen_dependencies">rust_bindgen_dependencies</a></li>
<li><a href="#rust_bindgen_library">rust_bindgen_library</a></li>
<li><a href="#rust_bindgen_register_toolchains">rust_bindgen_register_toolchains</a></li>
<li><a href="#rust_bindgen_toolchain">rust_bindgen_toolchain</a></li>
<li><a href="#rust_clippy">rust_clippy</a></li>
<li><a href="#rust_clippy_aspect">rust_clippy_aspect</a></li>
<li><a href="#rust_doc">rust_doc</a></li>
<li><a href="#rust_doc_test">rust_doc_test</a></li>
<li><a href="#rust_grpc_library">rust_grpc_library</a></li>
<li><a href="#rust_library">rust_library</a></li>
<li><a href="#rust_proc_macro">rust_proc_macro</a></li>
<li><a href="#rust_proto_library">rust_proto_library</a></li>
<li><a href="#rust_proto_repositories">rust_proto_repositories</a></li>
<li><a href="#rust_proto_toolchain">rust_proto_toolchain</a></li>
<li><a href="#rust_proto_transitive_repositories">rust_proto_transitive_repositories</a></li>
<li><a href="#rust_register_toolchains">rust_register_toolchains</a></li>
<li><a href="#rust_repositories">rust_repositories</a></li>
<li><a href="#rust_repository_set">rust_repository_set</a></li>
<li><a href="#rust_shared_library">rust_shared_library</a></li>
<li><a href="#rust_static_library">rust_static_library</a></li>
<li><a href="#rust_stdlib_filegroup">rust_stdlib_filegroup</a></li>
<li><a href="#rust_test">rust_test</a></li>
<li><a href="#rust_test_suite">rust_test_suite</a></li>
<li><a href="#rust_toolchain">rust_toolchain</a></li>
<li><a href="#rust_toolchain_repository">rust_toolchain_repository</a></li>
<li><a href="#rust_toolchain_repository_proxy">rust_toolchain_repository_proxy</a></li>
<li><a href="#rust_wasm_bindgen">rust_wasm_bindgen</a></li>
<li><a href="#rust_wasm_bindgen_dependencies">rust_wasm_bindgen_dependencies</a></li>
<li><a href="#rust_wasm_bindgen_register_toolchains">rust_wasm_bindgen_register_toolchains</a></li>
<li><a href="#rust_wasm_bindgen_toolchain">rust_wasm_bindgen_toolchain</a></li>
<li><a href="#rustfmt_aspect">rustfmt_aspect</a></li>
<li><a href="#rustfmt_test">rustfmt_test</a></li>
</ul>
<p>&lt;a id="#capture_clippy_output"&gt;&lt;/a&gt;</p>
<h2>capture_clippy_output</h2>
&lt;pre&gt;
capture_clippy_output(&lt;a href="#capture_clippy_output-name"&gt;name&lt;/a&gt;)
&lt;/pre&gt;
<p>Control whether to print clippy output or store it to a file, using the configured error_format.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="capture_clippy_output-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
<p>&lt;a id="#cargo_bootstrap_repository"&gt;&lt;/a&gt;</p>
<h2>cargo_bootstrap_repository</h2>
&lt;pre&gt;
cargo_bootstrap_repository(&lt;a href="#cargo_bootstrap_repository-name"&gt;name&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-binary"&gt;binary&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-build_mode"&gt;build_mode&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-cargo_lockfile"&gt;cargo_lockfile&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-cargo_toml"&gt;cargo_toml&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-env"&gt;env&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-env_label"&gt;env_label&lt;/a&gt;,
                           &lt;a href="#cargo_bootstrap_repository-iso_date"&gt;iso_date&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-repo_mapping"&gt;repo_mapping&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-rust_toolchain_cargo_template"&gt;rust_toolchain_cargo_template&lt;/a&gt;,
                           &lt;a href="#cargo_bootstrap_repository-rust_toolchain_repository_template"&gt;rust_toolchain_repository_template&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-rust_toolchain_rustc_template"&gt;rust_toolchain_rustc_template&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-srcs"&gt;srcs&lt;/a&gt;,
                           &lt;a href="#cargo_bootstrap_repository-timeout"&gt;timeout&lt;/a&gt;, &lt;a href="#cargo_bootstrap_repository-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>A rule for bootstrapping a Rust binary using <a href="https://doc.rust-lang.org/cargo/">Cargo</a></p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this repository.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-binary"&gt;&lt;/a&gt;binary</td><td style="text-align: left">The binary to build (the &lt;code&gt;--bin&lt;/code&gt; parameter for Cargo). If left empty, the repository name will be used.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-build_mode"&gt;&lt;/a&gt;build_mode</td><td style="text-align: left">The build mode the binary should be built with</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"release"</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-cargo_lockfile"&gt;&lt;/a&gt;cargo_lockfile</td><td style="text-align: left">The lockfile of the crate_universe resolver</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-cargo_toml"&gt;&lt;/a&gt;cargo_toml</td><td style="text-align: left">The path of the crate_universe resolver manifest (&lt;code&gt;Cargo.toml&lt;/code&gt; file)</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-env"&gt;&lt;/a&gt;env</td><td style="text-align: left">A mapping of platform triple to a set of environment variables. See <a href="#cargo_env">cargo_env</a> for usage details. Additionally, the platform triple &lt;code&gt;*&lt;/code&gt; applies to all platforms.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-env_label"&gt;&lt;/a&gt;env_label</td><td style="text-align: left">A mapping of platform triple to a set of environment variables. This attribute differs from &lt;code&gt;env&lt;/code&gt; in that all variables passed here must be fully qualified labels of files. See <a href="#cargo_env">cargo_env</a> for usage details. Additionally, the platform triple &lt;code&gt;*&lt;/code&gt; applies to all platforms.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-iso_date"&gt;&lt;/a&gt;iso_date</td><td style="text-align: left">The iso_date of cargo binary the resolver should use. Note: This can only be set if &lt;code&gt;version&lt;/code&gt; is &lt;code&gt;beta&lt;/code&gt; or &lt;code&gt;nightly&lt;/code&gt;</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-repo_mapping"&gt;&lt;/a&gt;repo_mapping</td><td style="text-align: left">A dictionary from local repository name to global repository name. This allows controls over workspace dependency resolution for dependencies of this repository.&lt;p&gt;For example, an entry &lt;code&gt;"@foo": "@bar"&lt;/code&gt; declares that, for any time this repository depends on &lt;code&gt;@foo&lt;/code&gt; (such as a dependency on &lt;code&gt;@foo//some:target&lt;/code&gt;, it should actually resolve that dependency within globally-declared &lt;code&gt;@bar&lt;/code&gt; (&lt;code&gt;@bar//some:target&lt;/code&gt;).</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-rust_toolchain_cargo_template"&gt;&lt;/a&gt;rust_toolchain_cargo_template</td><td style="text-align: left">The template to use for finding the host &lt;code&gt;cargo&lt;/code&gt; binary. &lt;code&gt;{version}&lt;/code&gt; (eg. '1.53.0'), &lt;code&gt;{triple}&lt;/code&gt; (eg. 'x86_64-unknown-linux-gnu'), &lt;code&gt;{arch}&lt;/code&gt; (eg. 'aarch64'), &lt;code&gt;{vendor}&lt;/code&gt; (eg. 'unknown'), &lt;code&gt;{system}&lt;/code&gt; (eg. 'darwin'), and &lt;code&gt;{tool}&lt;/code&gt; (eg. 'rustc.exe') will be replaced in the string if present.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"@rust_{system}_{arch}//:bin/{tool}"</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-rust_toolchain_repository_template"&gt;&lt;/a&gt;rust_toolchain_repository_template</td><td style="text-align: left"><strong>Deprecated</strong>: Please use &lt;code&gt;rust_toolchain_cargo_template&lt;/code&gt; and &lt;code&gt;rust_toolchain_rustc_template&lt;/code&gt;</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-rust_toolchain_rustc_template"&gt;&lt;/a&gt;rust_toolchain_rustc_template</td><td style="text-align: left">The template to use for finding the host &lt;code&gt;rustc&lt;/code&gt; binary. &lt;code&gt;{version}&lt;/code&gt; (eg. '1.53.0'), &lt;code&gt;{triple}&lt;/code&gt; (eg. 'x86_64-unknown-linux-gnu'), &lt;code&gt;{arch}&lt;/code&gt; (eg. 'aarch64'), &lt;code&gt;{vendor}&lt;/code&gt; (eg. 'unknown'), &lt;code&gt;{system}&lt;/code&gt; (eg. 'darwin'), and &lt;code&gt;{tool}&lt;/code&gt; (eg. 'rustc.exe') will be replaced in the string if present.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"@rust_{system}_{arch}//:bin/{tool}"</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">Souce files of the crate to build. Passing source files here can be used to trigger rebuilds when changes are made</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-timeout"&gt;&lt;/a&gt;timeout</td><td style="text-align: left">Maximum duration of the Cargo build command in seconds</td><td style="text-align: left">Integer</td><td style="text-align: left">optional</td><td style="text-align: left">600</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_bootstrap_repository-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">The version of cargo the resolver should use</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"1.62.0"</td></tr>
</tbody></table>
<p>&lt;a id="#error_format"&gt;&lt;/a&gt;</p>
<h2>error_format</h2>
&lt;pre&gt;
error_format(&lt;a href="#error_format-name"&gt;name&lt;/a&gt;)
&lt;/pre&gt;
<p>Change the <a href="https://doc.rust-lang.org/rustc/command-line-arguments.html#option-error-format">--error-format</a> flag from the command line with <code>--@rules_rust//:error_format</code>. See rustc documentation for valid values.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="error_format-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
<p>&lt;a id="#extra_rustc_flags"&gt;&lt;/a&gt;</p>
<h2>extra_rustc_flags</h2>
&lt;pre&gt;
extra_rustc_flags(&lt;a href="#extra_rustc_flags-name"&gt;name&lt;/a&gt;)
&lt;/pre&gt;
<p>Add additional rustc_flags from the command line with <code>--@rules_rust//:extra_rustc_flags</code>. This flag should only be used for flags that need to be applied across the entire build. For options that apply to individual crates, use the rustc_flags attribute on the individual crate's rule instead. NOTE: These flags not applied to the exec configuration (proc-macros, cargo_build_script, etc); use <code>--@rules_rust//:extra_exec_rustc_flags</code> to apply flags to the exec configuration.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="extra_rustc_flags-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
<p>&lt;a id="#incompatible_flag"&gt;&lt;/a&gt;</p>
<h2>incompatible_flag</h2>
&lt;pre&gt;
incompatible_flag(&lt;a href="#incompatible_flag-name"&gt;name&lt;/a&gt;, &lt;a href="#incompatible_flag-issue"&gt;issue&lt;/a&gt;)
&lt;/pre&gt;
<p>A rule defining an incompatible flag.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="incompatible_flag-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="incompatible_flag-issue"&gt;&lt;/a&gt;issue</td><td style="text-align: left">The link to the github issue associated with this flag</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
<p>&lt;a id="#rust_binary"&gt;&lt;/a&gt;</p>
<h2>rust_binary</h2>
&lt;pre&gt;
rust_binary(&lt;a href="#rust_binary-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_binary-aliases"&gt;aliases&lt;/a&gt;, &lt;a href="#rust_binary-compile_data"&gt;compile_data&lt;/a&gt;, &lt;a href="#rust_binary-crate_features"&gt;crate_features&lt;/a&gt;, &lt;a href="#rust_binary-crate_name"&gt;crate_name&lt;/a&gt;, &lt;a href="#rust_binary-crate_root"&gt;crate_root&lt;/a&gt;, &lt;a href="#rust_binary-crate_type"&gt;crate_type&lt;/a&gt;, &lt;a href="#rust_binary-data"&gt;data&lt;/a&gt;,
            &lt;a href="#rust_binary-deps"&gt;deps&lt;/a&gt;, &lt;a href="#rust_binary-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_binary-linker_script"&gt;linker_script&lt;/a&gt;, &lt;a href="#rust_binary-out_binary"&gt;out_binary&lt;/a&gt;, &lt;a href="#rust_binary-proc_macro_deps"&gt;proc_macro_deps&lt;/a&gt;, &lt;a href="#rust_binary-rustc_env"&gt;rustc_env&lt;/a&gt;, &lt;a href="#rust_binary-rustc_env_files"&gt;rustc_env_files&lt;/a&gt;,
            &lt;a href="#rust_binary-rustc_flags"&gt;rustc_flags&lt;/a&gt;, &lt;a href="#rust_binary-srcs"&gt;srcs&lt;/a&gt;, &lt;a href="#rust_binary-stamp"&gt;stamp&lt;/a&gt;, &lt;a href="#rust_binary-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>Builds a Rust binary crate.</p>
<p>Example:</p>
<p>Suppose you have the following directory structure for a Rust project with a
library crate, <code>hello_lib</code>, and a binary crate, <code>hello_world</code> that uses the
<code>hello_lib</code> library:</p>
<pre>[workspace]/
    WORKSPACE
    hello_lib/
        BUILD
        src/
            lib.rs
    hello_world/
        BUILD
        src/
            main.rs
</pre>
<p><code>hello_lib/src/lib.rs</code>:</p>
<pre class="language-rust"><a-k>pub</a-k> <a-k>struct</a-k> <a-t>Greeter</a-t> <a-p>{</a-p>
    <a-pr>greeting</a-pr><a-p>:</a-p> <a-t>String</a-t><a-p>,</a-p>
<a-p>}</a-p>

<a-k>impl</a-k> <a-t>Greeter</a-t> <a-p>{</a-p>
    <a-k>pub</a-k> <a-k>fn</a-k> <a-f>new</a-f><a-p>(</a-p><a-v>greeting</a-v><a-p>:</a-p> <a-o>&amp;</a-o><a-t>str</a-t><a-p>)</a-p> -&gt; <a-t>Greeter</a-t> <a-p>{</a-p>
        <a-t>Greeter</a-t> <a-p>{</a-p> <a-pr>greeting</a-pr><a-p>:</a-p> greeting<a-p>.</a-p><a-f>to_string</a-f><a-p>(),</a-p> <a-p>}</a-p>
    <a-p>}</a-p>

    <a-k>pub</a-k> <a-k>fn</a-k> <a-f>greet</a-f><a-p>(</a-p><a-o>&amp;</a-o><a-v>self</a-v><a-p>,</a-p> <a-v>thing</a-v><a-p>:</a-p> <a-o>&amp;</a-o><a-t>str</a-t><a-p>)</a-p> <a-p>{</a-p>
        <a-m>println!</a-m><a-p>(</a-p><a-s>&quot;{} {}&quot;</a-s><a-p>,</a-p> <a-o>&amp;</a-o><a-v>self</a-v><a-p>.</a-p><a-pr>greeting</a-pr><a-p>,</a-p> thing<a-p>);</a-p>
    <a-p>}</a-p>
<a-p>}</a-p></pre>
<p><code>hello_lib/BUILD</code>:</p>
<pre class="language-python"><a-f>package</a-f>(<a-v>default_visibility</a-v> <a-o>=</a-o> [<a-s>&quot;//visibility:public&quot;</a-s>])

<a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/lib.rs&quot;</a-s>],
)</pre>
<p><code>hello_world/src/main.rs</code>:</p>
<pre class="language-rust"><a-k>extern</a-k> <a-k>crate</a-k> hello_lib<a-p>;</a-p>

<a-k>fn</a-k> <a-f>main</a-f><a-p>()</a-p> <a-p>{</a-p>
    <a-k>let</a-k> hello = hello_lib<a-p>::</a-p><a-t>Greeter</a-t><a-p>::</a-p><a-f>new</a-f><a-p>(</a-p><a-s>&quot;Hello&quot;</a-s><a-p>);</a-p>
    hello<a-p>.</a-p><a-f>greet</a-f><a-p>(</a-p><a-s>&quot;world&quot;</a-s><a-p>);</a-p>
<a-p>}</a-p></pre>
<p><code>hello_world/BUILD</code>:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_binary&quot;</a-s>)

<a-f>rust_binary</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_world&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/main.rs&quot;</a-s>],
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;//hello_lib&quot;</a-s>],
)</pre>
<p>Build and run <code>hello_world</code>:</p>
<pre>$ bazel run //hello_world
INFO: Found 1 target...
Target //examples/rust/hello_world:hello_world up-to-date:
bazel-bin/examples/rust/hello_world/hello_world
INFO: Elapsed time: 1.308s, Critical Path: 1.22s

INFO: Running command line: bazel-bin/examples/rust/hello_world/hello_world
Hello world
</pre>
<p>On Windows, a PDB file containing debugging information is available under
the key <code>pdb_file</code> in <code>OutputGroupInfo</code>. Similarly on macOS, a dSYM folder
is available under the key <code>dsym_folder</code> in <code>OutputGroupInfo</code>.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_binary-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-aliases"&gt;&lt;/a&gt;aliases</td><td style="text-align: left">Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: Label -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-compile_data"&gt;&lt;/a&gt;compile_data</td><td style="text-align: left">List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the <a href="https://doc.rust-lang.org/std/macro.include_str!.html">&lt;code&gt;include_str!&lt;/code&gt;</a> macro.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-crate_features"&gt;&lt;/a&gt;crate_features</td><td style="text-align: left">List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = "foo")]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature="${feature_name}"&lt;/code&gt; flags.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-crate_name"&gt;&lt;/a&gt;crate_name</td><td style="text-align: left">Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-crate_root"&gt;&lt;/a&gt;crate_root</td><td style="text-align: left">The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-crate_type"&gt;&lt;/a&gt;crate_type</td><td style="text-align: left">Crate type that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;This option is a temporary workaround and should be used only when building for WebAssembly targets (//rust/platform:wasi and //rust/platform:wasm).</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"bin"</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-data"&gt;&lt;/a&gt;data</td><td style="text-align: left">List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-linker_script"&gt;&lt;/a&gt;linker_script</td><td style="text-align: left">Link script to forward into linker via rustc options.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-out_binary"&gt;&lt;/a&gt;out_binary</td><td style="text-align: left">Force a target, regardless of it's &lt;code&gt;crate_type&lt;/code&gt;, to always mark the file as executable. This attribute is only used to support wasm targets but is expected to be removed following a resolution to https://github.com/bazelbuild/rules_rust/issues/771.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left">False</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-proc_macro_deps"&gt;&lt;/a&gt;proc_macro_deps</td><td style="text-align: left">List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-rustc_env"&gt;&lt;/a&gt;rustc_env</td><td style="text-align: left">Dictionary of additional &lt;code&gt;"key": "value"&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-rustc_env_files"&gt;&lt;/a&gt;rustc_env_files</td><td style="text-align: left">Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to <a href="https://docs.bazel.build/versions/main/user-manual.html#workspace_status">workspace status</a> stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-rustc_flags"&gt;&lt;/a&gt;rustc_flags</td><td style="text-align: left">List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-stamp"&gt;&lt;/a&gt;stamp</td><td style="text-align: left">Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--nostamp</a> builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--[no]stamp</a> flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won't be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how <a href="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp">&lt;code&gt;cc_library.linkstamps&lt;/code&gt;</a> behaves.</td><td style="text-align: left">Integer</td><td style="text-align: left">optional</td><td style="text-align: left">-1</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_binary-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">A version to inject in the cargo environment variable.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"0.0.0"</td></tr>
</tbody></table>
<p>&lt;a id="#rust_bindgen"&gt;&lt;/a&gt;</p>
<h2>rust_bindgen</h2>
&lt;pre&gt;
rust_bindgen(&lt;a href="#rust_bindgen-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_bindgen-bindgen_flags"&gt;bindgen_flags&lt;/a&gt;, &lt;a href="#rust_bindgen-cc_lib"&gt;cc_lib&lt;/a&gt;, &lt;a href="#rust_bindgen-clang_flags"&gt;clang_flags&lt;/a&gt;, &lt;a href="#rust_bindgen-header"&gt;header&lt;/a&gt;, &lt;a href="#rust_bindgen-rustfmt"&gt;rustfmt&lt;/a&gt;)
&lt;/pre&gt;
<p>Generates a rust source file from a cc_library and a header.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_bindgen-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen-bindgen_flags"&gt;&lt;/a&gt;bindgen_flags</td><td style="text-align: left">Flags to pass directly to the bindgen executable. See https://rust-lang.github.io/rust-bindgen/ for details.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen-cc_lib"&gt;&lt;/a&gt;cc_lib</td><td style="text-align: left">The cc_library that contains the &lt;code&gt;.h&lt;/code&gt; file. This is used to find the transitive includes.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen-clang_flags"&gt;&lt;/a&gt;clang_flags</td><td style="text-align: left">Flags to pass directly to the clang executable.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen-header"&gt;&lt;/a&gt;header</td><td style="text-align: left">The &lt;code&gt;.h&lt;/code&gt; file to generate bindings for.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen-rustfmt"&gt;&lt;/a&gt;rustfmt</td><td style="text-align: left">Enable or disable running rustfmt on the generated file.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left">True</td></tr>
</tbody></table>
<p>&lt;a id="#rust_bindgen_toolchain"&gt;&lt;/a&gt;</p>
<h2>rust_bindgen_toolchain</h2>
&lt;pre&gt;
rust_bindgen_toolchain(&lt;a href="#rust_bindgen_toolchain-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_bindgen_toolchain-bindgen"&gt;bindgen&lt;/a&gt;, &lt;a href="#rust_bindgen_toolchain-clang"&gt;clang&lt;/a&gt;, &lt;a href="#rust_bindgen_toolchain-libclang"&gt;libclang&lt;/a&gt;, &lt;a href="#rust_bindgen_toolchain-libstdcxx"&gt;libstdcxx&lt;/a&gt;, &lt;a href="#rust_bindgen_toolchain-rustfmt"&gt;rustfmt&lt;/a&gt;)
&lt;/pre&gt;
<p>The tools required for the <code>rust_bindgen</code> rule.</p>
<p>This rule depends on the <a href="https://crates.io/crates/bindgen"><code>bindgen</code></a> binary crate, and it
in turn depends on both a clang binary and the clang library. To obtain these dependencies,
<code>rust_bindgen_dependencies</code> imports bindgen and its dependencies.</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//bindgen:bindgen.bzl&quot;</a-s>, <a-s>&quot;rust_bindgen_toolchain&quot;</a-s>)

<a-f>rust_bindgen_toolchain</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;bindgen_toolchain_impl&quot;</a-s>,
    <a-v>bindgen</a-v> <a-o>=</a-o> <a-s>&quot;//my/rust:bindgen&quot;</a-s>,
    <a-v>clang</a-v> <a-o>=</a-o> <a-s>&quot;//my/clang:clang&quot;</a-s>,
    <a-v>libclang</a-v> <a-o>=</a-o> <a-s>&quot;//my/clang:libclang.so&quot;</a-s>,
    <a-v>libstdcxx</a-v> <a-o>=</a-o> <a-s>&quot;//my/cpp:libstdc++&quot;</a-s>,
)

<a-f>toolchain</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;bindgen_toolchain&quot;</a-s>,
    <a-v>toolchain</a-v> <a-o>=</a-o> <a-s>&quot;bindgen_toolchain_impl&quot;</a-s>,
    <a-v>toolchain_type</a-v> <a-o>=</a-o> <a-s>&quot;@rules_rust//bindgen:bindgen_toolchain&quot;</a-s>,
)</pre>
<p>This toolchain will then need to be registered in the current <code>WORKSPACE</code>.
For additional information, see the <a href="https://docs.bazel.build/versions/master/toolchains.html">Bazel toolchains documentation</a>.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_toolchain-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_toolchain-bindgen"&gt;&lt;/a&gt;bindgen</td><td style="text-align: left">The label of a &lt;code&gt;bindgen&lt;/code&gt; executable.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_toolchain-clang"&gt;&lt;/a&gt;clang</td><td style="text-align: left">The label of a &lt;code&gt;clang&lt;/code&gt; executable.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_toolchain-libclang"&gt;&lt;/a&gt;libclang</td><td style="text-align: left">A cc_library that provides bindgen's runtime dependency on libclang.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_toolchain-libstdcxx"&gt;&lt;/a&gt;libstdcxx</td><td style="text-align: left">A cc_library that satisfies libclang's libstdc++ dependency. This is used to make the execution of clang hermetic. If None, system libraries will be used instead.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_toolchain-rustfmt"&gt;&lt;/a&gt;rustfmt</td><td style="text-align: left">The label of a &lt;code&gt;rustfmt&lt;/code&gt; executable. If this is not provided, falls back to the rust_toolchain rustfmt.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
</tbody></table>
<p>&lt;a id="#rust_clippy"&gt;&lt;/a&gt;</p>
<h2>rust_clippy</h2>
&lt;pre&gt;
rust_clippy(&lt;a href="#rust_clippy-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_clippy-deps"&gt;deps&lt;/a&gt;)
&lt;/pre&gt;
<p>Executes the clippy checker on a specific target.</p>
<p>Similar to <code>rust_clippy_aspect</code>, but allows specifying a list of dependencies within the build system.</p>
<p>For example, given the following example targets:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>, <a-s>&quot;rust_test&quot;</a-s>)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/lib.rs&quot;</a-s>],
)

<a-f>rust_test</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;greeting_test&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;tests/greeting.rs&quot;</a-s>],
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;:hello_lib&quot;</a-s>],
)</pre>
<p>Rust clippy can be set as a build target with the following:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_clippy&quot;</a-s>)

<a-f>rust_clippy</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_library_clippy&quot;</a-s>,
    <a-v>testonly</a-v> <a-o>=</a-o> <a-co>True</a-co>,
    <a-v>deps</a-v> <a-o>=</a-o> [
        <a-s>&quot;:hello_lib&quot;</a-s>,
        <a-s>&quot;:greeting_test&quot;</a-s>,
    ],
)</pre>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_clippy-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_clippy-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">Rust targets to run clippy on.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
</tbody></table>
<p>&lt;a id="#rust_doc"&gt;&lt;/a&gt;</p>
<h2>rust_doc</h2>
&lt;pre&gt;
rust_doc(&lt;a href="#rust_doc-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_doc-crate"&gt;crate&lt;/a&gt;, &lt;a href="#rust_doc-html_after_content"&gt;html_after_content&lt;/a&gt;, &lt;a href="#rust_doc-html_before_content"&gt;html_before_content&lt;/a&gt;, &lt;a href="#rust_doc-html_in_header"&gt;html_in_header&lt;/a&gt;, &lt;a href="#rust_doc-markdown_css"&gt;markdown_css&lt;/a&gt;)
&lt;/pre&gt;
<p>Generates code documentation.</p>
<p>Example:
Suppose you have the following directory structure for a Rust library crate:</p>
<pre>[workspace]/
    WORKSPACE
    hello_lib/
        BUILD
        src/
            lib.rs
</pre>
<p>To build <a href="https://doc.rust-lang.org/book/documentation.html"><code>rustdoc</code></a> documentation for the <code>hello_lib</code> crate, define     a <code>rust_doc</code> rule that depends on the the <code>hello_lib</code> <code>rust_library</code> target:</p>
<pre class="language-python"><a-f>package</a-f>(<a-v>default_visibility</a-v> <a-o>=</a-o> [<a-s>&quot;//visibility:public&quot;</a-s>])

<a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>, <a-s>&quot;rust_doc&quot;</a-s>)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/lib.rs&quot;</a-s>],
)

<a-f>rust_doc</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib_doc&quot;</a-s>,
    <a-v>crate</a-v> <a-o>=</a-o> <a-s>&quot;:hello_lib&quot;</a-s>,
)</pre>
<p>Running <code>bazel build //hello_lib:hello_lib_doc</code> will build a zip file containing     the documentation for the <code>hello_lib</code> library crate generated by <code>rustdoc</code>.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_doc-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_doc-crate"&gt;&lt;/a&gt;crate</td><td style="text-align: left">The label of the target to generate code documentation for.&lt;br&gt;&lt;br&gt;&lt;code&gt;rust_doc&lt;/code&gt; can generate HTML code documentation for the source files of &lt;code&gt;rust_library&lt;/code&gt; or &lt;code&gt;rust_binary&lt;/code&gt; targets.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_doc-html_after_content"&gt;&lt;/a&gt;html_after_content</td><td style="text-align: left">File to add in &lt;code&gt;&lt;body&gt;&lt;/code&gt;, after content.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_doc-html_before_content"&gt;&lt;/a&gt;html_before_content</td><td style="text-align: left">File to add in &lt;code&gt;&lt;body&gt;&lt;/code&gt;, before content.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_doc-html_in_header"&gt;&lt;/a&gt;html_in_header</td><td style="text-align: left">File to add to &lt;code&gt;&lt;head&gt;&lt;/code&gt;.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_doc-markdown_css"&gt;&lt;/a&gt;markdown_css</td><td style="text-align: left">CSS files to include via &lt;code&gt;&lt;link&gt;&lt;/code&gt; in a rendered Markdown file.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
</tbody></table>
<p>&lt;a id="#rust_doc_test"&gt;&lt;/a&gt;</p>
<h2>rust_doc_test</h2>
&lt;pre&gt;
rust_doc_test(&lt;a href="#rust_doc_test-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_doc_test-crate"&gt;crate&lt;/a&gt;, &lt;a href="#rust_doc_test-deps"&gt;deps&lt;/a&gt;)
&lt;/pre&gt;
<p>Runs Rust documentation tests.</p>
<p>Example:</p>
<p>Suppose you have the following directory structure for a Rust library crate:</p>
<pre>[workspace]/
WORKSPACE
hello_lib/
    BUILD
    src/
        lib.rs
</pre>
<p>To run <a href="https://doc.rust-lang.org/book/documentation.html#documentation-as-tests">documentation tests</a> for the <code>hello_lib</code> crate, define a <code>rust_doc_test</code>         target that depends on the <code>hello_lib</code> <code>rust_library</code> target:</p>
<pre class="language-python"><a-f>package</a-f>(<a-v>default_visibility</a-v> <a-o>=</a-o> [<a-s>&quot;//visibility:public&quot;</a-s>])

<a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>, <a-s>&quot;rust_doc_test&quot;</a-s>)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/lib.rs&quot;</a-s>],
)

<a-f>rust_doc_test</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib_doc_test&quot;</a-s>,
    <a-v>crate</a-v> <a-o>=</a-o> <a-s>&quot;:hello_lib&quot;</a-s>,
)</pre>
<p>Running <code>bazel test //hello_lib:hello_lib_doc_test</code> will run all documentation tests for the <code>hello_lib</code> library crate.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_doc_test-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_doc_test-crate"&gt;&lt;/a&gt;crate</td><td style="text-align: left">The label of the target to generate code documentation for. &lt;code&gt;rust_doc_test&lt;/code&gt; can generate HTML code documentation for the source files of &lt;code&gt;rust_library&lt;/code&gt; or &lt;code&gt;rust_binary&lt;/code&gt; targets.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_doc_test-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
</tbody></table>
<p>&lt;a id="#rust_grpc_library"&gt;&lt;/a&gt;</p>
<h2>rust_grpc_library</h2>
&lt;pre&gt;
rust_grpc_library(&lt;a href="#rust_grpc_library-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_grpc_library-deps"&gt;deps&lt;/a&gt;, &lt;a href="#rust_grpc_library-rust_deps"&gt;rust_deps&lt;/a&gt;)
&lt;/pre&gt;
<p>Builds a Rust library crate from a set of <code>proto_library</code>s suitable for gRPC.</p>
<p>Example:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;//proto:proto.bzl&quot;</a-s>, <a-s>&quot;rust_grpc_library&quot;</a-s>)

<a-f>proto_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;my_proto&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;my.proto&quot;</a-s>]
)

<a-f>rust_grpc_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;rust&quot;</a-s>,
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;:my_proto&quot;</a-s>],
)

<a-f>rust_binary</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;my_service&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;my_service.rs&quot;</a-s>],
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;:rust&quot;</a-s>],
)</pre>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_grpc_library-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_grpc_library-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">List of proto_library dependencies that will be built. One crate for each proto_library will be created with the corresponding gRPC stubs.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_grpc_library-rust_deps"&gt;&lt;/a&gt;rust_deps</td><td style="text-align: left">The crates the generated library depends on.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
</tbody></table>
<p>&lt;a id="#rust_library"&gt;&lt;/a&gt;</p>
<h2>rust_library</h2>
&lt;pre&gt;
rust_library(&lt;a href="#rust_library-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_library-aliases"&gt;aliases&lt;/a&gt;, &lt;a href="#rust_library-compile_data"&gt;compile_data&lt;/a&gt;, &lt;a href="#rust_library-crate_features"&gt;crate_features&lt;/a&gt;, &lt;a href="#rust_library-crate_name"&gt;crate_name&lt;/a&gt;, &lt;a href="#rust_library-crate_root"&gt;crate_root&lt;/a&gt;, &lt;a href="#rust_library-data"&gt;data&lt;/a&gt;, &lt;a href="#rust_library-deps"&gt;deps&lt;/a&gt;,
             &lt;a href="#rust_library-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_library-proc_macro_deps"&gt;proc_macro_deps&lt;/a&gt;, &lt;a href="#rust_library-rustc_env"&gt;rustc_env&lt;/a&gt;, &lt;a href="#rust_library-rustc_env_files"&gt;rustc_env_files&lt;/a&gt;, &lt;a href="#rust_library-rustc_flags"&gt;rustc_flags&lt;/a&gt;, &lt;a href="#rust_library-srcs"&gt;srcs&lt;/a&gt;, &lt;a href="#rust_library-stamp"&gt;stamp&lt;/a&gt;, &lt;a href="#rust_library-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>Builds a Rust library crate.</p>
<p>Example:</p>
<p>Suppose you have the following directory structure for a simple Rust library crate:</p>
<pre>[workspace]/
    WORKSPACE
    hello_lib/
        BUILD
        src/
            greeter.rs
            lib.rs
</pre>
<p><code>hello_lib/src/greeter.rs</code>:</p>
<pre class="language-rust"><a-k>pub</a-k> <a-k>struct</a-k> <a-t>Greeter</a-t> <a-p>{</a-p>
    <a-pr>greeting</a-pr><a-p>:</a-p> <a-t>String</a-t><a-p>,</a-p>
<a-p>}</a-p>

<a-k>impl</a-k> <a-t>Greeter</a-t> <a-p>{</a-p>
    <a-k>pub</a-k> <a-k>fn</a-k> <a-f>new</a-f><a-p>(</a-p><a-v>greeting</a-v><a-p>:</a-p> <a-o>&amp;</a-o><a-t>str</a-t><a-p>)</a-p> -&gt; <a-t>Greeter</a-t> <a-p>{</a-p>
        <a-t>Greeter</a-t> <a-p>{</a-p> <a-pr>greeting</a-pr><a-p>:</a-p> greeting<a-p>.</a-p><a-f>to_string</a-f><a-p>(),</a-p> <a-p>}</a-p>
    <a-p>}</a-p>

    <a-k>pub</a-k> <a-k>fn</a-k> <a-f>greet</a-f><a-p>(</a-p><a-o>&amp;</a-o><a-v>self</a-v><a-p>,</a-p> <a-v>thing</a-v><a-p>:</a-p> <a-o>&amp;</a-o><a-t>str</a-t><a-p>)</a-p> <a-p>{</a-p>
        <a-m>println!</a-m><a-p>(</a-p><a-s>&quot;{} {}&quot;</a-s><a-p>,</a-p> <a-o>&amp;</a-o><a-v>self</a-v><a-p>.</a-p><a-pr>greeting</a-pr><a-p>,</a-p> thing<a-p>);</a-p>
    <a-p>}</a-p>
<a-p>}</a-p></pre>
<p><code>hello_lib/src/lib.rs</code>:</p>
<pre class="language-rust"><a-k>pub</a-k> <a-k>mod</a-k> greeter<a-p>;</a-p></pre>
<p><code>hello_lib/BUILD</code>:</p>
<pre class="language-python"><a-f>package</a-f>(<a-v>default_visibility</a-v> <a-o>=</a-o> [<a-s>&quot;//visibility:public&quot;</a-s>])

<a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [
        <a-s>&quot;src/greeter.rs&quot;</a-s>,
        <a-s>&quot;src/lib.rs&quot;</a-s>,
    ],
)</pre>
<p>Build the library:</p>
<pre>$ bazel build //hello_lib
INFO: Found 1 target...
Target //examples/rust/hello_lib:hello_lib up-to-date:
bazel-bin/examples/rust/hello_lib/libhello_lib.rlib
INFO: Elapsed time: 1.245s, Critical Path: 1.01s
</pre>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_library-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-aliases"&gt;&lt;/a&gt;aliases</td><td style="text-align: left">Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: Label -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-compile_data"&gt;&lt;/a&gt;compile_data</td><td style="text-align: left">List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the <a href="https://doc.rust-lang.org/std/macro.include_str!.html">&lt;code&gt;include_str!&lt;/code&gt;</a> macro.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-crate_features"&gt;&lt;/a&gt;crate_features</td><td style="text-align: left">List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = "foo")]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature="${feature_name}"&lt;/code&gt; flags.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-crate_name"&gt;&lt;/a&gt;crate_name</td><td style="text-align: left">Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-crate_root"&gt;&lt;/a&gt;crate_root</td><td style="text-align: left">The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-data"&gt;&lt;/a&gt;data</td><td style="text-align: left">List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-proc_macro_deps"&gt;&lt;/a&gt;proc_macro_deps</td><td style="text-align: left">List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-rustc_env"&gt;&lt;/a&gt;rustc_env</td><td style="text-align: left">Dictionary of additional &lt;code&gt;"key": "value"&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-rustc_env_files"&gt;&lt;/a&gt;rustc_env_files</td><td style="text-align: left">Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to <a href="https://docs.bazel.build/versions/main/user-manual.html#workspace_status">workspace status</a> stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-rustc_flags"&gt;&lt;/a&gt;rustc_flags</td><td style="text-align: left">List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-stamp"&gt;&lt;/a&gt;stamp</td><td style="text-align: left">Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--nostamp</a> builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--[no]stamp</a> flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won't be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how <a href="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp">&lt;code&gt;cc_library.linkstamps&lt;/code&gt;</a> behaves.</td><td style="text-align: left">Integer</td><td style="text-align: left">optional</td><td style="text-align: left">-1</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_library-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">A version to inject in the cargo environment variable.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"0.0.0"</td></tr>
</tbody></table>
<p>&lt;a id="#rust_proc_macro"&gt;&lt;/a&gt;</p>
<h2>rust_proc_macro</h2>
&lt;pre&gt;
rust_proc_macro(&lt;a href="#rust_proc_macro-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_proc_macro-aliases"&gt;aliases&lt;/a&gt;, &lt;a href="#rust_proc_macro-compile_data"&gt;compile_data&lt;/a&gt;, &lt;a href="#rust_proc_macro-crate_features"&gt;crate_features&lt;/a&gt;, &lt;a href="#rust_proc_macro-crate_name"&gt;crate_name&lt;/a&gt;, &lt;a href="#rust_proc_macro-crate_root"&gt;crate_root&lt;/a&gt;, &lt;a href="#rust_proc_macro-data"&gt;data&lt;/a&gt;, &lt;a href="#rust_proc_macro-deps"&gt;deps&lt;/a&gt;,
                &lt;a href="#rust_proc_macro-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_proc_macro-proc_macro_deps"&gt;proc_macro_deps&lt;/a&gt;, &lt;a href="#rust_proc_macro-rustc_env"&gt;rustc_env&lt;/a&gt;, &lt;a href="#rust_proc_macro-rustc_env_files"&gt;rustc_env_files&lt;/a&gt;, &lt;a href="#rust_proc_macro-rustc_flags"&gt;rustc_flags&lt;/a&gt;, &lt;a href="#rust_proc_macro-srcs"&gt;srcs&lt;/a&gt;, &lt;a href="#rust_proc_macro-stamp"&gt;stamp&lt;/a&gt;,
                &lt;a href="#rust_proc_macro-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>Builds a Rust proc-macro crate.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-aliases"&gt;&lt;/a&gt;aliases</td><td style="text-align: left">Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: Label -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-compile_data"&gt;&lt;/a&gt;compile_data</td><td style="text-align: left">List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the <a href="https://doc.rust-lang.org/std/macro.include_str!.html">&lt;code&gt;include_str!&lt;/code&gt;</a> macro.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-crate_features"&gt;&lt;/a&gt;crate_features</td><td style="text-align: left">List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = "foo")]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature="${feature_name}"&lt;/code&gt; flags.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-crate_name"&gt;&lt;/a&gt;crate_name</td><td style="text-align: left">Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-crate_root"&gt;&lt;/a&gt;crate_root</td><td style="text-align: left">The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-data"&gt;&lt;/a&gt;data</td><td style="text-align: left">List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-proc_macro_deps"&gt;&lt;/a&gt;proc_macro_deps</td><td style="text-align: left">List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-rustc_env"&gt;&lt;/a&gt;rustc_env</td><td style="text-align: left">Dictionary of additional &lt;code&gt;"key": "value"&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-rustc_env_files"&gt;&lt;/a&gt;rustc_env_files</td><td style="text-align: left">Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to <a href="https://docs.bazel.build/versions/main/user-manual.html#workspace_status">workspace status</a> stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-rustc_flags"&gt;&lt;/a&gt;rustc_flags</td><td style="text-align: left">List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-stamp"&gt;&lt;/a&gt;stamp</td><td style="text-align: left">Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--nostamp</a> builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--[no]stamp</a> flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won't be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how <a href="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp">&lt;code&gt;cc_library.linkstamps&lt;/code&gt;</a> behaves.</td><td style="text-align: left">Integer</td><td style="text-align: left">optional</td><td style="text-align: left">-1</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proc_macro-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">A version to inject in the cargo environment variable.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"0.0.0"</td></tr>
</tbody></table>
<p>&lt;a id="#rust_proto_library"&gt;&lt;/a&gt;</p>
<h2>rust_proto_library</h2>
&lt;pre&gt;
rust_proto_library(&lt;a href="#rust_proto_library-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_proto_library-deps"&gt;deps&lt;/a&gt;, &lt;a href="#rust_proto_library-rust_deps"&gt;rust_deps&lt;/a&gt;)
&lt;/pre&gt;
<p>Builds a Rust library crate from a set of <code>proto_library</code>s.</p>
<p>Example:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//proto:proto.bzl&quot;</a-s>, <a-s>&quot;rust_proto_library&quot;</a-s>)

<a-f>proto_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;my_proto&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;my.proto&quot;</a-s>]
)

<a-f>rust_proto_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;rust&quot;</a-s>,
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;:my_proto&quot;</a-s>],
)

<a-f>rust_binary</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;my_proto_binary&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;my_proto_binary.rs&quot;</a-s>],
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;:rust&quot;</a-s>],
)</pre>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_proto_library-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proto_library-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">List of proto_library dependencies that will be built. One crate for each proto_library will be created with the corresponding stubs.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proto_library-rust_deps"&gt;&lt;/a&gt;rust_deps</td><td style="text-align: left">The crates the generated library depends on.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
</tbody></table>
<p>&lt;a id="#rust_proto_toolchain"&gt;&lt;/a&gt;</p>
<h2>rust_proto_toolchain</h2>
&lt;pre&gt;
rust_proto_toolchain(&lt;a href="#rust_proto_toolchain-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_proto_toolchain-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_proto_toolchain-grpc_compile_deps"&gt;grpc_compile_deps&lt;/a&gt;, &lt;a href="#rust_proto_toolchain-grpc_plugin"&gt;grpc_plugin&lt;/a&gt;, &lt;a href="#rust_proto_toolchain-proto_compile_deps"&gt;proto_compile_deps&lt;/a&gt;,
                     &lt;a href="#rust_proto_toolchain-proto_plugin"&gt;proto_plugin&lt;/a&gt;, &lt;a href="#rust_proto_toolchain-protoc"&gt;protoc&lt;/a&gt;)
&lt;/pre&gt;
<p>Declares a Rust Proto toolchain for use.</p>
<p>This is used to configure proto compilation and can be used to set different protobuf compiler plugin.</p>
<p>Example:</p>
<p>Suppose a new nicer gRPC plugin has came out. The new plugin can be used in Bazel by defining a new toolchain definition and declaration:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&#39;@rules_rust//proto:toolchain.bzl&#39;</a-s>, <a-s>&#39;rust_proto_toolchain&#39;</a-s>)

<a-f>rust_proto_toolchain</a-f>(
   <a-v>name</a-v><a-o>=</a-o><a-s>&quot;rust_proto_impl&quot;</a-s>,
   <a-v>grpc_plugin</a-v><a-o>=</a-o><a-s>&quot;@rust_grpc//:grpc_plugin&quot;</a-s>,
   <a-v>grpc_compile_deps</a-v><a-o>=</a-o>[<a-s>&quot;@rust_grpc//:grpc_deps&quot;</a-s>],
)

<a-f>toolchain</a-f>(
    <a-v>name</a-v><a-o>=</a-o><a-s>&quot;rust_proto&quot;</a-s>,
    <a-v>exec_compatible_with</a-v> <a-o>=</a-o> [
        <a-s>&quot;@platforms//cpu:cpuX&quot;</a-s>,
    ],
    <a-v>target_compatible_with</a-v> <a-o>=</a-o> [
        <a-s>&quot;@platforms//cpu:cpuX&quot;</a-s>,
    ],
    <a-v>toolchain</a-v> <a-o>=</a-o> <a-s>&quot;:rust_proto_impl&quot;</a-s>,
)</pre>
<p>Then, either add the label of the toolchain rule to register_toolchains in the WORKSPACE, or pass it to the <code>--extra_toolchains</code> flag for Bazel, and it will be used.</p>
<p>See @rules_rust//proto:BUILD for examples of defining the toolchain.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_proto_toolchain-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proto_toolchain-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The edition used by the generated rust source.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proto_toolchain-grpc_compile_deps"&gt;&lt;/a&gt;grpc_compile_deps</td><td style="text-align: left">The crates the generated grpc libraries depends on.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[Label("//proto/raze:protobuf"), Label("//proto/raze:grpc"), Label("//proto/raze:tls_api"), Label("//proto/raze:tls_api_stub")]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proto_toolchain-grpc_plugin"&gt;&lt;/a&gt;grpc_plugin</td><td style="text-align: left">The location of the Rust protobuf compiler plugin to generate rust gRPC stubs.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">//proto:protoc_gen_rust_grpc</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proto_toolchain-proto_compile_deps"&gt;&lt;/a&gt;proto_compile_deps</td><td style="text-align: left">The crates the generated protobuf libraries depends on.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[Label("//proto/raze:protobuf")]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proto_toolchain-proto_plugin"&gt;&lt;/a&gt;proto_plugin</td><td style="text-align: left">The location of the Rust protobuf compiler plugin used to generate rust sources.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">//proto:protoc_gen_rust</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_proto_toolchain-protoc"&gt;&lt;/a&gt;protoc</td><td style="text-align: left">The location of the &lt;code&gt;protoc&lt;/code&gt; binary. It should be an executable target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">@com_google_protobuf//:protoc</td></tr>
</tbody></table>
<p>&lt;a id="#rust_shared_library"&gt;&lt;/a&gt;</p>
<h2>rust_shared_library</h2>
&lt;pre&gt;
rust_shared_library(&lt;a href="#rust_shared_library-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_shared_library-aliases"&gt;aliases&lt;/a&gt;, &lt;a href="#rust_shared_library-compile_data"&gt;compile_data&lt;/a&gt;, &lt;a href="#rust_shared_library-crate_features"&gt;crate_features&lt;/a&gt;, &lt;a href="#rust_shared_library-crate_name"&gt;crate_name&lt;/a&gt;, &lt;a href="#rust_shared_library-crate_root"&gt;crate_root&lt;/a&gt;, &lt;a href="#rust_shared_library-data"&gt;data&lt;/a&gt;, &lt;a href="#rust_shared_library-deps"&gt;deps&lt;/a&gt;,
                    &lt;a href="#rust_shared_library-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_shared_library-proc_macro_deps"&gt;proc_macro_deps&lt;/a&gt;, &lt;a href="#rust_shared_library-rustc_env"&gt;rustc_env&lt;/a&gt;, &lt;a href="#rust_shared_library-rustc_env_files"&gt;rustc_env_files&lt;/a&gt;, &lt;a href="#rust_shared_library-rustc_flags"&gt;rustc_flags&lt;/a&gt;, &lt;a href="#rust_shared_library-srcs"&gt;srcs&lt;/a&gt;, &lt;a href="#rust_shared_library-stamp"&gt;stamp&lt;/a&gt;,
                    &lt;a href="#rust_shared_library-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>Builds a Rust shared library.</p>
<p>This shared library will contain all transitively reachable crates and native objects.
It is meant to be used when producing an artifact that is then consumed by some other build system
(for example to produce a shared library that Python program links against).</p>
<p>This rule provides CcInfo, so it can be used everywhere Bazel expects <code>rules_cc</code>.</p>
<p>When building the whole binary in Bazel, use <code>rust_library</code> instead.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-aliases"&gt;&lt;/a&gt;aliases</td><td style="text-align: left">Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: Label -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-compile_data"&gt;&lt;/a&gt;compile_data</td><td style="text-align: left">List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the <a href="https://doc.rust-lang.org/std/macro.include_str!.html">&lt;code&gt;include_str!&lt;/code&gt;</a> macro.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-crate_features"&gt;&lt;/a&gt;crate_features</td><td style="text-align: left">List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = "foo")]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature="${feature_name}"&lt;/code&gt; flags.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-crate_name"&gt;&lt;/a&gt;crate_name</td><td style="text-align: left">Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-crate_root"&gt;&lt;/a&gt;crate_root</td><td style="text-align: left">The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-data"&gt;&lt;/a&gt;data</td><td style="text-align: left">List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-proc_macro_deps"&gt;&lt;/a&gt;proc_macro_deps</td><td style="text-align: left">List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-rustc_env"&gt;&lt;/a&gt;rustc_env</td><td style="text-align: left">Dictionary of additional &lt;code&gt;"key": "value"&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-rustc_env_files"&gt;&lt;/a&gt;rustc_env_files</td><td style="text-align: left">Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to <a href="https://docs.bazel.build/versions/main/user-manual.html#workspace_status">workspace status</a> stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-rustc_flags"&gt;&lt;/a&gt;rustc_flags</td><td style="text-align: left">List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-stamp"&gt;&lt;/a&gt;stamp</td><td style="text-align: left">Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--nostamp</a> builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--[no]stamp</a> flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won't be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how <a href="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp">&lt;code&gt;cc_library.linkstamps&lt;/code&gt;</a> behaves.</td><td style="text-align: left">Integer</td><td style="text-align: left">optional</td><td style="text-align: left">-1</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_shared_library-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">A version to inject in the cargo environment variable.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"0.0.0"</td></tr>
</tbody></table>
<p>&lt;a id="#rust_static_library"&gt;&lt;/a&gt;</p>
<h2>rust_static_library</h2>
&lt;pre&gt;
rust_static_library(&lt;a href="#rust_static_library-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_static_library-aliases"&gt;aliases&lt;/a&gt;, &lt;a href="#rust_static_library-compile_data"&gt;compile_data&lt;/a&gt;, &lt;a href="#rust_static_library-crate_features"&gt;crate_features&lt;/a&gt;, &lt;a href="#rust_static_library-crate_name"&gt;crate_name&lt;/a&gt;, &lt;a href="#rust_static_library-crate_root"&gt;crate_root&lt;/a&gt;, &lt;a href="#rust_static_library-data"&gt;data&lt;/a&gt;, &lt;a href="#rust_static_library-deps"&gt;deps&lt;/a&gt;,
                    &lt;a href="#rust_static_library-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_static_library-proc_macro_deps"&gt;proc_macro_deps&lt;/a&gt;, &lt;a href="#rust_static_library-rustc_env"&gt;rustc_env&lt;/a&gt;, &lt;a href="#rust_static_library-rustc_env_files"&gt;rustc_env_files&lt;/a&gt;, &lt;a href="#rust_static_library-rustc_flags"&gt;rustc_flags&lt;/a&gt;, &lt;a href="#rust_static_library-srcs"&gt;srcs&lt;/a&gt;, &lt;a href="#rust_static_library-stamp"&gt;stamp&lt;/a&gt;,
                    &lt;a href="#rust_static_library-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>Builds a Rust static library.</p>
<p>This static library will contain all transitively reachable crates and native objects.
It is meant to be used when producing an artifact that is then consumed by some other build system
(for example to produce an archive that Python program links against).</p>
<p>This rule provides CcInfo, so it can be used everywhere Bazel expects <code>rules_cc</code>.</p>
<p>When building the whole binary in Bazel, use <code>rust_library</code> instead.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_static_library-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-aliases"&gt;&lt;/a&gt;aliases</td><td style="text-align: left">Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: Label -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-compile_data"&gt;&lt;/a&gt;compile_data</td><td style="text-align: left">List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the <a href="https://doc.rust-lang.org/std/macro.include_str!.html">&lt;code&gt;include_str!&lt;/code&gt;</a> macro.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-crate_features"&gt;&lt;/a&gt;crate_features</td><td style="text-align: left">List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = "foo")]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature="${feature_name}"&lt;/code&gt; flags.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-crate_name"&gt;&lt;/a&gt;crate_name</td><td style="text-align: left">Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-crate_root"&gt;&lt;/a&gt;crate_root</td><td style="text-align: left">The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-data"&gt;&lt;/a&gt;data</td><td style="text-align: left">List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-proc_macro_deps"&gt;&lt;/a&gt;proc_macro_deps</td><td style="text-align: left">List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-rustc_env"&gt;&lt;/a&gt;rustc_env</td><td style="text-align: left">Dictionary of additional &lt;code&gt;"key": "value"&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-rustc_env_files"&gt;&lt;/a&gt;rustc_env_files</td><td style="text-align: left">Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to <a href="https://docs.bazel.build/versions/main/user-manual.html#workspace_status">workspace status</a> stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-rustc_flags"&gt;&lt;/a&gt;rustc_flags</td><td style="text-align: left">List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-stamp"&gt;&lt;/a&gt;stamp</td><td style="text-align: left">Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--nostamp</a> builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--[no]stamp</a> flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won't be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how <a href="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp">&lt;code&gt;cc_library.linkstamps&lt;/code&gt;</a> behaves.</td><td style="text-align: left">Integer</td><td style="text-align: left">optional</td><td style="text-align: left">-1</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_static_library-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">A version to inject in the cargo environment variable.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"0.0.0"</td></tr>
</tbody></table>
<p>&lt;a id="#rust_stdlib_filegroup"&gt;&lt;/a&gt;</p>
<h2>rust_stdlib_filegroup</h2>
&lt;pre&gt;
rust_stdlib_filegroup(&lt;a href="#rust_stdlib_filegroup-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_stdlib_filegroup-srcs"&gt;srcs&lt;/a&gt;)
&lt;/pre&gt;
<p>A dedicated filegroup-like rule for Rust stdlib artifacts.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_stdlib_filegroup-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_stdlib_filegroup-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">The list of targets/files that are components of the rust-stdlib file group</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
<p>&lt;a id="#rust_test"&gt;&lt;/a&gt;</p>
<h2>rust_test</h2>
&lt;pre&gt;
rust_test(&lt;a href="#rust_test-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_test-aliases"&gt;aliases&lt;/a&gt;, &lt;a href="#rust_test-compile_data"&gt;compile_data&lt;/a&gt;, &lt;a href="#rust_test-crate"&gt;crate&lt;/a&gt;, &lt;a href="#rust_test-crate_features"&gt;crate_features&lt;/a&gt;, &lt;a href="#rust_test-crate_name"&gt;crate_name&lt;/a&gt;, &lt;a href="#rust_test-crate_root"&gt;crate_root&lt;/a&gt;, &lt;a href="#rust_test-data"&gt;data&lt;/a&gt;, &lt;a href="#rust_test-deps"&gt;deps&lt;/a&gt;,
          &lt;a href="#rust_test-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_test-env"&gt;env&lt;/a&gt;, &lt;a href="#rust_test-proc_macro_deps"&gt;proc_macro_deps&lt;/a&gt;, &lt;a href="#rust_test-rustc_env"&gt;rustc_env&lt;/a&gt;, &lt;a href="#rust_test-rustc_env_files"&gt;rustc_env_files&lt;/a&gt;, &lt;a href="#rust_test-rustc_flags"&gt;rustc_flags&lt;/a&gt;, &lt;a href="#rust_test-srcs"&gt;srcs&lt;/a&gt;, &lt;a href="#rust_test-stamp"&gt;stamp&lt;/a&gt;,
          &lt;a href="#rust_test-use_libtest_harness"&gt;use_libtest_harness&lt;/a&gt;, &lt;a href="#rust_test-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>Builds a Rust test crate.</p>
<p>Examples:</p>
<p>Suppose you have the following directory structure for a Rust library crate         with unit test code in the library sources:</p>
<pre>[workspace]/
    WORKSPACE
    hello_lib/
        BUILD
        src/
            lib.rs
</pre>
<p><code>hello_lib/src/lib.rs</code>:</p>
<pre class="language-rust"><a-k>pub</a-k> <a-k>struct</a-k> <a-t>Greeter</a-t> <a-p>{</a-p>
    <a-pr>greeting</a-pr><a-p>:</a-p> <a-t>String</a-t><a-p>,</a-p>
<a-p>}</a-p>

<a-k>impl</a-k> <a-t>Greeter</a-t> <a-p>{</a-p>
    <a-k>pub</a-k> <a-k>fn</a-k> <a-f>new</a-f><a-p>(</a-p><a-v>greeting</a-v><a-p>:</a-p> <a-o>&amp;</a-o><a-t>str</a-t><a-p>)</a-p> -&gt; <a-t>Greeter</a-t> <a-p>{</a-p>
        <a-t>Greeter</a-t> <a-p>{</a-p> <a-pr>greeting</a-pr><a-p>:</a-p> greeting<a-p>.</a-p><a-f>to_string</a-f><a-p>(),</a-p> <a-p>}</a-p>
    <a-p>}</a-p>

    <a-k>pub</a-k> <a-k>fn</a-k> <a-f>greet</a-f><a-p>(</a-p><a-o>&amp;</a-o><a-v>self</a-v><a-p>,</a-p> <a-v>thing</a-v><a-p>:</a-p> <a-o>&amp;</a-o><a-t>str</a-t><a-p>)</a-p> -&gt; <a-t>String</a-t> <a-p>{</a-p>
        <a-m>format!</a-m><a-p>(</a-p><a-s>&quot;{} {}&quot;</a-s><a-p>,</a-p> <a-o>&amp;</a-o><a-v>self</a-v><a-p>.</a-p><a-pr>greeting</a-pr><a-p>,</a-p> thing<a-p>)</a-p>
    <a-p>}</a-p>
<a-p>}</a-p>

<a-at>#</a-at><a-p>[</a-p><a-at>cfg</a-at><a-p>(</a-p><a-at>test</a-at><a-p>)]</a-p>
<a-k>mod</a-k> test <a-p>{</a-p>
    <a-k>use</a-k> <a-k>super</a-k><a-p>::</a-p><a-cr>Greeter</a-cr><a-p>;</a-p>

    <a-at>#</a-at><a-p>[</a-p><a-at>test</a-at><a-p>]</a-p>
    <a-k>fn</a-k> <a-f>test_greeting</a-f><a-p>()</a-p> <a-p>{</a-p>
        <a-k>let</a-k> hello = <a-t>Greeter</a-t><a-p>::</a-p><a-f>new</a-f><a-p>(</a-p><a-s>&quot;Hi&quot;</a-s><a-p>);</a-p>
        <a-m>assert_eq!</a-m><a-p>(</a-p><a-s>&quot;Hi Rust&quot;</a-s><a-p>,</a-p> hello<a-p>.</a-p><a-f>greet</a-f><a-p>(</a-p><a-s>&quot;Rust&quot;</a-s><a-p>));</a-p>
    <a-p>}</a-p>
<a-p>}</a-p></pre>
<p>To build and run the tests, simply add a <code>rust_test</code> rule with no <code>srcs</code>
and only depends on the <code>hello_lib</code> <code>rust_library</code> target via the
<code>crate</code> attribute:</p>
<p><code>hello_lib/BUILD</code>:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>, <a-s>&quot;rust_test&quot;</a-s>)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/lib.rs&quot;</a-s>],
)

<a-v>rust_test</a-v>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib_test&quot;</a-s>,
    <a-v>crate</a-v> <a-o>=</a-o> <a-s>&quot;:hello_lib&quot;</a-s>,
    <a-c># You may add other deps that are specific to the test configuration</a-c>
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;//some/dev/dep&quot;</a-s>],</pre>
<p>Run the test with <code>bazel test //hello_lib:hello_lib_test</code>. The crate
will be built using the same crate name as the underlying ":hello_lib"
crate.</p>
<h3>Example: <code>test</code> directory</h3>
<p>Integration tests that live in the <a href="http://doc.rust-lang.org/book/testing.html#the-tests-directory"><code>tests</code> directory</a>, they are         essentially built as separate crates. Suppose you have the following directory         structure where <code>greeting.rs</code> is an integration test for the <code>hello_lib</code>         library crate:</p>
<pre>[workspace]/
    WORKSPACE
    hello_lib/
        BUILD
        src/
            lib.rs
        tests/
            greeting.rs
</pre>
<p><code>hello_lib/tests/greeting.rs</code>:</p>
<pre class="language-rust"><a-k>extern</a-k> <a-k>crate</a-k> hello_lib<a-p>;</a-p>

<a-k>use</a-k> hello_lib<a-p>;</a-p>

<a-at>#</a-at><a-p>[</a-p><a-at>test</a-at><a-p>]</a-p>
<a-k>fn</a-k> <a-f>test_greeting</a-f><a-p>()</a-p> <a-p>{</a-p>
    <a-k>let</a-k> hello = greeter<a-p>::</a-p><a-t>Greeter</a-t><a-p>::</a-p><a-f>new</a-f><a-p>(</a-p><a-s>&quot;Hello&quot;</a-s><a-p>);</a-p>
    <a-m>assert_eq!</a-m><a-p>(</a-p><a-s>&quot;Hello world&quot;</a-s><a-p>,</a-p> hello<a-p>.</a-p><a-f>greeting</a-f><a-p>(</a-p><a-s>&quot;world&quot;</a-s><a-p>));</a-p>
<a-p>}</a-p></pre>
<p>To build the <code>greeting.rs</code> integration test, simply add a <code>rust_test</code> target
with <code>greeting.rs</code> in <code>srcs</code> and a dependency on the <code>hello_lib</code> target:</p>
<p><code>hello_lib/BUILD</code>:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>, <a-s>&quot;rust_test&quot;</a-s>)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/lib.rs&quot;</a-s>],
)

<a-f>rust_test</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;greeting_test&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;tests/greeting.rs&quot;</a-s>],
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;:hello_lib&quot;</a-s>],
)</pre>
<p>Run the test with <code>bazel test //hello_lib:greeting_test</code>.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_test-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-aliases"&gt;&lt;/a&gt;aliases</td><td style="text-align: left">Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: Label -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-compile_data"&gt;&lt;/a&gt;compile_data</td><td style="text-align: left">List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the <a href="https://doc.rust-lang.org/std/macro.include_str!.html">&lt;code&gt;include_str!&lt;/code&gt;</a> macro.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-crate"&gt;&lt;/a&gt;crate</td><td style="text-align: left">Target inline tests declared in the given crate&lt;br&gt;&lt;br&gt;These tests are typically those that would be held out under &lt;code&gt;#[cfg(test)]&lt;/code&gt; declarations.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-crate_features"&gt;&lt;/a&gt;crate_features</td><td style="text-align: left">List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = "foo")]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature="${feature_name}"&lt;/code&gt; flags.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-crate_name"&gt;&lt;/a&gt;crate_name</td><td style="text-align: left">Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-crate_root"&gt;&lt;/a&gt;crate_root</td><td style="text-align: left">The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-data"&gt;&lt;/a&gt;data</td><td style="text-align: left">List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-env"&gt;&lt;/a&gt;env</td><td style="text-align: left">Specifies additional environment variables to set when the test is executed by bazel test. Values are subject to &lt;code&gt;$(rootpath)&lt;/code&gt;, &lt;code&gt;$(execpath)&lt;/code&gt;, location, and <a href="https://docs.bazel.build/versions/master/be/make-variables.html">"Make variable"</a> substitution.&lt;br&gt;&lt;br&gt;Execpath returns absolute path, and in order to be able to construct the absolute path we need to wrap the test binary in a launcher. Using a launcher comes with complications, such as more complicated debugger attachment.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-proc_macro_deps"&gt;&lt;/a&gt;proc_macro_deps</td><td style="text-align: left">List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-rustc_env"&gt;&lt;/a&gt;rustc_env</td><td style="text-align: left">Dictionary of additional &lt;code&gt;"key": "value"&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-rustc_env_files"&gt;&lt;/a&gt;rustc_env_files</td><td style="text-align: left">Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to <a href="https://docs.bazel.build/versions/main/user-manual.html#workspace_status">workspace status</a> stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-rustc_flags"&gt;&lt;/a&gt;rustc_flags</td><td style="text-align: left">List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-stamp"&gt;&lt;/a&gt;stamp</td><td style="text-align: left">Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--nostamp</a> builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             <a href="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp">--[no]stamp</a> flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won't be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how <a href="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp">&lt;code&gt;cc_library.linkstamps&lt;/code&gt;</a> behaves.</td><td style="text-align: left">Integer</td><td style="text-align: left">optional</td><td style="text-align: left">-1</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-use_libtest_harness"&gt;&lt;/a&gt;use_libtest_harness</td><td style="text-align: left">Whether to use &lt;code&gt;libtest&lt;/code&gt;. For targets using this flag, individual tests can be run by using the <a href="https://docs.bazel.build/versions/4.0.0/command-line-reference.html#flag--test_arg">--test_arg</a> flag. E.g. &lt;code&gt;bazel test //src:rust_test --test_arg=foo::test::test_fn&lt;/code&gt;.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left">True</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">A version to inject in the cargo environment variable.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"0.0.0"</td></tr>
</tbody></table>
<p>&lt;a id="#rust_toolchain"&gt;&lt;/a&gt;</p>
<h2>rust_toolchain</h2>
&lt;pre&gt;
rust_toolchain(&lt;a href="#rust_toolchain-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_toolchain-allocator_library"&gt;allocator_library&lt;/a&gt;, &lt;a href="#rust_toolchain-binary_ext"&gt;binary_ext&lt;/a&gt;, &lt;a href="#rust_toolchain-cargo"&gt;cargo&lt;/a&gt;, &lt;a href="#rust_toolchain-clippy_driver"&gt;clippy_driver&lt;/a&gt;, &lt;a href="#rust_toolchain-debug_info"&gt;debug_info&lt;/a&gt;,
               &lt;a href="#rust_toolchain-default_edition"&gt;default_edition&lt;/a&gt;, &lt;a href="#rust_toolchain-dylib_ext"&gt;dylib_ext&lt;/a&gt;, &lt;a href="#rust_toolchain-env"&gt;env&lt;/a&gt;, &lt;a href="#rust_toolchain-exec_triple"&gt;exec_triple&lt;/a&gt;, &lt;a href="#rust_toolchain-llvm_cov"&gt;llvm_cov&lt;/a&gt;, &lt;a href="#rust_toolchain-llvm_profdata"&gt;llvm_profdata&lt;/a&gt;, &lt;a href="#rust_toolchain-llvm_tools"&gt;llvm_tools&lt;/a&gt;,
               &lt;a href="#rust_toolchain-opt_level"&gt;opt_level&lt;/a&gt;, &lt;a href="#rust_toolchain-os"&gt;os&lt;/a&gt;, &lt;a href="#rust_toolchain-rust_doc"&gt;rust_doc&lt;/a&gt;, &lt;a href="#rust_toolchain-rust_lib"&gt;rust_lib&lt;/a&gt;, &lt;a href="#rust_toolchain-rust_std"&gt;rust_std&lt;/a&gt;, &lt;a href="#rust_toolchain-rustc"&gt;rustc&lt;/a&gt;, &lt;a href="#rust_toolchain-rustc_lib"&gt;rustc_lib&lt;/a&gt;, &lt;a href="#rust_toolchain-rustc_srcs"&gt;rustc_srcs&lt;/a&gt;, &lt;a href="#rust_toolchain-rustfmt"&gt;rustfmt&lt;/a&gt;,
               &lt;a href="#rust_toolchain-staticlib_ext"&gt;staticlib_ext&lt;/a&gt;, &lt;a href="#rust_toolchain-stdlib_linkflags"&gt;stdlib_linkflags&lt;/a&gt;, &lt;a href="#rust_toolchain-target_json"&gt;target_json&lt;/a&gt;, &lt;a href="#rust_toolchain-target_triple"&gt;target_triple&lt;/a&gt;)
&lt;/pre&gt;
<p>Declares a Rust toolchain for use.</p>
<p>This is for declaring a custom toolchain, eg. for configuring a particular version of rust or supporting a new platform.</p>
<p>Example:</p>
<p>Suppose the core rust team has ported the compiler to a new target CPU, called <code>cpuX</code>. This support can be used in Bazel by defining a new toolchain definition and declaration:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&#39;@rules_rust//rust:toolchain.bzl&#39;</a-s>, <a-s>&#39;rust_toolchain&#39;</a-s>)

<a-f>rust_toolchain</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;rust_cpuX_impl&quot;</a-s>,
    <a-v>rustc</a-v> <a-o>=</a-o> <a-s>&quot;@rust_cpuX//:rustc&quot;</a-s>,
    <a-v>rustc_lib</a-v> <a-o>=</a-o> <a-s>&quot;@rust_cpuX//:rustc_lib&quot;</a-s>,
    <a-v>rust_std</a-v> <a-o>=</a-o> <a-s>&quot;@rust_cpuX//:rust_std&quot;</a-s>,
    <a-v>rust_doc</a-v> <a-o>=</a-o> <a-s>&quot;@rust_cpuX//:rustdoc&quot;</a-s>,
    <a-v>binary_ext</a-v> <a-o>=</a-o> <a-s>&quot;&quot;</a-s>,
    <a-v>staticlib_ext</a-v> <a-o>=</a-o> <a-s>&quot;.a&quot;</a-s>,
    <a-v>dylib_ext</a-v> <a-o>=</a-o> <a-s>&quot;.so&quot;</a-s>,
    <a-v>stdlib_linkflags</a-v> <a-o>=</a-o> [<a-s>&quot;-lpthread&quot;</a-s>, <a-s>&quot;-ldl&quot;</a-s>],
    <a-v>os</a-v> <a-o>=</a-o> <a-s>&quot;linux&quot;</a-s>,
)

<a-f>toolchain</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;rust_cpuX&quot;</a-s>,
    <a-v>exec_compatible_with</a-v> <a-o>=</a-o> [
        <a-s>&quot;@platforms//cpu:cpuX&quot;</a-s>,
    ],
    <a-v>target_compatible_with</a-v> <a-o>=</a-o> [
        <a-s>&quot;@platforms//cpu:cpuX&quot;</a-s>,
    ],
    <a-v>toolchain</a-v> <a-o>=</a-o> <a-s>&quot;:rust_cpuX_impl&quot;</a-s>,
)</pre>
<p>Then, either add the label of the toolchain rule to <code>register_toolchains</code> in the WORKSPACE, or pass it to the <code>"--extra_toolchains"</code> flag for Bazel, and it will be used.</p>
<p>See @rules_rust//rust:repositories.bzl for examples of defining the @rust_cpuX repository with the actual binaries and libraries.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-allocator_library"&gt;&lt;/a&gt;allocator_library</td><td style="text-align: left">Target that provides allocator functions when rust_library targets are embedded in a cc_binary.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-binary_ext"&gt;&lt;/a&gt;binary_ext</td><td style="text-align: left">The extension for binaries created from rustc.</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-cargo"&gt;&lt;/a&gt;cargo</td><td style="text-align: left">The location of the &lt;code&gt;cargo&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-clippy_driver"&gt;&lt;/a&gt;clippy_driver</td><td style="text-align: left">The location of the &lt;code&gt;clippy-driver&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-debug_info"&gt;&lt;/a&gt;debug_info</td><td style="text-align: left">Rustc debug info levels per opt level</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{"dbg": "2", "fastbuild": "0", "opt": "0"}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-default_edition"&gt;&lt;/a&gt;default_edition</td><td style="text-align: left">The edition to use for rust_* rules that don't specify an edition. If absent, every rule is required to specify its &lt;code&gt;edition&lt;/code&gt; attribute.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-dylib_ext"&gt;&lt;/a&gt;dylib_ext</td><td style="text-align: left">The extension for dynamic libraries created from rustc.</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-env"&gt;&lt;/a&gt;env</td><td style="text-align: left">Environment variables to set in actions.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-exec_triple"&gt;&lt;/a&gt;exec_triple</td><td style="text-align: left">The platform triple for the toolchains execution environment. For more details see: https://docs.bazel.build/versions/master/skylark/rules.html#configurations</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-llvm_cov"&gt;&lt;/a&gt;llvm_cov</td><td style="text-align: left">The location of the &lt;code&gt;llvm-cov&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item. If None, rust code is not instrumented for coverage.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-llvm_profdata"&gt;&lt;/a&gt;llvm_profdata</td><td style="text-align: left">The location of the &lt;code&gt;llvm-profdata&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item. If &lt;code&gt;llvm_cov&lt;/code&gt; is None, this can be None as well and rust code is not instrumented for coverage.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-llvm_tools"&gt;&lt;/a&gt;llvm_tools</td><td style="text-align: left">LLVM tools that are shipped with the Rust toolchain.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-opt_level"&gt;&lt;/a&gt;opt_level</td><td style="text-align: left">Rustc optimization levels.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{"dbg": "0", "fastbuild": "0", "opt": "3"}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-os"&gt;&lt;/a&gt;os</td><td style="text-align: left">The operating system for the current toolchain</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-rust_doc"&gt;&lt;/a&gt;rust_doc</td><td style="text-align: left">The location of the &lt;code&gt;rustdoc&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-rust_lib"&gt;&lt;/a&gt;rust_lib</td><td style="text-align: left"><strong>Deprecated</strong>: Use &lt;code&gt;rust_std&lt;/code&gt;</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-rust_std"&gt;&lt;/a&gt;rust_std</td><td style="text-align: left">The Rust standard library.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-rustc"&gt;&lt;/a&gt;rustc</td><td style="text-align: left">The location of the &lt;code&gt;rustc&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-rustc_lib"&gt;&lt;/a&gt;rustc_lib</td><td style="text-align: left">The libraries used by rustc during compilation.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-rustc_srcs"&gt;&lt;/a&gt;rustc_srcs</td><td style="text-align: left">The source code of rustc.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-rustfmt"&gt;&lt;/a&gt;rustfmt</td><td style="text-align: left">The location of the &lt;code&gt;rustfmt&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-staticlib_ext"&gt;&lt;/a&gt;staticlib_ext</td><td style="text-align: left">The extension for static libraries created from rustc.</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-stdlib_linkflags"&gt;&lt;/a&gt;stdlib_linkflags</td><td style="text-align: left">Additional linker flags to use when Rust standard library is linked by a C++ linker (rustc will deal with these automatically). Subject to location expansion with respect to the srcs of the &lt;code&gt;rust_std&lt;/code&gt; attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-target_json"&gt;&lt;/a&gt;target_json</td><td style="text-align: left">Override the target_triple with a custom target specification. For more details see: https://doc.rust-lang.org/rustc/targets/custom.html</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain-target_triple"&gt;&lt;/a&gt;target_triple</td><td style="text-align: left">The platform triple for the toolchains target environment. For more details see: https://docs.bazel.build/versions/master/skylark/rules.html#configurations</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
</tbody></table>
<p>&lt;a id="#rust_toolchain_repository"&gt;&lt;/a&gt;</p>
<h2>rust_toolchain_repository</h2>
&lt;pre&gt;
rust_toolchain_repository(&lt;a href="#rust_toolchain_repository-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-auth"&gt;auth&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-dev_components"&gt;dev_components&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-exec_triple"&gt;exec_triple&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-extra_target_triples"&gt;extra_target_triples&lt;/a&gt;,
                          &lt;a href="#rust_toolchain_repository-include_rustc_srcs"&gt;include_rustc_srcs&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-iso_date"&gt;iso_date&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-repo_mapping"&gt;repo_mapping&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-rustfmt_version"&gt;rustfmt_version&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-sha256s"&gt;sha256s&lt;/a&gt;,
                          &lt;a href="#rust_toolchain_repository-toolchain_name_prefix"&gt;toolchain_name_prefix&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-urls"&gt;urls&lt;/a&gt;, &lt;a href="#rust_toolchain_repository-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>Composes a single workspace containing the toolchain components for compiling on a given platform to a series of target platforms.</p>
<p>A given instance of this rule should be accompanied by a rust_toolchain_repository_proxy invocation to declare its toolchains to Bazel; the indirection allows separating toolchain selection from toolchain fetching.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this repository.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-auth"&gt;&lt;/a&gt;auth</td><td style="text-align: left">Auth object compatible with repository_ctx.download to use when downloading files. See <a href="https://docs.bazel.build/versions/main/skylark/lib/repository_ctx.html#download">repository_ctx.download</a> for more details.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-dev_components"&gt;&lt;/a&gt;dev_components</td><td style="text-align: left">Whether to download the rustc-dev components (defaults to False). Requires version to be "nightly".</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left">False</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The rust edition to be used by default (2015, 2018, or 2021). If absent, every rule is required to specify its &lt;code&gt;edition&lt;/code&gt; attribute.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-exec_triple"&gt;&lt;/a&gt;exec_triple</td><td style="text-align: left">The Rust-style target that this compiler runs on</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-extra_target_triples"&gt;&lt;/a&gt;extra_target_triples</td><td style="text-align: left">Additional rust-style targets that this set of toolchains should support.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-include_rustc_srcs"&gt;&lt;/a&gt;include_rustc_srcs</td><td style="text-align: left">Whether to download and unpack the rustc source files. These are very large, and slow to unpack, but are required to support rust analyzer. An environment variable &lt;code&gt;RULES_RUST_TOOLCHAIN_INCLUDE_RUSTC_SRCS&lt;/code&gt; can also be used to control this attribute. This variable will take precedence over the hard coded attribute. Setting it to &lt;code&gt;true&lt;/code&gt; to activates this attribute where all other values deactivate it.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left">False</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-iso_date"&gt;&lt;/a&gt;iso_date</td><td style="text-align: left">The date of the tool (or None, if the version is a specific version).</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-repo_mapping"&gt;&lt;/a&gt;repo_mapping</td><td style="text-align: left">A dictionary from local repository name to global repository name. This allows controls over workspace dependency resolution for dependencies of this repository.&lt;p&gt;For example, an entry &lt;code&gt;"@foo": "@bar"&lt;/code&gt; declares that, for any time this repository depends on &lt;code&gt;@foo&lt;/code&gt; (such as a dependency on &lt;code&gt;@foo//some:target&lt;/code&gt;, it should actually resolve that dependency within globally-declared &lt;code&gt;@bar&lt;/code&gt; (&lt;code&gt;@bar//some:target&lt;/code&gt;).</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-rustfmt_version"&gt;&lt;/a&gt;rustfmt_version</td><td style="text-align: left">The version of the tool among "nightly", "beta", or an exact version.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-sha256s"&gt;&lt;/a&gt;sha256s</td><td style="text-align: left">A dict associating tool subdirectories to sha256 hashes. See <a href="#rust_repositories">rust_repositories</a> for more details.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">{}</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-toolchain_name_prefix"&gt;&lt;/a&gt;toolchain_name_prefix</td><td style="text-align: left">The per-target prefix expected for the rust_toolchain declarations in the parent workspace.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-urls"&gt;&lt;/a&gt;urls</td><td style="text-align: left">A list of mirror urls containing the tools from the Rust-lang static file server. These must contain the '{}' used to substitute the tool being fetched (using .format).</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">["https://static.rust-lang.org/dist/{}.tar.gz"]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">The version of the tool among "nightly", "beta", or an exact version.</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
<p>&lt;a id="#rust_toolchain_repository_proxy"&gt;&lt;/a&gt;</p>
<h2>rust_toolchain_repository_proxy</h2>
&lt;pre&gt;
rust_toolchain_repository_proxy(&lt;a href="#rust_toolchain_repository_proxy-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_toolchain_repository_proxy-exec_triple"&gt;exec_triple&lt;/a&gt;, &lt;a href="#rust_toolchain_repository_proxy-extra_target_triples"&gt;extra_target_triples&lt;/a&gt;, &lt;a href="#rust_toolchain_repository_proxy-parent_workspace_name"&gt;parent_workspace_name&lt;/a&gt;,
                                &lt;a href="#rust_toolchain_repository_proxy-repo_mapping"&gt;repo_mapping&lt;/a&gt;, &lt;a href="#rust_toolchain_repository_proxy-toolchain_name_prefix"&gt;toolchain_name_prefix&lt;/a&gt;)
&lt;/pre&gt;
<p>Generates a toolchain-bearing repository that declares the toolchains from some other rust_toolchain_repository.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository_proxy-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this repository.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository_proxy-exec_triple"&gt;&lt;/a&gt;exec_triple</td><td style="text-align: left">The Rust-style target triple for the compilation platform</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository_proxy-extra_target_triples"&gt;&lt;/a&gt;extra_target_triples</td><td style="text-align: left">The Rust-style triples for extra compilation targets</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository_proxy-parent_workspace_name"&gt;&lt;/a&gt;parent_workspace_name</td><td style="text-align: left">The name of the other rust_toolchain_repository</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository_proxy-repo_mapping"&gt;&lt;/a&gt;repo_mapping</td><td style="text-align: left">A dictionary from local repository name to global repository name. This allows controls over workspace dependency resolution for dependencies of this repository.&lt;p&gt;For example, an entry &lt;code&gt;"@foo": "@bar"&lt;/code&gt; declares that, for any time this repository depends on &lt;code&gt;@foo&lt;/code&gt; (such as a dependency on &lt;code&gt;@foo//some:target&lt;/code&gt;, it should actually resolve that dependency within globally-declared &lt;code&gt;@bar&lt;/code&gt; (&lt;code&gt;@bar//some:target&lt;/code&gt;).</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/skylark/lib/dict.html"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_toolchain_repository_proxy-toolchain_name_prefix"&gt;&lt;/a&gt;toolchain_name_prefix</td><td style="text-align: left">The per-target prefix expected for the rust_toolchain declarations in the parent workspace.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">""</td></tr>
</tbody></table>
<p>&lt;a id="#rust_wasm_bindgen"&gt;&lt;/a&gt;</p>
<h2>rust_wasm_bindgen</h2>
&lt;pre&gt;
rust_wasm_bindgen(&lt;a href="#rust_wasm_bindgen-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_wasm_bindgen-bindgen_flags"&gt;bindgen_flags&lt;/a&gt;, &lt;a href="#rust_wasm_bindgen-target"&gt;target&lt;/a&gt;, &lt;a href="#rust_wasm_bindgen-wasm_file"&gt;wasm_file&lt;/a&gt;)
&lt;/pre&gt;
<p>Generates javascript and typescript bindings for a webassembly module using <a href="https://rustwasm.github.io/docs/wasm-bindgen/">wasm-bindgen</a>.</p>
<p>To use the Rust WebAssembly bindgen rules, add the following to your <code>WORKSPACE</code> file to add the
external repositories for the Rust bindgen toolchain (in addition to the Rust rules setup):</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//wasm_bindgen:repositories.bzl&quot;</a-s>, <a-s>&quot;rust_wasm_bindgen_repositories&quot;</a-s>)

<a-f>rust_wasm_bindgen_repositories</a-f>()</pre>
<p>For more details on <code>rust_wasm_bindgen_repositories</code>, see <a href="#rust_wasm_bindgen_repositories">here</a>.</p>
<p>An example of this rule in use can be seen at <a href="/fork/rules_rust/ref/0.7.0/tree/examples/wasm/">@rules_rust//examples/wasm</a></p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_wasm_bindgen-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_wasm_bindgen-bindgen_flags"&gt;&lt;/a&gt;bindgen_flags</td><td style="text-align: left">Flags to pass directly to the bindgen executable. See https://github.com/rustwasm/wasm-bindgen/ for details.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_wasm_bindgen-target"&gt;&lt;/a&gt;target</td><td style="text-align: left">The type of output to generate. See https://rustwasm.github.io/wasm-bindgen/reference/deployment.html for details.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left">"bundler"</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_wasm_bindgen-wasm_file"&gt;&lt;/a&gt;wasm_file</td><td style="text-align: left">The &lt;code&gt;.wasm&lt;/code&gt; file or crate to generate bindings for.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
<p>&lt;a id="#rust_wasm_bindgen_toolchain"&gt;&lt;/a&gt;</p>
<h2>rust_wasm_bindgen_toolchain</h2>
&lt;pre&gt;
rust_wasm_bindgen_toolchain(&lt;a href="#rust_wasm_bindgen_toolchain-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_wasm_bindgen_toolchain-bindgen"&gt;bindgen&lt;/a&gt;)
&lt;/pre&gt;
<p>The tools required for the <code>rust_wasm_bindgen</code> rule.</p>
<p>In cases where users want to control or change the version of <code>wasm-bindgen</code> used by <a href="#rust_wasm_bindgen">rust_wasm_bindgen</a>,
a unique toolchain can be created as in the example below:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//bindgen:bindgen.bzl&quot;</a-s>, <a-s>&quot;rust_bindgen_toolchain&quot;</a-s>)

<a-f>rust_bindgen_toolchain</a-f>(
    <a-v>bindgen</a-v> <a-o>=</a-o> <a-s>&quot;//my/cargo_raze:cargo_bin_wasm_bindgen&quot;</a-s>,
)

<a-f>toolchain</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;wasm_bindgen_toolchain&quot;</a-s>,
    <a-v>toolchain</a-v> <a-o>=</a-o> <a-s>&quot;wasm_bindgen_toolchain_impl&quot;</a-s>,
    <a-v>toolchain_type</a-v> <a-o>=</a-o> <a-s>&quot;@rules_rust//wasm_bindgen:wasm_bindgen_toolchain&quot;</a-s>,
)</pre>
<p>Now that you have your own toolchain, you need to register it by
inserting the following statement in your <code>WORKSPACE</code> file:</p>
<pre class="language-python"><a-f>register_toolchains</a-f>(<a-s>&quot;//my/toolchains:wasm_bindgen_toolchain&quot;</a-s>)</pre>
<p>For additional information, see the <a href="https://docs.bazel.build/versions/master/toolchains.html">Bazel toolchains documentation</a>.</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_wasm_bindgen_toolchain-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rust_wasm_bindgen_toolchain-bindgen"&gt;&lt;/a&gt;bindgen</td><td style="text-align: left">The label of a &lt;code&gt;wasm-bindgen-cli&lt;/code&gt; executable.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">None</td></tr>
</tbody></table>
<p>&lt;a id="#rustfmt_test"&gt;&lt;/a&gt;</p>
<h2>rustfmt_test</h2>
&lt;pre&gt;
rustfmt_test(&lt;a href="#rustfmt_test-name"&gt;name&lt;/a&gt;, &lt;a href="#rustfmt_test-targets"&gt;targets&lt;/a&gt;)
&lt;/pre&gt;
<p>A test rule for performing <code>rustfmt --check</code> on a set of targets</p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rustfmt_test-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="rustfmt_test-targets"&gt;&lt;/a&gt;targets</td><td style="text-align: left">Rust targets to run &lt;code&gt;rustfmt --check&lt;/code&gt; on.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left">[]</td></tr>
</tbody></table>
<p>&lt;a id="#CrateInfo"&gt;&lt;/a&gt;</p>
<h2>CrateInfo</h2>
&lt;pre&gt;
CrateInfo(&lt;a href="#CrateInfo-aliases"&gt;aliases&lt;/a&gt;, &lt;a href="#CrateInfo-compile_data"&gt;compile_data&lt;/a&gt;, &lt;a href="#CrateInfo-deps"&gt;deps&lt;/a&gt;, &lt;a href="#CrateInfo-edition"&gt;edition&lt;/a&gt;, &lt;a href="#CrateInfo-is_test"&gt;is_test&lt;/a&gt;, &lt;a href="#CrateInfo-name"&gt;name&lt;/a&gt;, &lt;a href="#CrateInfo-output"&gt;output&lt;/a&gt;, &lt;a href="#CrateInfo-owner"&gt;owner&lt;/a&gt;, &lt;a href="#CrateInfo-proc_macro_deps"&gt;proc_macro_deps&lt;/a&gt;, &lt;a href="#CrateInfo-root"&gt;root&lt;/a&gt;,
          &lt;a href="#CrateInfo-rustc_env"&gt;rustc_env&lt;/a&gt;, &lt;a href="#CrateInfo-srcs"&gt;srcs&lt;/a&gt;, &lt;a href="#CrateInfo-type"&gt;type&lt;/a&gt;, &lt;a href="#CrateInfo-wrapped_crate_type"&gt;wrapped_crate_type&lt;/a&gt;)
&lt;/pre&gt;
<p>A provider containing general Crate information.</p>
<p><strong>FIELDS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="CrateInfo-aliases"&gt;&lt;/a&gt;aliases</td><td style="text-align: left">Dict[Label, String]: Renamed and aliased crates</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-compile_data"&gt;&lt;/a&gt;compile_data</td><td style="text-align: left">depset[File]: Compile data required by this crate.</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">depset[DepVariantInfo]: This crate's (rust or cc) dependencies' providers.</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">str: The edition of this crate.</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-is_test"&gt;&lt;/a&gt;is_test</td><td style="text-align: left">bool: If the crate is being compiled in a test context</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">str: The name of this crate.</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-output"&gt;&lt;/a&gt;output</td><td style="text-align: left">File: The output File that will be produced, depends on crate type.</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-owner"&gt;&lt;/a&gt;owner</td><td style="text-align: left">Label: The label of the target that produced this CrateInfo</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-proc_macro_deps"&gt;&lt;/a&gt;proc_macro_deps</td><td style="text-align: left">depset[DepVariantInfo]: This crate's rust proc_macro dependencies' providers.</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-root"&gt;&lt;/a&gt;root</td><td style="text-align: left">File: The source File entrypoint to this crate, eg. lib.rs</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-rustc_env"&gt;&lt;/a&gt;rustc_env</td><td style="text-align: left">Dict[String, String]: Additional &lt;code&gt;"key": "value"&lt;/code&gt; environment variables to set for rustc.</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">depset[File]: All source Files that are part of the crate.</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-type"&gt;&lt;/a&gt;type</td><td style="text-align: left">str: The type of this crate (see <a href="https://doc.rust-lang.org/rustc/command-line-arguments.html#--crate-type-a-list-of-types-of-crates-for-the-compiler-to-emit">rustc --crate-type</a>).</td></tr>
<tr><td style="text-align: left">&lt;a id="CrateInfo-wrapped_crate_type"&gt;&lt;/a&gt;wrapped_crate_type</td><td style="text-align: left">str, optional: The original crate type for targets generated using a previously defined crate (typically tests using the &lt;code&gt;rust_test::crate&lt;/code&gt; attribute)</td></tr>
</tbody></table>
<p>&lt;a id="#DepInfo"&gt;&lt;/a&gt;</p>
<h2>DepInfo</h2>
&lt;pre&gt;
DepInfo(&lt;a href="#DepInfo-dep_env"&gt;dep_env&lt;/a&gt;, &lt;a href="#DepInfo-direct_crates"&gt;direct_crates&lt;/a&gt;, &lt;a href="#DepInfo-link_search_path_files"&gt;link_search_path_files&lt;/a&gt;, &lt;a href="#DepInfo-transitive_build_infos"&gt;transitive_build_infos&lt;/a&gt;,
        &lt;a href="#DepInfo-transitive_crate_outputs"&gt;transitive_crate_outputs&lt;/a&gt;, &lt;a href="#DepInfo-transitive_crates"&gt;transitive_crates&lt;/a&gt;, &lt;a href="#DepInfo-transitive_noncrates"&gt;transitive_noncrates&lt;/a&gt;)
&lt;/pre&gt;
<p>A provider containing information about a Crate's dependencies.</p>
<p><strong>FIELDS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="DepInfo-dep_env"&gt;&lt;/a&gt;dep_env</td><td style="text-align: left">File: File with environment variables direct dependencies build scripts rely upon.</td></tr>
<tr><td style="text-align: left">&lt;a id="DepInfo-direct_crates"&gt;&lt;/a&gt;direct_crates</td><td style="text-align: left">depset[AliasableDepInfo]</td></tr>
<tr><td style="text-align: left">&lt;a id="DepInfo-link_search_path_files"&gt;&lt;/a&gt;link_search_path_files</td><td style="text-align: left">depset[File]: All transitive files containing search paths to pass to the linker</td></tr>
<tr><td style="text-align: left">&lt;a id="DepInfo-transitive_build_infos"&gt;&lt;/a&gt;transitive_build_infos</td><td style="text-align: left">depset[BuildInfo]</td></tr>
<tr><td style="text-align: left">&lt;a id="DepInfo-transitive_crate_outputs"&gt;&lt;/a&gt;transitive_crate_outputs</td><td style="text-align: left">depset[File]: All transitive crate outputs.</td></tr>
<tr><td style="text-align: left">&lt;a id="DepInfo-transitive_crates"&gt;&lt;/a&gt;transitive_crates</td><td style="text-align: left">depset[CrateInfo]</td></tr>
<tr><td style="text-align: left">&lt;a id="DepInfo-transitive_noncrates"&gt;&lt;/a&gt;transitive_noncrates</td><td style="text-align: left">depset[LinkerInput]: All transitive dependencies that aren't crates.</td></tr>
</tbody></table>
<p>&lt;a id="#StdLibInfo"&gt;&lt;/a&gt;</p>
<h2>StdLibInfo</h2>
&lt;pre&gt;
StdLibInfo(&lt;a href="#StdLibInfo-alloc_files"&gt;alloc_files&lt;/a&gt;, &lt;a href="#StdLibInfo-between_alloc_and_core_files"&gt;between_alloc_and_core_files&lt;/a&gt;, &lt;a href="#StdLibInfo-between_core_and_std_files"&gt;between_core_and_std_files&lt;/a&gt;, &lt;a href="#StdLibInfo-core_files"&gt;core_files&lt;/a&gt;,
           &lt;a href="#StdLibInfo-dot_a_files"&gt;dot_a_files&lt;/a&gt;, &lt;a href="#StdLibInfo-memchr_files"&gt;memchr_files&lt;/a&gt;, &lt;a href="#StdLibInfo-self_contained_files"&gt;self_contained_files&lt;/a&gt;, &lt;a href="#StdLibInfo-srcs"&gt;srcs&lt;/a&gt;, &lt;a href="#StdLibInfo-std_files"&gt;std_files&lt;/a&gt;, &lt;a href="#StdLibInfo-std_rlibs"&gt;std_rlibs&lt;/a&gt;)
&lt;/pre&gt;
<p>A collection of files either found within the <code>rust-stdlib</code> artifact or generated based on existing files.</p>
<p><strong>FIELDS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-alloc_files"&gt;&lt;/a&gt;alloc_files</td><td style="text-align: left">List[File]: &lt;code&gt;.a&lt;/code&gt; files related to the &lt;code&gt;alloc&lt;/code&gt; module.</td></tr>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-between_alloc_and_core_files"&gt;&lt;/a&gt;between_alloc_and_core_files</td><td style="text-align: left">List[File]: &lt;code&gt;.a&lt;/code&gt; files related to the &lt;code&gt;compiler_builtins&lt;/code&gt; module.</td></tr>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-between_core_and_std_files"&gt;&lt;/a&gt;between_core_and_std_files</td><td style="text-align: left">List[File]: &lt;code&gt;.a&lt;/code&gt; files related to all modules except &lt;code&gt;adler&lt;/code&gt;, &lt;code&gt;alloc&lt;/code&gt;, &lt;code&gt;compiler_builtins&lt;/code&gt;, &lt;code&gt;core&lt;/code&gt;, and &lt;code&gt;std&lt;/code&gt;.</td></tr>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-core_files"&gt;&lt;/a&gt;core_files</td><td style="text-align: left">List[File]: &lt;code&gt;.a&lt;/code&gt; files related to the &lt;code&gt;core&lt;/code&gt; and &lt;code&gt;adler&lt;/code&gt; modules</td></tr>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-dot_a_files"&gt;&lt;/a&gt;dot_a_files</td><td style="text-align: left">Depset[File]: Generated &lt;code&gt;.a&lt;/code&gt; files</td></tr>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-memchr_files"&gt;&lt;/a&gt;memchr_files</td><td style="text-align: left">Depset[File]: &lt;code&gt;.a&lt;/code&gt; files associated with the &lt;code&gt;memchr&lt;/code&gt; module.</td></tr>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-self_contained_files"&gt;&lt;/a&gt;self_contained_files</td><td style="text-align: left">List[File]: All &lt;code&gt;.o&lt;/code&gt; files from the &lt;code&gt;self-contained&lt;/code&gt; directory.</td></tr>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">List[Target]: All targets from the original &lt;code&gt;srcs&lt;/code&gt; attribute.</td></tr>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-std_files"&gt;&lt;/a&gt;std_files</td><td style="text-align: left">Depset[File]: &lt;code&gt;.a&lt;/code&gt; files associated with the &lt;code&gt;std&lt;/code&gt; module.</td></tr>
<tr><td style="text-align: left">&lt;a id="StdLibInfo-std_rlibs"&gt;&lt;/a&gt;std_rlibs</td><td style="text-align: left">List[File]: All &lt;code&gt;.rlib&lt;/code&gt; files</td></tr>
</tbody></table>
<p>&lt;a id="#cargo_build_script"&gt;&lt;/a&gt;</p>
<h2>cargo_build_script</h2>
&lt;pre&gt;
cargo_build_script(&lt;a href="#cargo_build_script-name"&gt;name&lt;/a&gt;, &lt;a href="#cargo_build_script-crate_features"&gt;crate_features&lt;/a&gt;, &lt;a href="#cargo_build_script-version"&gt;version&lt;/a&gt;, &lt;a href="#cargo_build_script-deps"&gt;deps&lt;/a&gt;, &lt;a href="#cargo_build_script-build_script_env"&gt;build_script_env&lt;/a&gt;, &lt;a href="#cargo_build_script-data"&gt;data&lt;/a&gt;, &lt;a href="#cargo_build_script-tools"&gt;tools&lt;/a&gt;, &lt;a href="#cargo_build_script-links"&gt;links&lt;/a&gt;,
                   &lt;a href="#cargo_build_script-rustc_env"&gt;rustc_env&lt;/a&gt;, &lt;a href="#cargo_build_script-rustc_flags"&gt;rustc_flags&lt;/a&gt;, &lt;a href="#cargo_build_script-visibility"&gt;visibility&lt;/a&gt;, &lt;a href="#cargo_build_script-tags"&gt;tags&lt;/a&gt;, &lt;a href="#cargo_build_script-kwargs"&gt;kwargs&lt;/a&gt;)
&lt;/pre&gt;
<p>Compile and execute a rust build script to generate build attributes</p>
<p>This rules take the same arguments as rust_binary.</p>
<p>Example:</p>
<p>Suppose you have a crate with a cargo build script <code>build.rs</code>:</p>
<pre>[workspace]/
    hello_lib/
        BUILD
        build.rs
        src/
            lib.rs
</pre>
<p>Then you want to use the build script in the following:</p>
<p><code>hello_lib/BUILD</code>:</p>
<pre class="language-python"><a-f>package</a-f>(<a-v>default_visibility</a-v> <a-o>=</a-o> [<a-s>&quot;//visibility:public&quot;</a-s>])

<a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_binary&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>)
<a-f>load</a-f>(<a-s>&quot;@rules_rust//cargo:cargo_build_script.bzl&quot;</a-s>, <a-s>&quot;cargo_build_script&quot;</a-s>)

<a-c># This will run the build script from the root of the workspace, and</a-c>
<a-c># collect the outputs.</a-c>
<a-f>cargo_build_script</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;build_script&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;build.rs&quot;</a-s>],
    <a-c># Optional environment variables passed during build.rs compilation</a-c>
    <a-v>rustc_env</a-v> <a-o>=</a-o> {
       <a-s>&quot;CARGO_PKG_VERSION&quot;</a-s>: <a-s>&quot;0.1.2&quot;</a-s>,
    },
    <a-c># Optional environment variables passed during build.rs execution.</a-c>
    <a-c># Note that as the build script&#39;s working directory is not execroot,</a-c>
    <a-c># execpath/location will return an absolute path, instead of a relative</a-c>
    <a-c># one.</a-c>
    <a-v>build_script_env</a-v> <a-o>=</a-o> {
        <a-s>&quot;SOME_TOOL_OR_FILE&quot;</a-s>: <a-s>&quot;$(execpath @tool//:binary)&quot;</a-s>
    }
    <a-c># Optional data/tool dependencies</a-c>
    <a-v>data</a-v> <a-o>=</a-o> [<a-s>&quot;@tool//:binary&quot;</a-s>],
)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [
        <a-s>&quot;src/lib.rs&quot;</a-s>,
    ],
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;:build_script&quot;</a-s>],
)</pre>
<p>The <code>hello_lib</code> target will be build with the flags and the environment variables declared by the     build script in addition to the file generated by it.</p>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">The name for the underlying rule. This should be the name of the package being compiled, optionally with a suffix of _build_script.</td><td style="text-align: left">none</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-crate_features"&gt;&lt;/a&gt;crate_features</td><td style="text-align: left">A list of features to enable for the build script.</td><td style="text-align: left">&lt;code&gt;[]&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">The semantic version (semver) of the crate.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">The dependencies of the crate.</td><td style="text-align: left">&lt;code&gt;[]&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-build_script_env"&gt;&lt;/a&gt;build_script_env</td><td style="text-align: left">Environment variables for build scripts.</td><td style="text-align: left">&lt;code&gt;{}&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-data"&gt;&lt;/a&gt;data</td><td style="text-align: left">Files needed by the build script.</td><td style="text-align: left">&lt;code&gt;[]&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-tools"&gt;&lt;/a&gt;tools</td><td style="text-align: left">Tools (executables) needed by the build script.</td><td style="text-align: left">&lt;code&gt;[]&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-links"&gt;&lt;/a&gt;links</td><td style="text-align: left">Name of the native library this crate links against.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-rustc_env"&gt;&lt;/a&gt;rustc_env</td><td style="text-align: left">Environment variables to set in rustc when compiling the build script.</td><td style="text-align: left">&lt;code&gt;{}&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-rustc_flags"&gt;&lt;/a&gt;rustc_flags</td><td style="text-align: left">List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.</td><td style="text-align: left">&lt;code&gt;[]&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-visibility"&gt;&lt;/a&gt;visibility</td><td style="text-align: left">Visibility to apply to the generated build script output.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-tags"&gt;&lt;/a&gt;tags</td><td style="text-align: left">(list of str, optional): Tags to apply to the generated build script output.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="cargo_build_script-kwargs"&gt;&lt;/a&gt;kwargs</td><td style="text-align: left">Forwards to the underlying &lt;code&gt;rust_binary&lt;/code&gt; rule.</td><td style="text-align: left">none</td></tr>
</tbody></table>
<p>&lt;a id="#cargo_env"&gt;&lt;/a&gt;</p>
<h2>cargo_env</h2>
&lt;pre&gt;
cargo_env(&lt;a href="#cargo_env-env"&gt;env&lt;/a&gt;)
&lt;/pre&gt;
<p>A helper for generating platform specific environment variables</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_common&quot;</a-s>)
<a-f>load</a-f>(<a-s>&quot;@rules_rust//cargo:defs.bzl&quot;</a-s>, <a-s>&quot;cargo_bootstrap_repository&quot;</a-s>, <a-s>&quot;cargo_env&quot;</a-s>)

<a-f>cargo_bootstrap_repository</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;bootstrapped_bin&quot;</a-s>,
    <a-v>cargo_lockfile</a-v> <a-o>=</a-o> <a-s>&quot;//:Cargo.lock&quot;</a-s>,
    <a-v>cargo_toml</a-v> <a-o>=</a-o> <a-s>&quot;//:Cargo.toml&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;//:resolver_srcs&quot;</a-s>],
    <a-v>version</a-v> <a-o>=</a-o> <a-v>rust_common</a-v>.<a-pr>default_version</a-pr>,
    <a-v>binary</a-v> <a-o>=</a-o> <a-s>&quot;my-crate-binary&quot;</a-s>,
    <a-v>env</a-v> <a-o>=</a-o> {
        <a-s>&quot;x86_64-unknown-linux-gnu&quot;</a-s>: <a-f>cargo_env</a-f>({
            <a-s>&quot;FOO&quot;</a-s>: <a-s>&quot;BAR&quot;</a-s>,
        }),
    },
    <a-v>env_label</a-v> <a-o>=</a-o> {
        <a-s>&quot;aarch64-unknown-linux-musl&quot;</a-s>: <a-f>cargo_env</a-f>({
            <a-s>&quot;DOC&quot;</a-s>: <a-s>&quot;//:README.md&quot;</a-s>,
        }),
    }
)</pre>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="cargo_env-env"&gt;&lt;/a&gt;env</td><td style="text-align: left">A map of environment variables</td><td style="text-align: left">none</td></tr>
</tbody></table>
<p><strong>RETURNS</strong></p>
<p>str: A json encoded string of the environment variables</p>
<p>&lt;a id="#rules_rust_dependencies"&gt;&lt;/a&gt;</p>
<h2>rules_rust_dependencies</h2>
&lt;pre&gt;
rules_rust_dependencies()
&lt;/pre&gt;
<p>Dependencies used in the implementation of <code>rules_rust</code>.</p>
<p>&lt;a id="#rust_bindgen_dependencies"&gt;&lt;/a&gt;</p>
<h2>rust_bindgen_dependencies</h2>
&lt;pre&gt;
rust_bindgen_dependencies()
&lt;/pre&gt;
<p>Declare dependencies needed for bindgen.</p>
<p>&lt;a id="#rust_bindgen_library"&gt;&lt;/a&gt;</p>
<h2>rust_bindgen_library</h2>
&lt;pre&gt;
rust_bindgen_library(&lt;a href="#rust_bindgen_library-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_bindgen_library-header"&gt;header&lt;/a&gt;, &lt;a href="#rust_bindgen_library-cc_lib"&gt;cc_lib&lt;/a&gt;, &lt;a href="#rust_bindgen_library-bindgen_flags"&gt;bindgen_flags&lt;/a&gt;, &lt;a href="#rust_bindgen_library-clang_flags"&gt;clang_flags&lt;/a&gt;, &lt;a href="#rust_bindgen_library-rustfmt"&gt;rustfmt&lt;/a&gt;, &lt;a href="#rust_bindgen_library-kwargs"&gt;kwargs&lt;/a&gt;)
&lt;/pre&gt;
<p>Generates a rust source file for <code>header</code>, and builds a rust_library.</p>
<p>Arguments are the same as <code>rust_bindgen</code>, and <code>kwargs</code> are passed directly to rust_library.</p>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_library-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">none</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_library-header"&gt;&lt;/a&gt;header</td><td style="text-align: left">The label of the .h file to generate bindings for.</td><td style="text-align: left">none</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_library-cc_lib"&gt;&lt;/a&gt;cc_lib</td><td style="text-align: left">The label of the cc_library that contains the .h file. This is used to find the transitive includes.</td><td style="text-align: left">none</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_library-bindgen_flags"&gt;&lt;/a&gt;bindgen_flags</td><td style="text-align: left">Flags to pass directly to the bindgen executable. See https://rust-lang.github.io/rust-bindgen/ for details.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_library-clang_flags"&gt;&lt;/a&gt;clang_flags</td><td style="text-align: left">Flags to pass directly to the clang executable.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_library-rustfmt"&gt;&lt;/a&gt;rustfmt</td><td style="text-align: left">Enable or disable running rustfmt on the generated file.</td><td style="text-align: left">&lt;code&gt;True&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_library-kwargs"&gt;&lt;/a&gt;kwargs</td><td style="text-align: left">Arguments to forward to the underlying &lt;code&gt;rust_library&lt;/code&gt; rule.</td><td style="text-align: left">none</td></tr>
</tbody></table>
<p>&lt;a id="#rust_bindgen_register_toolchains"&gt;&lt;/a&gt;</p>
<h2>rust_bindgen_register_toolchains</h2>
&lt;pre&gt;
rust_bindgen_register_toolchains(&lt;a href="#rust_bindgen_register_toolchains-register_toolchains"&gt;register_toolchains&lt;/a&gt;)
&lt;/pre&gt;
<p>Registers the default toolchains for the <code>rules_rust</code> <a href="https://rust-lang.github.io/rust-bindgen/">bindgen</a> rules.</p>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_bindgen_register_toolchains-register_toolchains"&gt;&lt;/a&gt;register_toolchains</td><td style="text-align: left">Whether or not to register toolchains.</td><td style="text-align: left">&lt;code&gt;True&lt;/code&gt;</td></tr>
</tbody></table>
<p>&lt;a id="#rust_proto_repositories"&gt;&lt;/a&gt;</p>
<h2>rust_proto_repositories</h2>
&lt;pre&gt;
rust_proto_repositories(&lt;a href="#rust_proto_repositories-register_default_toolchain"&gt;register_default_toolchain&lt;/a&gt;)
&lt;/pre&gt;
<p>Declare dependencies needed for proto compilation.</p>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_proto_repositories-register_default_toolchain"&gt;&lt;/a&gt;register_default_toolchain</td><td style="text-align: left">If True, the default <a href="#rust_proto_toolchain">rust_proto_toolchain</a> (&lt;code&gt;@rules_rust//proto:default-proto-toolchain&lt;/code&gt;) is registered. This toolchain requires a set of dependencies that were generated using <a href="https://github.com/google/cargo-raze">cargo raze</a>. These will also be loaded.</td><td style="text-align: left">&lt;code&gt;True&lt;/code&gt;</td></tr>
</tbody></table>
<p>&lt;a id="#rust_proto_transitive_repositories"&gt;&lt;/a&gt;</p>
<h2>rust_proto_transitive_repositories</h2>
&lt;pre&gt;
rust_proto_transitive_repositories()
&lt;/pre&gt;
<p>Load transitive dependencies of the <code>@rules_rust//proto</code> rules.</p>
<p>This macro should be called immediately after the <code>rust_proto_repositories</code> macro.</p>
<p>&lt;a id="#rust_register_toolchains"&gt;&lt;/a&gt;</p>
<h2>rust_register_toolchains</h2>
&lt;pre&gt;
rust_register_toolchains(&lt;a href="#rust_register_toolchains-dev_components"&gt;dev_components&lt;/a&gt;, &lt;a href="#rust_register_toolchains-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_register_toolchains-include_rustc_srcs"&gt;include_rustc_srcs&lt;/a&gt;, &lt;a href="#rust_register_toolchains-iso_date"&gt;iso_date&lt;/a&gt;, &lt;a href="#rust_register_toolchains-register_toolchains"&gt;register_toolchains&lt;/a&gt;,
                         &lt;a href="#rust_register_toolchains-rustfmt_version"&gt;rustfmt_version&lt;/a&gt;, &lt;a href="#rust_register_toolchains-sha256s"&gt;sha256s&lt;/a&gt;, &lt;a href="#rust_register_toolchains-extra_target_triples"&gt;extra_target_triples&lt;/a&gt;, &lt;a href="#rust_register_toolchains-urls"&gt;urls&lt;/a&gt;, &lt;a href="#rust_register_toolchains-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>Emits a default set of toolchains for Linux, MacOS, and Freebsd</p>
<p>Skip this macro and call the <code>rust_repository_set</code> macros directly if you need a compiler for     other hosts or for additional target triples.</p>
<p>The <code>sha256</code> attribute represents a dict associating tool subdirectories to sha256 hashes. As an example:</p>
<pre class="language-python">{
    <a-s>&quot;rust-1.46.0-x86_64-unknown-linux-gnu&quot;</a-s>: <a-s>&quot;e3b98bc3440fe92817881933f9564389eccb396f5f431f33d48b979fa2fbdcf5&quot;</a-s>,
    <a-s>&quot;rustfmt-1.4.12-x86_64-unknown-linux-gnu&quot;</a-s>: <a-s>&quot;1894e76913303d66bf40885a601462844eec15fca9e76a6d13c390d7000d64b0&quot;</a-s>,
    <a-s>&quot;rust-std-1.46.0-x86_64-unknown-linux-gnu&quot;</a-s>: <a-s>&quot;ac04aef80423f612c0079829b504902de27a6997214eb58ab0765d02f7ec1dbc&quot;</a-s>,
}</pre>
<p>This would match for <code>exec_triple = "x86_64-unknown-linux-gnu"</code>.  If not specified, rules_rust pulls from a non-exhaustive     list of known checksums..</p>
<p>See <code>load_arbitrary_tool</code> in <code>@rules_rust//rust:repositories.bzl</code> for more details.</p>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-dev_components"&gt;&lt;/a&gt;dev_components</td><td style="text-align: left">Whether to download the rustc-dev components (defaults to False). Requires version to be "nightly".</td><td style="text-align: left">&lt;code&gt;False&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The rust edition to be used by default (2015, 2018, or 2021). If absent, every target is required to specify its &lt;code&gt;edition&lt;/code&gt; attribute.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-include_rustc_srcs"&gt;&lt;/a&gt;include_rustc_srcs</td><td style="text-align: left">Whether to download rustc's src code. This is required in order to use rust-analyzer support. See <a href="#rust_toolchain_repository-include_rustc_srcs">rust_toolchain_repository.include_rustc_srcs</a>. for more details</td><td style="text-align: left">&lt;code&gt;False&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-iso_date"&gt;&lt;/a&gt;iso_date</td><td style="text-align: left">The date of the nightly or beta release (ignored if the version is a specific version).</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-register_toolchains"&gt;&lt;/a&gt;register_toolchains</td><td style="text-align: left">If true, repositories will be generated to produce and register &lt;code&gt;rust_toolchain&lt;/code&gt; targets.</td><td style="text-align: left">&lt;code&gt;True&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-rustfmt_version"&gt;&lt;/a&gt;rustfmt_version</td><td style="text-align: left">The version of rustfmt. Either "nightly", "beta", or an exact version. Defaults to &lt;code&gt;version&lt;/code&gt; if not specified.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-sha256s"&gt;&lt;/a&gt;sha256s</td><td style="text-align: left">A dict associating tool subdirectories to sha256 hashes.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-extra_target_triples"&gt;&lt;/a&gt;extra_target_triples</td><td style="text-align: left">Additional rust-style targets that rust toolchains should support.</td><td style="text-align: left">&lt;code&gt;["wasm32-unknown-unknown", "wasm32-wasi"]&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-urls"&gt;&lt;/a&gt;urls</td><td style="text-align: left">A list of mirror urls containing the tools from the Rust-lang static file server. These must contain the '{}' used to substitute the tool being fetched (using .format).</td><td style="text-align: left">&lt;code&gt;["https://static.rust-lang.org/dist/{}.tar.gz"]&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_register_toolchains-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">The version of Rust. Either "nightly", "beta", or an exact version. Defaults to a modern version.</td><td style="text-align: left">&lt;code&gt;"1.62.0"&lt;/code&gt;</td></tr>
</tbody></table>
<p>&lt;a id="#rust_repositories"&gt;&lt;/a&gt;</p>
<h2>rust_repositories</h2>
&lt;pre&gt;
rust_repositories(&lt;a href="#rust_repositories-kwargs"&gt;kwargs&lt;/a&gt;)
&lt;/pre&gt;
<p><strong>Deprecated</strong>: Use <a href="#rules_rust_dependencies">rules_rust_dependencies</a>     and <a href="#rust_register_toolchains">rust_register_toolchains</a> directly.</p>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_repositories-kwargs"&gt;&lt;/a&gt;kwargs</td><td style="text-align: left">Keyword arguments for the &lt;code&gt;rust_register_toolchains&lt;/code&gt; macro.</td><td style="text-align: left">none</td></tr>
</tbody></table>
<p>&lt;a id="#rust_repository_set"&gt;&lt;/a&gt;</p>
<h2>rust_repository_set</h2>
&lt;pre&gt;
rust_repository_set(&lt;a href="#rust_repository_set-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_repository_set-version"&gt;version&lt;/a&gt;, &lt;a href="#rust_repository_set-exec_triple"&gt;exec_triple&lt;/a&gt;, &lt;a href="#rust_repository_set-include_rustc_srcs"&gt;include_rustc_srcs&lt;/a&gt;, &lt;a href="#rust_repository_set-extra_target_triples"&gt;extra_target_triples&lt;/a&gt;, &lt;a href="#rust_repository_set-iso_date"&gt;iso_date&lt;/a&gt;,
                    &lt;a href="#rust_repository_set-rustfmt_version"&gt;rustfmt_version&lt;/a&gt;, &lt;a href="#rust_repository_set-edition"&gt;edition&lt;/a&gt;, &lt;a href="#rust_repository_set-dev_components"&gt;dev_components&lt;/a&gt;, &lt;a href="#rust_repository_set-sha256s"&gt;sha256s&lt;/a&gt;, &lt;a href="#rust_repository_set-urls"&gt;urls&lt;/a&gt;, &lt;a href="#rust_repository_set-auth"&gt;auth&lt;/a&gt;, &lt;a href="#rust_repository_set-register_toolchain"&gt;register_toolchain&lt;/a&gt;)
&lt;/pre&gt;
<p>Assembles a remote repository for the given toolchain params, produces a proxy repository     to contain the toolchain declaration, and registers the toolchains.</p>
<p>N.B. A "proxy repository" is needed to allow for registering the toolchain (with constraints)     without actually downloading the toolchain.</p>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">The name of the generated repository</td><td style="text-align: left">none</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">The version of the tool among "nightly", "beta', or an exact version.</td><td style="text-align: left">none</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-exec_triple"&gt;&lt;/a&gt;exec_triple</td><td style="text-align: left">The Rust-style target that this compiler runs on</td><td style="text-align: left">none</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-include_rustc_srcs"&gt;&lt;/a&gt;include_rustc_srcs</td><td style="text-align: left">Whether to download rustc's src code. This is required in order to use rust-analyzer support. Defaults to False.</td><td style="text-align: left">&lt;code&gt;False&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-extra_target_triples"&gt;&lt;/a&gt;extra_target_triples</td><td style="text-align: left">Additional rust-style targets that this set of toolchains should support. Defaults to [].</td><td style="text-align: left">&lt;code&gt;[]&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-iso_date"&gt;&lt;/a&gt;iso_date</td><td style="text-align: left">The date of the tool. Defaults to None.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-rustfmt_version"&gt;&lt;/a&gt;rustfmt_version</td><td style="text-align: left">The version of rustfmt to be associated with the toolchain. Defaults to None.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-edition"&gt;&lt;/a&gt;edition</td><td style="text-align: left">The rust edition to be used by default (2015, 2018, or 2021). If absent, every rule is required to specify its &lt;code&gt;edition&lt;/code&gt; attribute.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-dev_components"&gt;&lt;/a&gt;dev_components</td><td style="text-align: left">Whether to download the rustc-dev components. Requires version to be "nightly". Defaults to False.</td><td style="text-align: left">&lt;code&gt;False&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-sha256s"&gt;&lt;/a&gt;sha256s</td><td style="text-align: left">A dict associating tool subdirectories to sha256 hashes. See <a href="#rust_repositories">rust_repositories</a> for more details.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-urls"&gt;&lt;/a&gt;urls</td><td style="text-align: left">A list of mirror urls containing the tools from the Rust-lang static file server. These must contain the '{}' used to substitute the tool being fetched (using .format). Defaults to ['https://static.rust-lang.org/dist/{}.tar.gz']</td><td style="text-align: left">&lt;code&gt;["https://static.rust-lang.org/dist/{}.tar.gz"]&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-auth"&gt;&lt;/a&gt;auth</td><td style="text-align: left">Auth object compatible with repository_ctx.download to use when downloading files. See <a href="https://docs.bazel.build/versions/main/skylark/lib/repository_ctx.html#download">repository_ctx.download</a> for more details.</td><td style="text-align: left">&lt;code&gt;None&lt;/code&gt;</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_repository_set-register_toolchain"&gt;&lt;/a&gt;register_toolchain</td><td style="text-align: left">If True, the generated &lt;code&gt;rust_toolchain&lt;/code&gt; target will become a registered toolchain.</td><td style="text-align: left">&lt;code&gt;True&lt;/code&gt;</td></tr>
</tbody></table>
<p>&lt;a id="#rust_test_suite"&gt;&lt;/a&gt;</p>
<h2>rust_test_suite</h2>
&lt;pre&gt;
rust_test_suite(&lt;a href="#rust_test_suite-name"&gt;name&lt;/a&gt;, &lt;a href="#rust_test_suite-srcs"&gt;srcs&lt;/a&gt;, &lt;a href="#rust_test_suite-kwargs"&gt;kwargs&lt;/a&gt;)
&lt;/pre&gt;
<p>A rule for creating a test suite for a set of <code>rust_test</code> targets.</p>
<p>This rule can be used for setting up typical rust <a href="https://doc.rust-lang.org/rust-by-example/testing/integration_testing.html">integration tests</a>. Given the following
directory structure:</p>
<pre>[crate]/
    BUILD.bazel
    src/
        lib.rs
        main.rs
    tests/
        integrated_test_a.rs
        integrated_test_b.rs
        integrated_test_c.rs
        patterns/
            fibonacci_test.rs
</pre>
<p>The rule can be used to generate <a href="#rust_test">rust_test</a> targets for each source file under <code>tests</code>
and a <a href="https://docs.bazel.build/versions/master/be/general.html#test_suite">test_suite</a> which encapsulates all tests.</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_binary&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>, <a-s>&quot;rust_test_suite&quot;</a-s>)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;math_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/lib.rs&quot;</a-s>],
)

<a-f>rust_binary</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;math_bin&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/main.rs&quot;</a-s>],
)

<a-f>rust_test_suite</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;integrated_tests_suite&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> <a-f>glob</a-f>([<a-s>&quot;tests/**&quot;</a-s>]),
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;:math_lib&quot;</a-s>],
)</pre>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_test_suite-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">The name of the &lt;code&gt;test_suite&lt;/code&gt;.</td><td style="text-align: left">none</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test_suite-srcs"&gt;&lt;/a&gt;srcs</td><td style="text-align: left">All test sources, typically &lt;code&gt;glob(["tests/**/*.rs"])&lt;/code&gt;.</td><td style="text-align: left">none</td></tr>
<tr><td style="text-align: left">&lt;a id="rust_test_suite-kwargs"&gt;&lt;/a&gt;kwargs</td><td style="text-align: left">Additional keyword arguments for the underyling <a href="#rust_test">rust_test</a> targets. The &lt;code&gt;tags&lt;/code&gt; argument is also passed to the generated &lt;code&gt;test_suite&lt;/code&gt; target.</td><td style="text-align: left">none</td></tr>
</tbody></table>
<p>&lt;a id="#rust_wasm_bindgen_dependencies"&gt;&lt;/a&gt;</p>
<h2>rust_wasm_bindgen_dependencies</h2>
&lt;pre&gt;
rust_wasm_bindgen_dependencies()
&lt;/pre&gt;
<p>Declare dependencies needed for the <code>rules_rust</code> <a href="https://github.com/rustwasm/wasm-bindgen">wasm-bindgen</a> rules.</p>
<p>&lt;a id="#rust_wasm_bindgen_register_toolchains"&gt;&lt;/a&gt;</p>
<h2>rust_wasm_bindgen_register_toolchains</h2>
&lt;pre&gt;
rust_wasm_bindgen_register_toolchains(&lt;a href="#rust_wasm_bindgen_register_toolchains-register_toolchains"&gt;register_toolchains&lt;/a&gt;)
&lt;/pre&gt;
<p>Registers the default toolchains for the <code>rules_rust</code> <a href="https://github.com/rustwasm/wasm-bindgen">wasm-bindgen</a> rules.</p>
<p><strong>PARAMETERS</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Default Value</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_wasm_bindgen_register_toolchains-register_toolchains"&gt;&lt;/a&gt;register_toolchains</td><td style="text-align: left">Whether or not to register toolchains.</td><td style="text-align: left">&lt;code&gt;True&lt;/code&gt;</td></tr>
</tbody></table>
<p>&lt;a id="#rust_analyzer_aspect"&gt;&lt;/a&gt;</p>
<h2>rust_analyzer_aspect</h2>
&lt;pre&gt;
rust_analyzer_aspect(&lt;a href="#rust_analyzer_aspect-name"&gt;name&lt;/a&gt;)
&lt;/pre&gt;
<p>Annotates rust rules with RustAnalyzerInfo later used to build a rust-project.json</p>
<p><strong>ASPECT ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Type</th></tr></thead><tbody>
<tr><td style="text-align: left">deps</td><td style="text-align: left">String</td></tr>
<tr><td style="text-align: left">proc_macro_deps</td><td style="text-align: left">String</td></tr>
<tr><td style="text-align: left">crate</td><td style="text-align: left">String</td></tr>
<tr><td style="text-align: left">actual</td><td style="text-align: left">String</td></tr>
</tbody></table>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_analyzer_aspect-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
<p>&lt;a id="#rust_clippy_aspect"&gt;&lt;/a&gt;</p>
<h2>rust_clippy_aspect</h2>
&lt;pre&gt;
rust_clippy_aspect(&lt;a href="#rust_clippy_aspect-name"&gt;name&lt;/a&gt;)
&lt;/pre&gt;
<p>Executes the clippy checker on specified targets.</p>
<p>This aspect applies to existing rust_library, rust_test, and rust_binary rules.</p>
<p>As an example, if the following is defined in <code>examples/hello_lib/BUILD.bazel</code>:</p>
<pre class="language-python"><a-f>load</a-f>(<a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s>, <a-s>&quot;rust_library&quot;</a-s>, <a-s>&quot;rust_test&quot;</a-s>)

<a-f>rust_library</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_lib&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;src/lib.rs&quot;</a-s>],
)

<a-f>rust_test</a-f>(
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;greeting_test&quot;</a-s>,
    <a-v>srcs</a-v> <a-o>=</a-o> [<a-s>&quot;tests/greeting.rs&quot;</a-s>],
    <a-v>deps</a-v> <a-o>=</a-o> [<a-s>&quot;:hello_lib&quot;</a-s>],
)</pre>
<p>Then the targets can be analyzed with clippy using the following command:</p>
<pre>$ bazel build --aspects=@rules_rust//rust:defs.bzl%rust_clippy_aspect               --output_groups=clippy_checks //hello_lib:all
</pre>
<p><strong>ASPECT ATTRIBUTES</strong></p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rust_clippy_aspect-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
<p>&lt;a id="#rustfmt_aspect"&gt;&lt;/a&gt;</p>
<h2>rustfmt_aspect</h2>
&lt;pre&gt;
rustfmt_aspect(&lt;a href="#rustfmt_aspect-name"&gt;name&lt;/a&gt;)
&lt;/pre&gt;
<p>This aspect is used to gather information about a crate for use in rustfmt and perform rustfmt checks</p>
<p>Output Groups:</p>
<ul>
<li><code>rustfmt_manifest</code>: A manifest used by rustfmt binaries to provide crate specific settings.</li>
<li><code>rustfmt_checks</code>: Executes <code>rustfmt --check</code> on the specified target.</li>
</ul>
<p>The build setting <code>@rules_rust//:rustfmt.toml</code> is used to control the Rustfmt <a href="https://rust-lang.github.io/rustfmt/">configuration settings</a>
used at runtime.</p>
<p>This aspect is executed on any target which provides the <code>CrateInfo</code> provider. However
users may tag a target with <code>no-rustfmt</code> or <code>no-format</code> to have it skipped. Additionally,
generated source files are also ignored by this aspect.</p>
<p><strong>ASPECT ATTRIBUTES</strong></p>
<p><strong>ATTRIBUTES</strong></p>
<table><thead><tr><th style="text-align: left">Name</th><th style="text-align: left">Description</th><th style="text-align: left">Type</th><th style="text-align: left">Mandatory</th><th style="text-align: left">Default</th></tr></thead><tbody>
<tr><td style="text-align: left">&lt;a id="rustfmt_aspect-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">A unique name for this target.</td><td style="text-align: left">&lt;a href="https://bazel.build/docs/build-ref.html#name"&gt;Name&lt;/a&gt;</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
</tbody></table>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>#</a-p> <a-tt>Rust rules</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"><a-p>* </a-p>[CrateInfo](#CrateInfo)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"><a-p>* </a-p>[DepInfo](#DepInfo)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text"><a-p>* </a-p>[StdLibInfo](#StdLibInfo)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"><a-p>* </a-p>[capture_clippy_output](#capture_clippy_output)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"><a-p>* </a-p>[cargo_bootstrap_repository](#cargo_bootstrap_repository)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"><a-p>* </a-p>[cargo_build_script](#cargo_build_script)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"><a-p>* </a-p>[cargo_env](#cargo_env)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"><a-p>* </a-p>[error_format](#error_format)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>* </a-p>[extra_rustc_flags](#extra_rustc_flags)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"><a-p>* </a-p>[fail_when_enabled](#fail_when_enabled)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"><a-p>* </a-p>[incompatible_flag](#incompatible_flag)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"><a-p>* </a-p>[rules_rust_dependencies](#rules_rust_dependencies)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>* </a-p>[rust_analyzer_aspect](#rust_analyzer_aspect)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"><a-p>* </a-p>[rust_binary](#rust_binary)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>* </a-p>[rust_bindgen](#rust_bindgen)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"><a-p>* </a-p>[rust_bindgen_dependencies](#rust_bindgen_dependencies)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>* </a-p>[rust_bindgen_library](#rust_bindgen_library)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"><a-p>* </a-p>[rust_bindgen_register_toolchains](#rust_bindgen_register_toolchains)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>* </a-p>[rust_bindgen_toolchain](#rust_bindgen_toolchain)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>* </a-p>[rust_clippy](#rust_clippy)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p>* </a-p>[rust_clippy_aspect](#rust_clippy_aspect)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>* </a-p>[rust_doc](#rust_doc)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>* </a-p>[rust_doc_test](#rust_doc_test)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>* </a-p>[rust_grpc_library](#rust_grpc_library)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-p>* </a-p>[rust_library](#rust_library)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>* </a-p>[rust_proc_macro](#rust_proc_macro)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"><a-p>* </a-p>[rust_proto_library](#rust_proto_library)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>* </a-p>[rust_proto_repositories](#rust_proto_repositories)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"><a-p>* </a-p>[rust_proto_toolchain](#rust_proto_toolchain)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>* </a-p>[rust_proto_transitive_repositories](#rust_proto_transitive_repositories)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"><a-p>* </a-p>[rust_register_toolchains](#rust_register_toolchains)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>* </a-p>[rust_repositories](#rust_repositories)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>* </a-p>[rust_repository_set](#rust_repository_set)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>* </a-p>[rust_shared_library](#rust_shared_library)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>* </a-p>[rust_static_library](#rust_static_library)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>* </a-p>[rust_stdlib_filegroup](#rust_stdlib_filegroup)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>* </a-p>[rust_test](#rust_test)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>* </a-p>[rust_test_suite](#rust_test_suite)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>* </a-p>[rust_toolchain](#rust_toolchain)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>* </a-p>[rust_toolchain_repository](#rust_toolchain_repository)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"><a-p>* </a-p>[rust_toolchain_repository_proxy](#rust_toolchain_repository_proxy)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>* </a-p>[rust_wasm_bindgen](#rust_wasm_bindgen)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>* </a-p>[rust_wasm_bindgen_dependencies](#rust_wasm_bindgen_dependencies)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>* </a-p>[rust_wasm_bindgen_register_toolchains](#rust_wasm_bindgen_register_toolchains)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"><a-p>* </a-p>[rust_wasm_bindgen_toolchain](#rust_wasm_bindgen_toolchain)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>* </a-p>[rustfmt_aspect](#rustfmt_aspect)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>* </a-p>[rustfmt_test](#rustfmt_test)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>&lt;a id=&quot;#capture_clippy_output&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"><a-p>## </a-p><a-tt>capture_clippy_output</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"><a-p>capture_clippy_output(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#capture_clippy_output-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"><a-p>Control whether to print clippy output or store it to a file, using the configured error_format.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-p>| &lt;a id=&quot;capture_clippy_output-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>&lt;a id=&quot;#cargo_bootstrap_repository&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"><a-p>## </a-p><a-tt>cargo_bootstrap_repository</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"><a-p>cargo_bootstrap_repository(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-binary</a-s><a-p>&quot;&gt;binary&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-build_mode</a-s><a-p>&quot;&gt;build_mode&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-cargo_lockfile</a-s><a-p>&quot;&gt;cargo_lockfile&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-cargo_toml</a-s><a-p>&quot;&gt;cargo_toml&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-env</a-s><a-p>&quot;&gt;env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-env_label</a-s><a-p>&quot;&gt;env_label&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"><a-p>                           &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-iso_date</a-s><a-p>&quot;&gt;iso_date&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-repo_mapping</a-s><a-p>&quot;&gt;repo_mapping&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-rust_toolchain_cargo_template</a-s><a-p>&quot;&gt;rust_toolchain_cargo_template&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"><a-p>                           &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-rust_toolchain_repository_template</a-s><a-p>&quot;&gt;rust_toolchain_repository_template&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-rust_toolchain_rustc_template</a-s><a-p>&quot;&gt;rust_toolchain_rustc_template&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"><a-p>                           &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-timeout</a-s><a-p>&quot;&gt;timeout&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_bootstrap_repository-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"><a-p>A rule for bootstrapping a Rust binary using [Cargo](https://doc.rust-lang.org/cargo/)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-name&quot;&gt;&lt;/a&gt;name |  A unique name for this repository.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-binary&quot;&gt;&lt;/a&gt;binary |  The binary to build (the &lt;code&gt;--bin&lt;/code&gt; parameter for Cargo). If left empty, the repository name will be used.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-build_mode&quot;&gt;&lt;/a&gt;build_mode |  The build mode the binary should be built with   | String | optional | &quot;release&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-cargo_lockfile&quot;&gt;&lt;/a&gt;cargo_lockfile |  The lockfile of the crate_universe resolver   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-cargo_toml&quot;&gt;&lt;/a&gt;cargo_toml |  The path of the crate_universe resolver manifest (&lt;code&gt;Cargo.toml&lt;/code&gt; file)   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-env&quot;&gt;&lt;/a&gt;env |  A mapping of platform triple to a set of environment variables. See [cargo_env](#cargo_env) for usage details. Additionally, the platform triple &lt;code&gt;*&lt;/code&gt; applies to all platforms.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-env_label&quot;&gt;&lt;/a&gt;env_label |  A mapping of platform triple to a set of environment variables. This attribute differs from &lt;code&gt;env&lt;/code&gt; in that all variables passed here must be fully qualified labels of files. See [cargo_env](#cargo_env) for usage details. Additionally, the platform triple &lt;code&gt;*&lt;/code&gt; applies to all platforms.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-iso_date&quot;&gt;&lt;/a&gt;iso_date |  The iso_date of cargo binary the resolver should use. Note: This can only be set if &lt;code&gt;version&lt;/code&gt; is &lt;code&gt;beta&lt;/code&gt; or &lt;code&gt;nightly&lt;/code&gt;   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-repo_mapping&quot;&gt;&lt;/a&gt;repo_mapping |  A dictionary from local repository name to global repository name. This allows controls over workspace dependency resolution for dependencies of this repository.&amp;lt;p&amp;gt;For example, an entry &lt;code&gt;&quot;@foo&quot;: &quot;@bar&quot;&lt;/code&gt; declares that, for any time this repository depends on &lt;code&gt;@foo&lt;/code&gt; (such as a dependency on &lt;code&gt;@foo//some:target&lt;/code&gt;, it should actually resolve that dependency within globally-declared &lt;code&gt;@bar&lt;/code&gt; (&lt;code&gt;@bar//some:target&lt;/code&gt;).   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-rust_toolchain_cargo_template&quot;&gt;&lt;/a&gt;rust_toolchain_cargo_template |  The template to use for finding the host &lt;code&gt;cargo&lt;/code&gt; binary. &lt;code&gt;{version}&lt;/code&gt; (eg. &#39;1.53.0&#39;), &lt;code&gt;{triple}&lt;/code&gt; (eg. &#39;x86_64-unknown-linux-gnu&#39;), &lt;code&gt;{arch}&lt;/code&gt; (eg. &#39;aarch64&#39;), &lt;code&gt;{vendor}&lt;/code&gt; (eg. &#39;unknown&#39;), &lt;code&gt;{system}&lt;/code&gt; (eg. &#39;darwin&#39;), and &lt;code&gt;{tool}&lt;/code&gt; (eg. &#39;rustc.exe&#39;) will be replaced in the string if present.   | String | optional | &quot;@rust_{system}_{arch}//:bin/{tool}&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-rust_toolchain_repository_template&quot;&gt;&lt;/a&gt;rust_toolchain_repository_template |  **Deprecated**: Please use &lt;code&gt;rust_toolchain_cargo_template&lt;/code&gt; and &lt;code&gt;rust_toolchain_rustc_template&lt;/code&gt;   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-rust_toolchain_rustc_template&quot;&gt;&lt;/a&gt;rust_toolchain_rustc_template |  The template to use for finding the host &lt;code&gt;rustc&lt;/code&gt; binary. &lt;code&gt;{version}&lt;/code&gt; (eg. &#39;1.53.0&#39;), &lt;code&gt;{triple}&lt;/code&gt; (eg. &#39;x86_64-unknown-linux-gnu&#39;), &lt;code&gt;{arch}&lt;/code&gt; (eg. &#39;aarch64&#39;), &lt;code&gt;{vendor}&lt;/code&gt; (eg. &#39;unknown&#39;), &lt;code&gt;{system}&lt;/code&gt; (eg. &#39;darwin&#39;), and &lt;code&gt;{tool}&lt;/code&gt; (eg. &#39;rustc.exe&#39;) will be replaced in the string if present.   | String | optional | &quot;@rust_{system}_{arch}//:bin/{tool}&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-srcs&quot;&gt;&lt;/a&gt;srcs |  Souce files of the crate to build. Passing source files here can be used to trigger rebuilds when changes are made   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-timeout&quot;&gt;&lt;/a&gt;timeout |  Maximum duration of the Cargo build command in seconds   | Integer | optional | 600 |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_bootstrap_repository-version&quot;&gt;&lt;/a&gt;version |  The version of cargo the resolver should use   | String | optional | &quot;1.62.0&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text"><a-p>&lt;a id=&quot;#error_format&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"><a-p>## </a-p><a-tt>error_format</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text"><a-p>error_format(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#error_format-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text"><a-p>Change the [--error-format](https://doc.rust-lang.org/rustc/command-line-arguments.html#option-error-format) flag from the command line with `--@rules_rust//:error_format`. See rustc documentation for valid values.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L119" href="#L119">119</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L120" href="#L120">120</a><span class="code-text"><a-p>| &lt;a id=&quot;error_format-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L123" href="#L123">123</a><span class="code-text"><a-p>&lt;a id=&quot;#extra_rustc_flags&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L124" href="#L124">124</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L125" href="#L125">125</a><span class="code-text"><a-p>## </a-p><a-tt>extra_rustc_flags</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L126" href="#L126">126</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L127" href="#L127">127</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L128" href="#L128">128</a><span class="code-text"><a-p>extra_rustc_flags(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#extra_rustc_flags-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L131" href="#L131">131</a><span class="code-text"><a-p>Add additional rustc_flags from the command line with `--@rules_rust//:extra_rustc_flags`. This flag should only be used for flags that need to be applied across the entire build. For options that apply to individual crates, use the rustc_flags attribute on the individual crate&#39;s rule instead. NOTE: These flags not applied to the exec configuration (proc-macros, cargo_build_script, etc); use `--@rules_rust//:extra_exec_rustc_flags` to apply flags to the exec configuration.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L132" href="#L132">132</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L133" href="#L133">133</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L134" href="#L134">134</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L135" href="#L135">135</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L136" href="#L136">136</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L137" href="#L137">137</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L138" href="#L138">138</a><span class="code-text"><a-p>| &lt;a id=&quot;extra_rustc_flags-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L139" href="#L139">139</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L140" href="#L140">140</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L141" href="#L141">141</a><span class="code-text"><a-p>&lt;a id=&quot;#incompatible_flag&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text"><a-p>## </a-p><a-tt>incompatible_flag</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L144" href="#L144">144</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L145" href="#L145">145</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L146" href="#L146">146</a><span class="code-text"><a-p>incompatible_flag(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#incompatible_flag-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#incompatible_flag-issue</a-s><a-p>&quot;&gt;issue&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L148" href="#L148">148</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L149" href="#L149">149</a><span class="code-text"><a-p>A rule defining an incompatible flag.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L150" href="#L150">150</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L151" href="#L151">151</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L152" href="#L152">152</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L153" href="#L153">153</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L154" href="#L154">154</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L155" href="#L155">155</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L156" href="#L156">156</a><span class="code-text"><a-p>| &lt;a id=&quot;incompatible_flag-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L157" href="#L157">157</a><span class="code-text"><a-p>| &lt;a id=&quot;incompatible_flag-issue&quot;&gt;&lt;/a&gt;issue |  The link to the github issue associated with this flag   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L158" href="#L158">158</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L159" href="#L159">159</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L160" href="#L160">160</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_binary&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L161" href="#L161">161</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L162" href="#L162">162</a><span class="code-text"><a-p>## </a-p><a-tt>rust_binary</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L163" href="#L163">163</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L164" href="#L164">164</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L165" href="#L165">165</a><span class="code-text"><a-p>rust_binary(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-aliases</a-s><a-p>&quot;&gt;aliases&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-compile_data</a-s><a-p>&quot;&gt;compile_data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-crate_features</a-s><a-p>&quot;&gt;crate_features&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-crate_name</a-s><a-p>&quot;&gt;crate_name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-crate_root</a-s><a-p>&quot;&gt;crate_root&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-crate_type</a-s><a-p>&quot;&gt;crate_type&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-data</a-s><a-p>&quot;&gt;data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L166" href="#L166">166</a><span class="code-text"><a-p>            &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-linker_script</a-s><a-p>&quot;&gt;linker_script&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-out_binary</a-s><a-p>&quot;&gt;out_binary&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-proc_macro_deps</a-s><a-p>&quot;&gt;proc_macro_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-rustc_env</a-s><a-p>&quot;&gt;rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-rustc_env_files</a-s><a-p>&quot;&gt;rustc_env_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L167" href="#L167">167</a><span class="code-text"><a-p>            &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-rustc_flags</a-s><a-p>&quot;&gt;rustc_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-stamp</a-s><a-p>&quot;&gt;stamp&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_binary-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L168" href="#L168">168</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L169" href="#L169">169</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L170" href="#L170">170</a><span class="code-text"><a-p>Builds a Rust binary crate.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L171" href="#L171">171</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L172" href="#L172">172</a><span class="code-text"><a-p>Example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L173" href="#L173">173</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L174" href="#L174">174</a><span class="code-text"><a-p>Suppose you have the following directory structure for a Rust project with a</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L175" href="#L175">175</a><span class="code-text"><a-p>library crate, `hello_lib`, and a binary crate, `hello_world` that uses the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L176" href="#L176">176</a><span class="code-text"><a-p>`hello_lib` library:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L177" href="#L177">177</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L178" href="#L178">178</a><span class="code-text"><a-p>```</a-p><a-tl>output</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L179" href="#L179">179</a><span class="code-text"><a-p>[workspace]/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L180" href="#L180">180</a><span class="code-text"><a-p>    WORKSPACE</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L181" href="#L181">181</a><span class="code-text"><a-p>    hello_lib/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L182" href="#L182">182</a><span class="code-text"><a-p>        BUILD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L183" href="#L183">183</a><span class="code-text"><a-p>        src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L184" href="#L184">184</a><span class="code-text"><a-p>            lib.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L185" href="#L185">185</a><span class="code-text"><a-p>    hello_world/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L186" href="#L186">186</a><span class="code-text"><a-p>        BUILD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L187" href="#L187">187</a><span class="code-text"><a-p>        src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L188" href="#L188">188</a><span class="code-text"><a-p>            main.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L189" href="#L189">189</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L190" href="#L190">190</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L191" href="#L191">191</a><span class="code-text"><a-p>`hello_lib/src/lib.rs`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L192" href="#L192">192</a><span class="code-text"><a-p>```</a-p><a-tl>rust</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L193" href="#L193">193</a><span class="code-text"><a-p>pub </a-p><a-k>struct</a-k><a-p> </a-p><a-t>Greeter</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L194" href="#L194">194</a><span class="code-text"><a-p>    </a-p><a-pr>greeting</a-pr><a-p>: </a-p><a-t>String</a-t><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L195" href="#L195">195</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L196" href="#L196">196</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L197" href="#L197">197</a><span class="code-text"><a-p>impl </a-p><a-t>Greeter</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L198" href="#L198">198</a><span class="code-text"><a-p>    </a-p><a-k>pub</a-k><a-p> </a-p><a-k>fn</a-k><a-p> </a-p><a-f>new</a-f><a-p>(</a-p><a-v>greeting</a-v><a-p>: </a-p><a-o>&amp;</a-o><a-t>str</a-t><a-p>) -&gt; </a-p><a-t>Greeter</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L199" href="#L199">199</a><span class="code-text"><a-p>        </a-p><a-t>Greeter</a-t><a-p> { </a-p><a-pr>greeting</a-pr><a-p>: greeting.</a-p><a-f>to_string</a-f><a-p>(), }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L200" href="#L200">200</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L201" href="#L201">201</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L202" href="#L202">202</a><span class="code-text"><a-p>    </a-p><a-k>pub</a-k><a-p> </a-p><a-k>fn</a-k><a-p> </a-p><a-f>greet</a-f><a-p>(</a-p><a-o>&amp;</a-o><a-v>self</a-v><a-p>, </a-p><a-v>thing</a-v><a-p>: </a-p><a-o>&amp;</a-o><a-t>str</a-t><a-p>) {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L203" href="#L203">203</a><span class="code-text"><a-p>        </a-p><a-m>println!</a-m><a-p>(</a-p><a-s>&quot;{} {}&quot;</a-s><a-p>, </a-p><a-o>&amp;</a-o><a-v>self</a-v><a-p>.</a-p><a-pr>greeting</a-pr><a-p>, thing);</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L204" href="#L204">204</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L205" href="#L205">205</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L206" href="#L206">206</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L207" href="#L207">207</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L208" href="#L208">208</a><span class="code-text"><a-p>`hello_lib/BUILD`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L209" href="#L209">209</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L210" href="#L210">210</a><span class="code-text"><a-p>package(</a-p><a-v>default_visibility</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;//visibility:public&quot;</a-s><a-p>])</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L211" href="#L211">211</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L212" href="#L212">212</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L213" href="#L213">213</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L214" href="#L214">214</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L215" href="#L215">215</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L216" href="#L216">216</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L217" href="#L217">217</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L218" href="#L218">218</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L219" href="#L219">219</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L220" href="#L220">220</a><span class="code-text"><a-p>`hello_world/src/main.rs`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L221" href="#L221">221</a><span class="code-text"><a-p>```</a-p><a-tl>rust</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L222" href="#L222">222</a><span class="code-text"><a-p>extern </a-p><a-k>crate</a-k><a-p> hello_lib;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L223" href="#L223">223</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L224" href="#L224">224</a><span class="code-text"><a-p>fn </a-p><a-f>main</a-f><a-p>() {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L225" href="#L225">225</a><span class="code-text"><a-p>    </a-p><a-k>let</a-k><a-p> hello = hello_lib::</a-p><a-t>Greeter</a-t><a-p>::</a-p><a-f>new</a-f><a-p>(</a-p><a-s>&quot;Hello&quot;</a-s><a-p>);</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L226" href="#L226">226</a><span class="code-text"><a-p>    hello.</a-p><a-f>greet</a-f><a-p>(</a-p><a-s>&quot;world&quot;</a-s><a-p>);</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L227" href="#L227">227</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L228" href="#L228">228</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L229" href="#L229">229</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L230" href="#L230">230</a><span class="code-text"><a-p>`hello_world/BUILD`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L231" href="#L231">231</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L232" href="#L232">232</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_binary&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L233" href="#L233">233</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L234" href="#L234">234</a><span class="code-text"><a-p>rust_binary(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L235" href="#L235">235</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_world&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L236" href="#L236">236</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/main.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L237" href="#L237">237</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;//hello_lib&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L238" href="#L238">238</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L239" href="#L239">239</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L240" href="#L240">240</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L241" href="#L241">241</a><span class="code-text"><a-p>Build and run `hello_world`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L242" href="#L242">242</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L243" href="#L243">243</a><span class="code-text"><a-p>$ bazel run //hello_world</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L244" href="#L244">244</a><span class="code-text"><a-p>INFO: Found 1 target...</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L245" href="#L245">245</a><span class="code-text"><a-p>Target //examples/rust/hello_world:hello_world up-to-date:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L246" href="#L246">246</a><span class="code-text"><a-p>bazel-bin/examples/rust/hello_world/hello_world</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L247" href="#L247">247</a><span class="code-text"><a-p>INFO: Elapsed time: 1.308s, Critical Path: 1.22s</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L248" href="#L248">248</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L249" href="#L249">249</a><span class="code-text"><a-p>INFO: Running command line: bazel-bin/examples/rust/hello_world/hello_world</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L250" href="#L250">250</a><span class="code-text"><a-p>Hello world</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L251" href="#L251">251</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L252" href="#L252">252</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L253" href="#L253">253</a><span class="code-text"><a-p>On Windows, a PDB file containing debugging information is available under</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L254" href="#L254">254</a><span class="code-text"><a-p>the key `pdb_file` in `OutputGroupInfo`. Similarly on macOS, a dSYM folder</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L255" href="#L255">255</a><span class="code-text"><a-p>is available under the key `dsym_folder` in `OutputGroupInfo`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L256" href="#L256">256</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L257" href="#L257">257</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L258" href="#L258">258</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L259" href="#L259">259</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L260" href="#L260">260</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L261" href="#L261">261</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L262" href="#L262">262</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L263" href="#L263">263</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-aliases&quot;&gt;&lt;/a&gt;aliases |  Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: Label -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L264" href="#L264">264</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-compile_data&quot;&gt;&lt;/a&gt;compile_data |  List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the [&lt;code&gt;include_str!&lt;/code&gt;](https://doc.rust-lang.org/std/macro.include_str!.html) macro.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L265" href="#L265">265</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-crate_features&quot;&gt;&lt;/a&gt;crate_features |  List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = &quot;foo&quot;)]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature=&quot;${feature_name}&quot;&lt;/code&gt; flags.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L266" href="#L266">266</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-crate_name&quot;&gt;&lt;/a&gt;crate_name |  Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L267" href="#L267">267</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-crate_root&quot;&gt;&lt;/a&gt;crate_root |  The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L268" href="#L268">268</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-crate_type&quot;&gt;&lt;/a&gt;crate_type |  Crate type that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;This option is a temporary workaround and should be used only when building for WebAssembly targets (//rust/platform:wasi and //rust/platform:wasm).   | String | optional | &quot;bin&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L269" href="#L269">269</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-data&quot;&gt;&lt;/a&gt;data |  List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L270" href="#L270">270</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-deps&quot;&gt;&lt;/a&gt;deps |  List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L271" href="#L271">271</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-edition&quot;&gt;&lt;/a&gt;edition |  The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L272" href="#L272">272</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-linker_script&quot;&gt;&lt;/a&gt;linker_script |  Link script to forward into linker via rustc options.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L273" href="#L273">273</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-out_binary&quot;&gt;&lt;/a&gt;out_binary |  Force a target, regardless of it&#39;s &lt;code&gt;crate_type&lt;/code&gt;, to always mark the file as executable. This attribute is only used to support wasm targets but is expected to be removed following a resolution to https://github.com/bazelbuild/rules_rust/issues/771.   | Boolean | optional | False |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L274" href="#L274">274</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-proc_macro_deps&quot;&gt;&lt;/a&gt;proc_macro_deps |  List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L275" href="#L275">275</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-rustc_env&quot;&gt;&lt;/a&gt;rustc_env |  Dictionary of additional &lt;code&gt;&quot;key&quot;: &quot;value&quot;&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()&#39;s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()&#39;s documentation for more.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L276" href="#L276">276</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-rustc_env_files&quot;&gt;&lt;/a&gt;rustc_env_files |  Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to [workspace status](https://docs.bazel.build/versions/main/user-manual.html#workspace_status) stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L277" href="#L277">277</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-rustc_flags&quot;&gt;&lt;/a&gt;rustc_flags |  List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L278" href="#L278">278</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-srcs&quot;&gt;&lt;/a&gt;srcs |  List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L279" href="#L279">279</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-stamp&quot;&gt;&lt;/a&gt;stamp |  Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             [--nostamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             [--[no]stamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won&#39;t be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how [&lt;code&gt;cc_library.linkstamps&lt;/code&gt;](https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp) behaves.   | Integer | optional | -1 |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L280" href="#L280">280</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_binary-version&quot;&gt;&lt;/a&gt;version |  A version to inject in the cargo environment variable.   | String | optional | &quot;0.0.0&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L281" href="#L281">281</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L282" href="#L282">282</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L283" href="#L283">283</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_bindgen&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L284" href="#L284">284</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L285" href="#L285">285</a><span class="code-text"><a-p>## </a-p><a-tt>rust_bindgen</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L286" href="#L286">286</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L287" href="#L287">287</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L288" href="#L288">288</a><span class="code-text"><a-p>rust_bindgen(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen-bindgen_flags</a-s><a-p>&quot;&gt;bindgen_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen-cc_lib</a-s><a-p>&quot;&gt;cc_lib&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen-clang_flags</a-s><a-p>&quot;&gt;clang_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen-header</a-s><a-p>&quot;&gt;header&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen-rustfmt</a-s><a-p>&quot;&gt;rustfmt&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L289" href="#L289">289</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L290" href="#L290">290</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L291" href="#L291">291</a><span class="code-text"><a-p>Generates a rust source file from a cc_library and a header.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L292" href="#L292">292</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L293" href="#L293">293</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L294" href="#L294">294</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L295" href="#L295">295</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L296" href="#L296">296</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L297" href="#L297">297</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L298" href="#L298">298</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L299" href="#L299">299</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen-bindgen_flags&quot;&gt;&lt;/a&gt;bindgen_flags |  Flags to pass directly to the bindgen executable. See https://rust-lang.github.io/rust-bindgen/ for details.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L300" href="#L300">300</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen-cc_lib&quot;&gt;&lt;/a&gt;cc_lib |  The cc_library that contains the &lt;code&gt;.h&lt;/code&gt; file. This is used to find the transitive includes.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L301" href="#L301">301</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen-clang_flags&quot;&gt;&lt;/a&gt;clang_flags |  Flags to pass directly to the clang executable.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L302" href="#L302">302</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen-header&quot;&gt;&lt;/a&gt;header |  The &lt;code&gt;.h&lt;/code&gt; file to generate bindings for.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L303" href="#L303">303</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen-rustfmt&quot;&gt;&lt;/a&gt;rustfmt |  Enable or disable running rustfmt on the generated file.   | Boolean | optional | True |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L304" href="#L304">304</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L305" href="#L305">305</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L306" href="#L306">306</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_bindgen_toolchain&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L307" href="#L307">307</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L308" href="#L308">308</a><span class="code-text"><a-p>## </a-p><a-tt>rust_bindgen_toolchain</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L309" href="#L309">309</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L310" href="#L310">310</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L311" href="#L311">311</a><span class="code-text"><a-p>rust_bindgen_toolchain(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_toolchain-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_toolchain-bindgen</a-s><a-p>&quot;&gt;bindgen&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_toolchain-clang</a-s><a-p>&quot;&gt;clang&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_toolchain-libclang</a-s><a-p>&quot;&gt;libclang&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_toolchain-libstdcxx</a-s><a-p>&quot;&gt;libstdcxx&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_toolchain-rustfmt</a-s><a-p>&quot;&gt;rustfmt&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L312" href="#L312">312</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L313" href="#L313">313</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L314" href="#L314">314</a><span class="code-text"><a-p>The tools required for the `rust_bindgen` rule.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L315" href="#L315">315</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L316" href="#L316">316</a><span class="code-text"><a-p>This rule depends on the [`bindgen`](https://crates.io/crates/bindgen) binary crate, and it </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L317" href="#L317">317</a><span class="code-text"><a-p>in turn depends on both a clang binary and the clang library. To obtain these dependencies,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L318" href="#L318">318</a><span class="code-text"><a-p>`rust_bindgen_dependencies` imports bindgen and its dependencies.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L319" href="#L319">319</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L320" href="#L320">320</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L321" href="#L321">321</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//bindgen:bindgen.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_bindgen_toolchain&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L322" href="#L322">322</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L323" href="#L323">323</a><span class="code-text"><a-p>rust_bindgen_toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L324" href="#L324">324</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;bindgen_toolchain_impl&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L325" href="#L325">325</a><span class="code-text"><a-p>    </a-p><a-v>bindgen</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;//my/rust:bindgen&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L326" href="#L326">326</a><span class="code-text"><a-p>    </a-p><a-v>clang</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;//my/clang:clang&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L327" href="#L327">327</a><span class="code-text"><a-p>    </a-p><a-v>libclang</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;//my/clang:libclang.so&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L328" href="#L328">328</a><span class="code-text"><a-p>    </a-p><a-v>libstdcxx</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;//my/cpp:libstdc++&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L329" href="#L329">329</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L330" href="#L330">330</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L331" href="#L331">331</a><span class="code-text"><a-p>toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L332" href="#L332">332</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;bindgen_toolchain&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L333" href="#L333">333</a><span class="code-text"><a-p>    </a-p><a-v>toolchain</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;bindgen_toolchain_impl&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L334" href="#L334">334</a><span class="code-text"><a-p>    </a-p><a-v>toolchain_type</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;@rules_rust//bindgen:bindgen_toolchain&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L335" href="#L335">335</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L336" href="#L336">336</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L337" href="#L337">337</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L338" href="#L338">338</a><span class="code-text"><a-p>This toolchain will then need to be registered in the current `WORKSPACE`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L339" href="#L339">339</a><span class="code-text"><a-p>For additional information, see the [Bazel toolchains documentation](https://docs.bazel.build/versions/master/toolchains.html).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L340" href="#L340">340</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L341" href="#L341">341</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L342" href="#L342">342</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L343" href="#L343">343</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L344" href="#L344">344</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L345" href="#L345">345</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L346" href="#L346">346</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L347" href="#L347">347</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_toolchain-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L348" href="#L348">348</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_toolchain-bindgen&quot;&gt;&lt;/a&gt;bindgen |  The label of a &lt;code&gt;bindgen&lt;/code&gt; executable.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L349" href="#L349">349</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_toolchain-clang&quot;&gt;&lt;/a&gt;clang |  The label of a &lt;code&gt;clang&lt;/code&gt; executable.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L350" href="#L350">350</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_toolchain-libclang&quot;&gt;&lt;/a&gt;libclang |  A cc_library that provides bindgen&#39;s runtime dependency on libclang.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L351" href="#L351">351</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_toolchain-libstdcxx&quot;&gt;&lt;/a&gt;libstdcxx |  A cc_library that satisfies libclang&#39;s libstdc++ dependency. This is used to make the execution of clang hermetic. If None, system libraries will be used instead.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L352" href="#L352">352</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_toolchain-rustfmt&quot;&gt;&lt;/a&gt;rustfmt |  The label of a &lt;code&gt;rustfmt&lt;/code&gt; executable. If this is not provided, falls back to the rust_toolchain rustfmt.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L353" href="#L353">353</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L354" href="#L354">354</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L355" href="#L355">355</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_clippy&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L356" href="#L356">356</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L357" href="#L357">357</a><span class="code-text"><a-p>## </a-p><a-tt>rust_clippy</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L358" href="#L358">358</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L359" href="#L359">359</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L360" href="#L360">360</a><span class="code-text"><a-p>rust_clippy(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_clippy-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_clippy-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L361" href="#L361">361</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L362" href="#L362">362</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L363" href="#L363">363</a><span class="code-text"><a-p>Executes the clippy checker on a specific target.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L364" href="#L364">364</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L365" href="#L365">365</a><span class="code-text"><a-p>Similar to `rust_clippy_aspect`, but allows specifying a list of dependencies within the build system.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L366" href="#L366">366</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L367" href="#L367">367</a><span class="code-text"><a-p>For example, given the following example targets:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L368" href="#L368">368</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L369" href="#L369">369</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L370" href="#L370">370</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_test&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L371" href="#L371">371</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L372" href="#L372">372</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L373" href="#L373">373</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L374" href="#L374">374</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L375" href="#L375">375</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L376" href="#L376">376</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L377" href="#L377">377</a><span class="code-text"><a-p>rust_test(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L378" href="#L378">378</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;greeting_test&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L379" href="#L379">379</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;tests/greeting.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L380" href="#L380">380</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;:hello_lib&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L381" href="#L381">381</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L382" href="#L382">382</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L383" href="#L383">383</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L384" href="#L384">384</a><span class="code-text"><a-p>Rust clippy can be set as a build target with the following:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L385" href="#L385">385</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L386" href="#L386">386</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L387" href="#L387">387</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_clippy&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L388" href="#L388">388</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L389" href="#L389">389</a><span class="code-text"><a-p>rust_clippy(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L390" href="#L390">390</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_library_clippy&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L391" href="#L391">391</a><span class="code-text"><a-p>    </a-p><a-v>testonly</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>True</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L392" href="#L392">392</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L393" href="#L393">393</a><span class="code-text"><a-p>        </a-p><a-s>&quot;:hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L394" href="#L394">394</a><span class="code-text"><a-p>        </a-p><a-s>&quot;:greeting_test&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L395" href="#L395">395</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L396" href="#L396">396</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L397" href="#L397">397</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L398" href="#L398">398</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L399" href="#L399">399</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L400" href="#L400">400</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L401" href="#L401">401</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L402" href="#L402">402</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L403" href="#L403">403</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L404" href="#L404">404</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L405" href="#L405">405</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_clippy-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L406" href="#L406">406</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_clippy-deps&quot;&gt;&lt;/a&gt;deps |  Rust targets to run clippy on.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L407" href="#L407">407</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L408" href="#L408">408</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L409" href="#L409">409</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_doc&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L410" href="#L410">410</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L411" href="#L411">411</a><span class="code-text"><a-p>## </a-p><a-tt>rust_doc</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L412" href="#L412">412</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L413" href="#L413">413</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L414" href="#L414">414</a><span class="code-text"><a-p>rust_doc(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_doc-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_doc-crate</a-s><a-p>&quot;&gt;crate&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_doc-html_after_content</a-s><a-p>&quot;&gt;html_after_content&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_doc-html_before_content</a-s><a-p>&quot;&gt;html_before_content&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_doc-html_in_header</a-s><a-p>&quot;&gt;html_in_header&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_doc-markdown_css</a-s><a-p>&quot;&gt;markdown_css&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L415" href="#L415">415</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L416" href="#L416">416</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L417" href="#L417">417</a><span class="code-text"><a-p>Generates code documentation.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L418" href="#L418">418</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L419" href="#L419">419</a><span class="code-text"><a-p>Example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L420" href="#L420">420</a><span class="code-text"><a-p>Suppose you have the following directory structure for a Rust library crate:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L421" href="#L421">421</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L422" href="#L422">422</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L423" href="#L423">423</a><span class="code-text"><a-p>[workspace]/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L424" href="#L424">424</a><span class="code-text"><a-p>    WORKSPACE</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L425" href="#L425">425</a><span class="code-text"><a-p>    hello_lib/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L426" href="#L426">426</a><span class="code-text"><a-p>        BUILD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L427" href="#L427">427</a><span class="code-text"><a-p>        src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L428" href="#L428">428</a><span class="code-text"><a-p>            lib.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L429" href="#L429">429</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L430" href="#L430">430</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L431" href="#L431">431</a><span class="code-text"><a-p>To build [`rustdoc`][rustdoc] documentation for the `hello_lib` crate, define     a `rust_doc` rule that depends on the the `hello_lib` `rust_library` target:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L432" href="#L432">432</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L433" href="#L433">433</a><span class="code-text"><a-tu>[rustdoc]</a-tu><a-p>: </a-p><a-tu>https://doc.rust-lang.org/book/documentation.html</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L434" href="#L434">434</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L435" href="#L435">435</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L436" href="#L436">436</a><span class="code-text"><a-p>package(</a-p><a-v>default_visibility</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;//visibility:public&quot;</a-s><a-p>])</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L437" href="#L437">437</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L438" href="#L438">438</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_doc&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L439" href="#L439">439</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L440" href="#L440">440</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L441" href="#L441">441</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L442" href="#L442">442</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L443" href="#L443">443</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L444" href="#L444">444</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L445" href="#L445">445</a><span class="code-text"><a-p>rust_doc(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L446" href="#L446">446</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib_doc&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L447" href="#L447">447</a><span class="code-text"><a-p>    </a-p><a-v>crate</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;:hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L448" href="#L448">448</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L449" href="#L449">449</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L450" href="#L450">450</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L451" href="#L451">451</a><span class="code-text"><a-p>Running `bazel build //hello_lib:hello_lib_doc` will build a zip file containing     the documentation for the `hello_lib` library crate generated by `rustdoc`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L452" href="#L452">452</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L453" href="#L453">453</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L454" href="#L454">454</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L455" href="#L455">455</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L456" href="#L456">456</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L457" href="#L457">457</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L458" href="#L458">458</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L459" href="#L459">459</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_doc-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L460" href="#L460">460</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_doc-crate&quot;&gt;&lt;/a&gt;crate |  The label of the target to generate code documentation for.&lt;br&gt;&lt;br&gt;&lt;code&gt;rust_doc&lt;/code&gt; can generate HTML code documentation for the source files of &lt;code&gt;rust_library&lt;/code&gt; or &lt;code&gt;rust_binary&lt;/code&gt; targets.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L461" href="#L461">461</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_doc-html_after_content&quot;&gt;&lt;/a&gt;html_after_content |  File to add in &lt;code&gt;&amp;lt;body&amp;gt;&lt;/code&gt;, after content.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L462" href="#L462">462</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_doc-html_before_content&quot;&gt;&lt;/a&gt;html_before_content |  File to add in &lt;code&gt;&amp;lt;body&amp;gt;&lt;/code&gt;, before content.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L463" href="#L463">463</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_doc-html_in_header&quot;&gt;&lt;/a&gt;html_in_header |  File to add to &lt;code&gt;&amp;lt;head&amp;gt;&lt;/code&gt;.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L464" href="#L464">464</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_doc-markdown_css&quot;&gt;&lt;/a&gt;markdown_css |  CSS files to include via &lt;code&gt;&amp;lt;link&amp;gt;&lt;/code&gt; in a rendered Markdown file.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L465" href="#L465">465</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L466" href="#L466">466</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L467" href="#L467">467</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_doc_test&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L468" href="#L468">468</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L469" href="#L469">469</a><span class="code-text"><a-p>## </a-p><a-tt>rust_doc_test</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L470" href="#L470">470</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L471" href="#L471">471</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L472" href="#L472">472</a><span class="code-text"><a-p>rust_doc_test(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_doc_test-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_doc_test-crate</a-s><a-p>&quot;&gt;crate&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_doc_test-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L473" href="#L473">473</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L474" href="#L474">474</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L475" href="#L475">475</a><span class="code-text"><a-p>Runs Rust documentation tests.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L476" href="#L476">476</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L477" href="#L477">477</a><span class="code-text"><a-p>Example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L478" href="#L478">478</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L479" href="#L479">479</a><span class="code-text"><a-p>Suppose you have the following directory structure for a Rust library crate:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L480" href="#L480">480</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L481" href="#L481">481</a><span class="code-text"><a-p>```</a-p><a-tl>output</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L482" href="#L482">482</a><span class="code-text"><a-p>[workspace]/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L483" href="#L483">483</a><span class="code-text"><a-p>WORKSPACE</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L484" href="#L484">484</a><span class="code-text"><a-p>hello_lib/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L485" href="#L485">485</a><span class="code-text"><a-p>    BUILD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L486" href="#L486">486</a><span class="code-text"><a-p>    src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L487" href="#L487">487</a><span class="code-text"><a-p>        lib.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L488" href="#L488">488</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L489" href="#L489">489</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L490" href="#L490">490</a><span class="code-text"><a-p>To run [documentation tests][doc-test] for the `hello_lib` crate, define a `rust_doc_test`         target that depends on the `hello_lib` `rust_library` target:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L491" href="#L491">491</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L492" href="#L492">492</a><span class="code-text"><a-tu>[doc-test]</a-tu><a-p>: </a-p><a-tu>https://doc.rust-lang.org/book/documentation.html#documentation-as-tests</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L493" href="#L493">493</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L494" href="#L494">494</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L495" href="#L495">495</a><span class="code-text"><a-p>package(</a-p><a-v>default_visibility</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;//visibility:public&quot;</a-s><a-p>])</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L496" href="#L496">496</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L497" href="#L497">497</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_doc_test&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L498" href="#L498">498</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L499" href="#L499">499</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L500" href="#L500">500</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L501" href="#L501">501</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L502" href="#L502">502</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L503" href="#L503">503</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L504" href="#L504">504</a><span class="code-text"><a-p>rust_doc_test(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L505" href="#L505">505</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib_doc_test&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L506" href="#L506">506</a><span class="code-text"><a-p>    </a-p><a-v>crate</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;:hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L507" href="#L507">507</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L508" href="#L508">508</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L509" href="#L509">509</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L510" href="#L510">510</a><span class="code-text"><a-p>Running `bazel test //hello_lib:hello_lib_doc_test` will run all documentation tests for the `hello_lib` library crate.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L511" href="#L511">511</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L512" href="#L512">512</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L513" href="#L513">513</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L514" href="#L514">514</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L515" href="#L515">515</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L516" href="#L516">516</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L517" href="#L517">517</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L518" href="#L518">518</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_doc_test-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L519" href="#L519">519</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_doc_test-crate&quot;&gt;&lt;/a&gt;crate |  The label of the target to generate code documentation for. &lt;code&gt;rust_doc_test&lt;/code&gt; can generate HTML code documentation for the source files of &lt;code&gt;rust_library&lt;/code&gt; or &lt;code&gt;rust_binary&lt;/code&gt; targets.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L520" href="#L520">520</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_doc_test-deps&quot;&gt;&lt;/a&gt;deps |  List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L521" href="#L521">521</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L522" href="#L522">522</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L523" href="#L523">523</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_grpc_library&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L524" href="#L524">524</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L525" href="#L525">525</a><span class="code-text"><a-p>## </a-p><a-tt>rust_grpc_library</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L526" href="#L526">526</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L527" href="#L527">527</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L528" href="#L528">528</a><span class="code-text"><a-p>rust_grpc_library(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_grpc_library-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_grpc_library-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_grpc_library-rust_deps</a-s><a-p>&quot;&gt;rust_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L529" href="#L529">529</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L530" href="#L530">530</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L531" href="#L531">531</a><span class="code-text"><a-p>Builds a Rust library crate from a set of `proto_library`s suitable for gRPC.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L532" href="#L532">532</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L533" href="#L533">533</a><span class="code-text"><a-p>Example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L534" href="#L534">534</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L535" href="#L535">535</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L536" href="#L536">536</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;//proto:proto.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_grpc_library&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L537" href="#L537">537</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L538" href="#L538">538</a><span class="code-text"><a-p>proto_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L539" href="#L539">539</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;my_proto&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L540" href="#L540">540</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;my.proto&quot;</a-s><a-p>]</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L541" href="#L541">541</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L542" href="#L542">542</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L543" href="#L543">543</a><span class="code-text"><a-p>rust_grpc_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L544" href="#L544">544</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;rust&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L545" href="#L545">545</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;:my_proto&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L546" href="#L546">546</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L547" href="#L547">547</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L548" href="#L548">548</a><span class="code-text"><a-p>rust_binary(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L549" href="#L549">549</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;my_service&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L550" href="#L550">550</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;my_service.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L551" href="#L551">551</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;:rust&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L552" href="#L552">552</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L553" href="#L553">553</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L554" href="#L554">554</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L555" href="#L555">555</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L556" href="#L556">556</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L557" href="#L557">557</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L558" href="#L558">558</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L559" href="#L559">559</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L560" href="#L560">560</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L561" href="#L561">561</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_grpc_library-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L562" href="#L562">562</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_grpc_library-deps&quot;&gt;&lt;/a&gt;deps |  List of proto_library dependencies that will be built. One crate for each proto_library will be created with the corresponding gRPC stubs.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L563" href="#L563">563</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_grpc_library-rust_deps&quot;&gt;&lt;/a&gt;rust_deps |  The crates the generated library depends on.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L564" href="#L564">564</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L565" href="#L565">565</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L566" href="#L566">566</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_library&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L567" href="#L567">567</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L568" href="#L568">568</a><span class="code-text"><a-p>## </a-p><a-tt>rust_library</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L569" href="#L569">569</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L570" href="#L570">570</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L571" href="#L571">571</a><span class="code-text"><a-p>rust_library(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-aliases</a-s><a-p>&quot;&gt;aliases&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-compile_data</a-s><a-p>&quot;&gt;compile_data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-crate_features</a-s><a-p>&quot;&gt;crate_features&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-crate_name</a-s><a-p>&quot;&gt;crate_name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-crate_root</a-s><a-p>&quot;&gt;crate_root&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-data</a-s><a-p>&quot;&gt;data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L572" href="#L572">572</a><span class="code-text"><a-p>             &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-proc_macro_deps</a-s><a-p>&quot;&gt;proc_macro_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-rustc_env</a-s><a-p>&quot;&gt;rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-rustc_env_files</a-s><a-p>&quot;&gt;rustc_env_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-rustc_flags</a-s><a-p>&quot;&gt;rustc_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-stamp</a-s><a-p>&quot;&gt;stamp&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_library-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L573" href="#L573">573</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L574" href="#L574">574</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L575" href="#L575">575</a><span class="code-text"><a-p>Builds a Rust library crate.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L576" href="#L576">576</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L577" href="#L577">577</a><span class="code-text"><a-p>Example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L578" href="#L578">578</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L579" href="#L579">579</a><span class="code-text"><a-p>Suppose you have the following directory structure for a simple Rust library crate:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L580" href="#L580">580</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L581" href="#L581">581</a><span class="code-text"><a-p>```</a-p><a-tl>output</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L582" href="#L582">582</a><span class="code-text"><a-p>[workspace]/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L583" href="#L583">583</a><span class="code-text"><a-p>    WORKSPACE</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L584" href="#L584">584</a><span class="code-text"><a-p>    hello_lib/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L585" href="#L585">585</a><span class="code-text"><a-p>        BUILD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L586" href="#L586">586</a><span class="code-text"><a-p>        src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L587" href="#L587">587</a><span class="code-text"><a-p>            greeter.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L588" href="#L588">588</a><span class="code-text"><a-p>            lib.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L589" href="#L589">589</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L590" href="#L590">590</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L591" href="#L591">591</a><span class="code-text"><a-p>`hello_lib/src/greeter.rs`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L592" href="#L592">592</a><span class="code-text"><a-p>```</a-p><a-tl>rust</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L593" href="#L593">593</a><span class="code-text"><a-p>pub </a-p><a-k>struct</a-k><a-p> </a-p><a-t>Greeter</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L594" href="#L594">594</a><span class="code-text"><a-p>    </a-p><a-pr>greeting</a-pr><a-p>: </a-p><a-t>String</a-t><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L595" href="#L595">595</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L596" href="#L596">596</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L597" href="#L597">597</a><span class="code-text"><a-p>impl </a-p><a-t>Greeter</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L598" href="#L598">598</a><span class="code-text"><a-p>    </a-p><a-k>pub</a-k><a-p> </a-p><a-k>fn</a-k><a-p> </a-p><a-f>new</a-f><a-p>(</a-p><a-v>greeting</a-v><a-p>: </a-p><a-o>&amp;</a-o><a-t>str</a-t><a-p>) -&gt; </a-p><a-t>Greeter</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L599" href="#L599">599</a><span class="code-text"><a-p>        </a-p><a-t>Greeter</a-t><a-p> { </a-p><a-pr>greeting</a-pr><a-p>: greeting.</a-p><a-f>to_string</a-f><a-p>(), }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L600" href="#L600">600</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L601" href="#L601">601</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L602" href="#L602">602</a><span class="code-text"><a-p>    </a-p><a-k>pub</a-k><a-p> </a-p><a-k>fn</a-k><a-p> </a-p><a-f>greet</a-f><a-p>(</a-p><a-o>&amp;</a-o><a-v>self</a-v><a-p>, </a-p><a-v>thing</a-v><a-p>: </a-p><a-o>&amp;</a-o><a-t>str</a-t><a-p>) {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L603" href="#L603">603</a><span class="code-text"><a-p>        </a-p><a-m>println!</a-m><a-p>(</a-p><a-s>&quot;{} {}&quot;</a-s><a-p>, </a-p><a-o>&amp;</a-o><a-v>self</a-v><a-p>.</a-p><a-pr>greeting</a-pr><a-p>, thing);</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L604" href="#L604">604</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L605" href="#L605">605</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L606" href="#L606">606</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L607" href="#L607">607</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L608" href="#L608">608</a><span class="code-text"><a-p>`hello_lib/src/lib.rs`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L609" href="#L609">609</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L610" href="#L610">610</a><span class="code-text"><a-p>```</a-p><a-tl>rust</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L611" href="#L611">611</a><span class="code-text"><a-p>pub </a-p><a-k>mod</a-k><a-p> greeter;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L612" href="#L612">612</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L613" href="#L613">613</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L614" href="#L614">614</a><span class="code-text"><a-p>`hello_lib/BUILD`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L615" href="#L615">615</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L616" href="#L616">616</a><span class="code-text"><a-p>package(</a-p><a-v>default_visibility</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;//visibility:public&quot;</a-s><a-p>])</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L617" href="#L617">617</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L618" href="#L618">618</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L619" href="#L619">619</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L620" href="#L620">620</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L621" href="#L621">621</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L622" href="#L622">622</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L623" href="#L623">623</a><span class="code-text"><a-p>        </a-p><a-s>&quot;src/greeter.rs&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L624" href="#L624">624</a><span class="code-text"><a-p>        </a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L625" href="#L625">625</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L626" href="#L626">626</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L627" href="#L627">627</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L628" href="#L628">628</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L629" href="#L629">629</a><span class="code-text"><a-p>Build the library:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L630" href="#L630">630</a><span class="code-text"><a-p>```</a-p><a-tl>output</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L631" href="#L631">631</a><span class="code-text"><a-p>$ bazel build //hello_lib</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L632" href="#L632">632</a><span class="code-text"><a-p>INFO: Found 1 target...</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L633" href="#L633">633</a><span class="code-text"><a-p>Target //examples/rust/hello_lib:hello_lib up-to-date:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L634" href="#L634">634</a><span class="code-text"><a-p>bazel-bin/examples/rust/hello_lib/libhello_lib.rlib</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L635" href="#L635">635</a><span class="code-text"><a-p>INFO: Elapsed time: 1.245s, Critical Path: 1.01s</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L636" href="#L636">636</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L637" href="#L637">637</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L638" href="#L638">638</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L639" href="#L639">639</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L640" href="#L640">640</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L641" href="#L641">641</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L642" href="#L642">642</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L643" href="#L643">643</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L644" href="#L644">644</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L645" href="#L645">645</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-aliases&quot;&gt;&lt;/a&gt;aliases |  Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: Label -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L646" href="#L646">646</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-compile_data&quot;&gt;&lt;/a&gt;compile_data |  List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the [&lt;code&gt;include_str!&lt;/code&gt;](https://doc.rust-lang.org/std/macro.include_str!.html) macro.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L647" href="#L647">647</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-crate_features&quot;&gt;&lt;/a&gt;crate_features |  List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = &quot;foo&quot;)]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature=&quot;${feature_name}&quot;&lt;/code&gt; flags.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L648" href="#L648">648</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-crate_name&quot;&gt;&lt;/a&gt;crate_name |  Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L649" href="#L649">649</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-crate_root&quot;&gt;&lt;/a&gt;crate_root |  The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L650" href="#L650">650</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-data&quot;&gt;&lt;/a&gt;data |  List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L651" href="#L651">651</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-deps&quot;&gt;&lt;/a&gt;deps |  List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L652" href="#L652">652</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-edition&quot;&gt;&lt;/a&gt;edition |  The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L653" href="#L653">653</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-proc_macro_deps&quot;&gt;&lt;/a&gt;proc_macro_deps |  List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L654" href="#L654">654</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-rustc_env&quot;&gt;&lt;/a&gt;rustc_env |  Dictionary of additional &lt;code&gt;&quot;key&quot;: &quot;value&quot;&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()&#39;s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()&#39;s documentation for more.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L655" href="#L655">655</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-rustc_env_files&quot;&gt;&lt;/a&gt;rustc_env_files |  Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to [workspace status](https://docs.bazel.build/versions/main/user-manual.html#workspace_status) stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L656" href="#L656">656</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-rustc_flags&quot;&gt;&lt;/a&gt;rustc_flags |  List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L657" href="#L657">657</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-srcs&quot;&gt;&lt;/a&gt;srcs |  List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L658" href="#L658">658</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-stamp&quot;&gt;&lt;/a&gt;stamp |  Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             [--nostamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             [--[no]stamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won&#39;t be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how [&lt;code&gt;cc_library.linkstamps&lt;/code&gt;](https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp) behaves.   | Integer | optional | -1 |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L659" href="#L659">659</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_library-version&quot;&gt;&lt;/a&gt;version |  A version to inject in the cargo environment variable.   | String | optional | &quot;0.0.0&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L660" href="#L660">660</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L661" href="#L661">661</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L662" href="#L662">662</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_proc_macro&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L663" href="#L663">663</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L664" href="#L664">664</a><span class="code-text"><a-p>## </a-p><a-tt>rust_proc_macro</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L665" href="#L665">665</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L666" href="#L666">666</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L667" href="#L667">667</a><span class="code-text"><a-p>rust_proc_macro(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-aliases</a-s><a-p>&quot;&gt;aliases&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-compile_data</a-s><a-p>&quot;&gt;compile_data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-crate_features</a-s><a-p>&quot;&gt;crate_features&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-crate_name</a-s><a-p>&quot;&gt;crate_name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-crate_root</a-s><a-p>&quot;&gt;crate_root&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-data</a-s><a-p>&quot;&gt;data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L668" href="#L668">668</a><span class="code-text"><a-p>                &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-proc_macro_deps</a-s><a-p>&quot;&gt;proc_macro_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-rustc_env</a-s><a-p>&quot;&gt;rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-rustc_env_files</a-s><a-p>&quot;&gt;rustc_env_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-rustc_flags</a-s><a-p>&quot;&gt;rustc_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-stamp</a-s><a-p>&quot;&gt;stamp&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L669" href="#L669">669</a><span class="code-text"><a-p>                &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proc_macro-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L670" href="#L670">670</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L671" href="#L671">671</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L672" href="#L672">672</a><span class="code-text"><a-p>Builds a Rust proc-macro crate.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L673" href="#L673">673</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L674" href="#L674">674</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L675" href="#L675">675</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L676" href="#L676">676</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L677" href="#L677">677</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L678" href="#L678">678</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L679" href="#L679">679</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L680" href="#L680">680</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L681" href="#L681">681</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-aliases&quot;&gt;&lt;/a&gt;aliases |  Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: Label -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L682" href="#L682">682</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-compile_data&quot;&gt;&lt;/a&gt;compile_data |  List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the [&lt;code&gt;include_str!&lt;/code&gt;](https://doc.rust-lang.org/std/macro.include_str!.html) macro.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L683" href="#L683">683</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-crate_features&quot;&gt;&lt;/a&gt;crate_features |  List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = &quot;foo&quot;)]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature=&quot;${feature_name}&quot;&lt;/code&gt; flags.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L684" href="#L684">684</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-crate_name&quot;&gt;&lt;/a&gt;crate_name |  Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L685" href="#L685">685</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-crate_root&quot;&gt;&lt;/a&gt;crate_root |  The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L686" href="#L686">686</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-data&quot;&gt;&lt;/a&gt;data |  List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L687" href="#L687">687</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-deps&quot;&gt;&lt;/a&gt;deps |  List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L688" href="#L688">688</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-edition&quot;&gt;&lt;/a&gt;edition |  The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L689" href="#L689">689</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-proc_macro_deps&quot;&gt;&lt;/a&gt;proc_macro_deps |  List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L690" href="#L690">690</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-rustc_env&quot;&gt;&lt;/a&gt;rustc_env |  Dictionary of additional &lt;code&gt;&quot;key&quot;: &quot;value&quot;&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()&#39;s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()&#39;s documentation for more.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L691" href="#L691">691</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-rustc_env_files&quot;&gt;&lt;/a&gt;rustc_env_files |  Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to [workspace status](https://docs.bazel.build/versions/main/user-manual.html#workspace_status) stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L692" href="#L692">692</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-rustc_flags&quot;&gt;&lt;/a&gt;rustc_flags |  List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L693" href="#L693">693</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-srcs&quot;&gt;&lt;/a&gt;srcs |  List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L694" href="#L694">694</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-stamp&quot;&gt;&lt;/a&gt;stamp |  Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             [--nostamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             [--[no]stamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won&#39;t be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how [&lt;code&gt;cc_library.linkstamps&lt;/code&gt;](https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp) behaves.   | Integer | optional | -1 |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L695" href="#L695">695</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proc_macro-version&quot;&gt;&lt;/a&gt;version |  A version to inject in the cargo environment variable.   | String | optional | &quot;0.0.0&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L696" href="#L696">696</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L697" href="#L697">697</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L698" href="#L698">698</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_proto_library&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L699" href="#L699">699</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L700" href="#L700">700</a><span class="code-text"><a-p>## </a-p><a-tt>rust_proto_library</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L701" href="#L701">701</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L702" href="#L702">702</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L703" href="#L703">703</a><span class="code-text"><a-p>rust_proto_library(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_library-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_library-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_library-rust_deps</a-s><a-p>&quot;&gt;rust_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L704" href="#L704">704</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L705" href="#L705">705</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L706" href="#L706">706</a><span class="code-text"><a-p>Builds a Rust library crate from a set of `proto_library`s.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L707" href="#L707">707</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L708" href="#L708">708</a><span class="code-text"><a-p>Example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L709" href="#L709">709</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L710" href="#L710">710</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L711" href="#L711">711</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//proto:proto.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_proto_library&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L712" href="#L712">712</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L713" href="#L713">713</a><span class="code-text"><a-p>proto_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L714" href="#L714">714</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;my_proto&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L715" href="#L715">715</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;my.proto&quot;</a-s><a-p>]</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L716" href="#L716">716</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L717" href="#L717">717</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L718" href="#L718">718</a><span class="code-text"><a-p>rust_proto_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L719" href="#L719">719</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;rust&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L720" href="#L720">720</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;:my_proto&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L721" href="#L721">721</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L722" href="#L722">722</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L723" href="#L723">723</a><span class="code-text"><a-p>rust_binary(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L724" href="#L724">724</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;my_proto_binary&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L725" href="#L725">725</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;my_proto_binary.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L726" href="#L726">726</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;:rust&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L727" href="#L727">727</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L728" href="#L728">728</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L729" href="#L729">729</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L730" href="#L730">730</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L731" href="#L731">731</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L732" href="#L732">732</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L733" href="#L733">733</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L734" href="#L734">734</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L735" href="#L735">735</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L736" href="#L736">736</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_library-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L737" href="#L737">737</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_library-deps&quot;&gt;&lt;/a&gt;deps |  List of proto_library dependencies that will be built. One crate for each proto_library will be created with the corresponding stubs.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L738" href="#L738">738</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_library-rust_deps&quot;&gt;&lt;/a&gt;rust_deps |  The crates the generated library depends on.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L739" href="#L739">739</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L740" href="#L740">740</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L741" href="#L741">741</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_proto_toolchain&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L742" href="#L742">742</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L743" href="#L743">743</a><span class="code-text"><a-p>## </a-p><a-tt>rust_proto_toolchain</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L744" href="#L744">744</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L745" href="#L745">745</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L746" href="#L746">746</a><span class="code-text"><a-p>rust_proto_toolchain(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_toolchain-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_toolchain-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_toolchain-grpc_compile_deps</a-s><a-p>&quot;&gt;grpc_compile_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_toolchain-grpc_plugin</a-s><a-p>&quot;&gt;grpc_plugin&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_toolchain-proto_compile_deps</a-s><a-p>&quot;&gt;proto_compile_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L747" href="#L747">747</a><span class="code-text"><a-p>                     &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_toolchain-proto_plugin</a-s><a-p>&quot;&gt;proto_plugin&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_toolchain-protoc</a-s><a-p>&quot;&gt;protoc&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L748" href="#L748">748</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L749" href="#L749">749</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L750" href="#L750">750</a><span class="code-text"><a-p>Declares a Rust Proto toolchain for use.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L751" href="#L751">751</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L752" href="#L752">752</a><span class="code-text"><a-p>This is used to configure proto compilation and can be used to set different protobuf compiler plugin.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L753" href="#L753">753</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L754" href="#L754">754</a><span class="code-text"><a-p>Example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L755" href="#L755">755</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L756" href="#L756">756</a><span class="code-text"><a-p>Suppose a new nicer gRPC plugin has came out. The new plugin can be used in Bazel by defining a new toolchain definition and declaration:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L757" href="#L757">757</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L758" href="#L758">758</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L759" href="#L759">759</a><span class="code-text"><a-p>load(</a-p><a-s>&#39;@rules_rust//proto:toolchain.bzl&#39;</a-s><a-p>, </a-p><a-s>&#39;rust_proto_toolchain&#39;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L760" href="#L760">760</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L761" href="#L761">761</a><span class="code-text"><a-p>rust_proto_toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L762" href="#L762">762</a><span class="code-text"><a-p>   </a-p><a-v>name</a-v><a-o>=</a-o><a-s>&quot;rust_proto_impl&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L763" href="#L763">763</a><span class="code-text"><a-p>   </a-p><a-v>grpc_plugin</a-v><a-o>=</a-o><a-s>&quot;@rust_grpc//:grpc_plugin&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L764" href="#L764">764</a><span class="code-text"><a-p>   </a-p><a-v>grpc_compile_deps</a-v><a-o>=</a-o><a-p>[</a-p><a-s>&quot;@rust_grpc//:grpc_deps&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L765" href="#L765">765</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L766" href="#L766">766</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L767" href="#L767">767</a><span class="code-text"><a-p>toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L768" href="#L768">768</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-o>=</a-o><a-s>&quot;rust_proto&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L769" href="#L769">769</a><span class="code-text"><a-p>    </a-p><a-v>exec_compatible_with</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L770" href="#L770">770</a><span class="code-text"><a-p>        </a-p><a-s>&quot;@platforms//cpu:cpuX&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L771" href="#L771">771</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L772" href="#L772">772</a><span class="code-text"><a-p>    </a-p><a-v>target_compatible_with</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L773" href="#L773">773</a><span class="code-text"><a-p>        </a-p><a-s>&quot;@platforms//cpu:cpuX&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L774" href="#L774">774</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L775" href="#L775">775</a><span class="code-text"><a-p>    </a-p><a-v>toolchain</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;:rust_proto_impl&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L776" href="#L776">776</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L777" href="#L777">777</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L778" href="#L778">778</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L779" href="#L779">779</a><span class="code-text"><a-p>Then, either add the label of the toolchain rule to register_toolchains in the WORKSPACE, or pass it to the `--extra_toolchains` flag for Bazel, and it will be used.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L780" href="#L780">780</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L781" href="#L781">781</a><span class="code-text"><a-p>See @rules_rust//proto:BUILD for examples of defining the toolchain.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L782" href="#L782">782</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L783" href="#L783">783</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L784" href="#L784">784</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L785" href="#L785">785</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L786" href="#L786">786</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L787" href="#L787">787</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L788" href="#L788">788</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L789" href="#L789">789</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_toolchain-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L790" href="#L790">790</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_toolchain-edition&quot;&gt;&lt;/a&gt;edition |  The edition used by the generated rust source.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L791" href="#L791">791</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_toolchain-grpc_compile_deps&quot;&gt;&lt;/a&gt;grpc_compile_deps |  The crates the generated grpc libraries depends on.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [Label(&quot;//proto/raze:protobuf&quot;), Label(&quot;//proto/raze:grpc&quot;), Label(&quot;//proto/raze:tls_api&quot;), Label(&quot;//proto/raze:tls_api_stub&quot;)] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L792" href="#L792">792</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_toolchain-grpc_plugin&quot;&gt;&lt;/a&gt;grpc_plugin |  The location of the Rust protobuf compiler plugin to generate rust gRPC stubs.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | //proto:protoc_gen_rust_grpc |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L793" href="#L793">793</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_toolchain-proto_compile_deps&quot;&gt;&lt;/a&gt;proto_compile_deps |  The crates the generated protobuf libraries depends on.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [Label(&quot;//proto/raze:protobuf&quot;)] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L794" href="#L794">794</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_toolchain-proto_plugin&quot;&gt;&lt;/a&gt;proto_plugin |  The location of the Rust protobuf compiler plugin used to generate rust sources.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | //proto:protoc_gen_rust |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L795" href="#L795">795</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_toolchain-protoc&quot;&gt;&lt;/a&gt;protoc |  The location of the &lt;code&gt;protoc&lt;/code&gt; binary. It should be an executable target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | @com_google_protobuf//:protoc |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L796" href="#L796">796</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L797" href="#L797">797</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L798" href="#L798">798</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_shared_library&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L799" href="#L799">799</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L800" href="#L800">800</a><span class="code-text"><a-p>## </a-p><a-tt>rust_shared_library</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L801" href="#L801">801</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L802" href="#L802">802</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L803" href="#L803">803</a><span class="code-text"><a-p>rust_shared_library(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-aliases</a-s><a-p>&quot;&gt;aliases&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-compile_data</a-s><a-p>&quot;&gt;compile_data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-crate_features</a-s><a-p>&quot;&gt;crate_features&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-crate_name</a-s><a-p>&quot;&gt;crate_name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-crate_root</a-s><a-p>&quot;&gt;crate_root&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-data</a-s><a-p>&quot;&gt;data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L804" href="#L804">804</a><span class="code-text"><a-p>                    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-proc_macro_deps</a-s><a-p>&quot;&gt;proc_macro_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-rustc_env</a-s><a-p>&quot;&gt;rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-rustc_env_files</a-s><a-p>&quot;&gt;rustc_env_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-rustc_flags</a-s><a-p>&quot;&gt;rustc_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-stamp</a-s><a-p>&quot;&gt;stamp&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L805" href="#L805">805</a><span class="code-text"><a-p>                    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_shared_library-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L806" href="#L806">806</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L807" href="#L807">807</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L808" href="#L808">808</a><span class="code-text"><a-p>Builds a Rust shared library.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L809" href="#L809">809</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L810" href="#L810">810</a><span class="code-text"><a-p>This shared library will contain all transitively reachable crates and native objects.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L811" href="#L811">811</a><span class="code-text"><a-p>It is meant to be used when producing an artifact that is then consumed by some other build system</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L812" href="#L812">812</a><span class="code-text"><a-p>(for example to produce a shared library that Python program links against).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L813" href="#L813">813</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L814" href="#L814">814</a><span class="code-text"><a-p>This rule provides CcInfo, so it can be used everywhere Bazel expects `rules_cc`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L815" href="#L815">815</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L816" href="#L816">816</a><span class="code-text"><a-p>When building the whole binary in Bazel, use `rust_library` instead.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L817" href="#L817">817</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L818" href="#L818">818</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L819" href="#L819">819</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L820" href="#L820">820</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L821" href="#L821">821</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L822" href="#L822">822</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L823" href="#L823">823</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L824" href="#L824">824</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L825" href="#L825">825</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-aliases&quot;&gt;&lt;/a&gt;aliases |  Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: Label -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L826" href="#L826">826</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-compile_data&quot;&gt;&lt;/a&gt;compile_data |  List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the [&lt;code&gt;include_str!&lt;/code&gt;](https://doc.rust-lang.org/std/macro.include_str!.html) macro.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L827" href="#L827">827</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-crate_features&quot;&gt;&lt;/a&gt;crate_features |  List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = &quot;foo&quot;)]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature=&quot;${feature_name}&quot;&lt;/code&gt; flags.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L828" href="#L828">828</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-crate_name&quot;&gt;&lt;/a&gt;crate_name |  Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L829" href="#L829">829</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-crate_root&quot;&gt;&lt;/a&gt;crate_root |  The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L830" href="#L830">830</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-data&quot;&gt;&lt;/a&gt;data |  List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L831" href="#L831">831</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-deps&quot;&gt;&lt;/a&gt;deps |  List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L832" href="#L832">832</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-edition&quot;&gt;&lt;/a&gt;edition |  The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L833" href="#L833">833</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-proc_macro_deps&quot;&gt;&lt;/a&gt;proc_macro_deps |  List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L834" href="#L834">834</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-rustc_env&quot;&gt;&lt;/a&gt;rustc_env |  Dictionary of additional &lt;code&gt;&quot;key&quot;: &quot;value&quot;&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()&#39;s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()&#39;s documentation for more.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L835" href="#L835">835</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-rustc_env_files&quot;&gt;&lt;/a&gt;rustc_env_files |  Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to [workspace status](https://docs.bazel.build/versions/main/user-manual.html#workspace_status) stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L836" href="#L836">836</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-rustc_flags&quot;&gt;&lt;/a&gt;rustc_flags |  List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L837" href="#L837">837</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-srcs&quot;&gt;&lt;/a&gt;srcs |  List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L838" href="#L838">838</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-stamp&quot;&gt;&lt;/a&gt;stamp |  Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             [--nostamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             [--[no]stamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won&#39;t be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how [&lt;code&gt;cc_library.linkstamps&lt;/code&gt;](https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp) behaves.   | Integer | optional | -1 |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L839" href="#L839">839</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_shared_library-version&quot;&gt;&lt;/a&gt;version |  A version to inject in the cargo environment variable.   | String | optional | &quot;0.0.0&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L840" href="#L840">840</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L841" href="#L841">841</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L842" href="#L842">842</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_static_library&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L843" href="#L843">843</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L844" href="#L844">844</a><span class="code-text"><a-p>## </a-p><a-tt>rust_static_library</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L845" href="#L845">845</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L846" href="#L846">846</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L847" href="#L847">847</a><span class="code-text"><a-p>rust_static_library(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-aliases</a-s><a-p>&quot;&gt;aliases&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-compile_data</a-s><a-p>&quot;&gt;compile_data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-crate_features</a-s><a-p>&quot;&gt;crate_features&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-crate_name</a-s><a-p>&quot;&gt;crate_name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-crate_root</a-s><a-p>&quot;&gt;crate_root&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-data</a-s><a-p>&quot;&gt;data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L848" href="#L848">848</a><span class="code-text"><a-p>                    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-proc_macro_deps</a-s><a-p>&quot;&gt;proc_macro_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-rustc_env</a-s><a-p>&quot;&gt;rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-rustc_env_files</a-s><a-p>&quot;&gt;rustc_env_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-rustc_flags</a-s><a-p>&quot;&gt;rustc_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-stamp</a-s><a-p>&quot;&gt;stamp&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L849" href="#L849">849</a><span class="code-text"><a-p>                    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_static_library-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L850" href="#L850">850</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L851" href="#L851">851</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L852" href="#L852">852</a><span class="code-text"><a-p>Builds a Rust static library.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L853" href="#L853">853</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L854" href="#L854">854</a><span class="code-text"><a-p>This static library will contain all transitively reachable crates and native objects.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L855" href="#L855">855</a><span class="code-text"><a-p>It is meant to be used when producing an artifact that is then consumed by some other build system</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L856" href="#L856">856</a><span class="code-text"><a-p>(for example to produce an archive that Python program links against).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L857" href="#L857">857</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L858" href="#L858">858</a><span class="code-text"><a-p>This rule provides CcInfo, so it can be used everywhere Bazel expects `rules_cc`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L859" href="#L859">859</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L860" href="#L860">860</a><span class="code-text"><a-p>When building the whole binary in Bazel, use `rust_library` instead.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L861" href="#L861">861</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L862" href="#L862">862</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L863" href="#L863">863</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L864" href="#L864">864</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L865" href="#L865">865</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L866" href="#L866">866</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L867" href="#L867">867</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L868" href="#L868">868</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L869" href="#L869">869</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-aliases&quot;&gt;&lt;/a&gt;aliases |  Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: Label -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L870" href="#L870">870</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-compile_data&quot;&gt;&lt;/a&gt;compile_data |  List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the [&lt;code&gt;include_str!&lt;/code&gt;](https://doc.rust-lang.org/std/macro.include_str!.html) macro.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L871" href="#L871">871</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-crate_features&quot;&gt;&lt;/a&gt;crate_features |  List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = &quot;foo&quot;)]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature=&quot;${feature_name}&quot;&lt;/code&gt; flags.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L872" href="#L872">872</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-crate_name&quot;&gt;&lt;/a&gt;crate_name |  Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L873" href="#L873">873</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-crate_root&quot;&gt;&lt;/a&gt;crate_root |  The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L874" href="#L874">874</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-data&quot;&gt;&lt;/a&gt;data |  List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L875" href="#L875">875</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-deps&quot;&gt;&lt;/a&gt;deps |  List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L876" href="#L876">876</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-edition&quot;&gt;&lt;/a&gt;edition |  The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L877" href="#L877">877</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-proc_macro_deps&quot;&gt;&lt;/a&gt;proc_macro_deps |  List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L878" href="#L878">878</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-rustc_env&quot;&gt;&lt;/a&gt;rustc_env |  Dictionary of additional &lt;code&gt;&quot;key&quot;: &quot;value&quot;&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()&#39;s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()&#39;s documentation for more.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L879" href="#L879">879</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-rustc_env_files&quot;&gt;&lt;/a&gt;rustc_env_files |  Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to [workspace status](https://docs.bazel.build/versions/main/user-manual.html#workspace_status) stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L880" href="#L880">880</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-rustc_flags&quot;&gt;&lt;/a&gt;rustc_flags |  List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L881" href="#L881">881</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-srcs&quot;&gt;&lt;/a&gt;srcs |  List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L882" href="#L882">882</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-stamp&quot;&gt;&lt;/a&gt;stamp |  Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             [--nostamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             [--[no]stamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won&#39;t be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how [&lt;code&gt;cc_library.linkstamps&lt;/code&gt;](https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp) behaves.   | Integer | optional | -1 |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L883" href="#L883">883</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_static_library-version&quot;&gt;&lt;/a&gt;version |  A version to inject in the cargo environment variable.   | String | optional | &quot;0.0.0&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L884" href="#L884">884</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L885" href="#L885">885</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L886" href="#L886">886</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_stdlib_filegroup&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L887" href="#L887">887</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L888" href="#L888">888</a><span class="code-text"><a-p>## </a-p><a-tt>rust_stdlib_filegroup</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L889" href="#L889">889</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L890" href="#L890">890</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L891" href="#L891">891</a><span class="code-text"><a-p>rust_stdlib_filegroup(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_stdlib_filegroup-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_stdlib_filegroup-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L892" href="#L892">892</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L893" href="#L893">893</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L894" href="#L894">894</a><span class="code-text"><a-p>A dedicated filegroup-like rule for Rust stdlib artifacts.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L895" href="#L895">895</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L896" href="#L896">896</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L897" href="#L897">897</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L898" href="#L898">898</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L899" href="#L899">899</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L900" href="#L900">900</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L901" href="#L901">901</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_stdlib_filegroup-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L902" href="#L902">902</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_stdlib_filegroup-srcs&quot;&gt;&lt;/a&gt;srcs |  The list of targets/files that are components of the rust-stdlib file group   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L903" href="#L903">903</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L904" href="#L904">904</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L905" href="#L905">905</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_test&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L906" href="#L906">906</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L907" href="#L907">907</a><span class="code-text"><a-p>## </a-p><a-tt>rust_test</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L908" href="#L908">908</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L909" href="#L909">909</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L910" href="#L910">910</a><span class="code-text"><a-p>rust_test(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-aliases</a-s><a-p>&quot;&gt;aliases&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-compile_data</a-s><a-p>&quot;&gt;compile_data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-crate</a-s><a-p>&quot;&gt;crate&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-crate_features</a-s><a-p>&quot;&gt;crate_features&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-crate_name</a-s><a-p>&quot;&gt;crate_name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-crate_root</a-s><a-p>&quot;&gt;crate_root&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-data</a-s><a-p>&quot;&gt;data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L911" href="#L911">911</a><span class="code-text"><a-p>          &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-env</a-s><a-p>&quot;&gt;env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-proc_macro_deps</a-s><a-p>&quot;&gt;proc_macro_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-rustc_env</a-s><a-p>&quot;&gt;rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-rustc_env_files</a-s><a-p>&quot;&gt;rustc_env_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-rustc_flags</a-s><a-p>&quot;&gt;rustc_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-stamp</a-s><a-p>&quot;&gt;stamp&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L912" href="#L912">912</a><span class="code-text"><a-p>          &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-use_libtest_harness</a-s><a-p>&quot;&gt;use_libtest_harness&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L913" href="#L913">913</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L914" href="#L914">914</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L915" href="#L915">915</a><span class="code-text"><a-p>Builds a Rust test crate.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L916" href="#L916">916</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L917" href="#L917">917</a><span class="code-text"><a-p>Examples:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L918" href="#L918">918</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L919" href="#L919">919</a><span class="code-text"><a-p>Suppose you have the following directory structure for a Rust library crate         with unit test code in the library sources:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L920" href="#L920">920</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L921" href="#L921">921</a><span class="code-text"><a-p>```</a-p><a-tl>output</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L922" href="#L922">922</a><span class="code-text"><a-p>[workspace]/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L923" href="#L923">923</a><span class="code-text"><a-p>    WORKSPACE</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L924" href="#L924">924</a><span class="code-text"><a-p>    hello_lib/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L925" href="#L925">925</a><span class="code-text"><a-p>        BUILD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L926" href="#L926">926</a><span class="code-text"><a-p>        src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L927" href="#L927">927</a><span class="code-text"><a-p>            lib.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L928" href="#L928">928</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L929" href="#L929">929</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L930" href="#L930">930</a><span class="code-text"><a-p>`hello_lib/src/lib.rs`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L931" href="#L931">931</a><span class="code-text"><a-p>```</a-p><a-tl>rust</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L932" href="#L932">932</a><span class="code-text"><a-p>pub </a-p><a-k>struct</a-k><a-p> </a-p><a-t>Greeter</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L933" href="#L933">933</a><span class="code-text"><a-p>    </a-p><a-pr>greeting</a-pr><a-p>: </a-p><a-t>String</a-t><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L934" href="#L934">934</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L935" href="#L935">935</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L936" href="#L936">936</a><span class="code-text"><a-p>impl </a-p><a-t>Greeter</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L937" href="#L937">937</a><span class="code-text"><a-p>    </a-p><a-k>pub</a-k><a-p> </a-p><a-k>fn</a-k><a-p> </a-p><a-f>new</a-f><a-p>(</a-p><a-v>greeting</a-v><a-p>: </a-p><a-o>&amp;</a-o><a-t>str</a-t><a-p>) -&gt; </a-p><a-t>Greeter</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L938" href="#L938">938</a><span class="code-text"><a-p>        </a-p><a-t>Greeter</a-t><a-p> { </a-p><a-pr>greeting</a-pr><a-p>: greeting.</a-p><a-f>to_string</a-f><a-p>(), }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L939" href="#L939">939</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L940" href="#L940">940</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L941" href="#L941">941</a><span class="code-text"><a-p>    </a-p><a-k>pub</a-k><a-p> </a-p><a-k>fn</a-k><a-p> </a-p><a-f>greet</a-f><a-p>(</a-p><a-o>&amp;</a-o><a-v>self</a-v><a-p>, </a-p><a-v>thing</a-v><a-p>: </a-p><a-o>&amp;</a-o><a-t>str</a-t><a-p>) -&gt; </a-p><a-t>String</a-t><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L942" href="#L942">942</a><span class="code-text"><a-p>        </a-p><a-m>format!</a-m><a-p>(</a-p><a-s>&quot;{} {}&quot;</a-s><a-p>, </a-p><a-o>&amp;</a-o><a-v>self</a-v><a-p>.</a-p><a-pr>greeting</a-pr><a-p>, thing)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L943" href="#L943">943</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L944" href="#L944">944</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L945" href="#L945">945</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L946" href="#L946">946</a><span class="code-text"><a-p>#[cfg(test)]</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L947" href="#L947">947</a><span class="code-text"><a-p>mod test {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L948" href="#L948">948</a><span class="code-text"><a-p>    </a-p><a-k>use</a-k><a-p> </a-p><a-k>super</a-k><a-p>::</a-p><a-cr>Greeter</a-cr><a-p>;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L949" href="#L949">949</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L950" href="#L950">950</a><span class="code-text"><a-p>    </a-p><a-at>#</a-at><a-p>[</a-p><a-at>test</a-at><a-p>]</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L951" href="#L951">951</a><span class="code-text"><a-p>    </a-p><a-k>fn</a-k><a-p> </a-p><a-f>test_greeting</a-f><a-p>() {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L952" href="#L952">952</a><span class="code-text"><a-p>        </a-p><a-k>let</a-k><a-p> hello = </a-p><a-t>Greeter</a-t><a-p>::</a-p><a-f>new</a-f><a-p>(</a-p><a-s>&quot;Hi&quot;</a-s><a-p>);</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L953" href="#L953">953</a><span class="code-text"><a-p>        </a-p><a-m>assert_eq!</a-m><a-p>(</a-p><a-s>&quot;Hi Rust&quot;</a-s><a-p>, hello.</a-p><a-f>greet</a-f><a-p>(</a-p><a-s>&quot;Rust&quot;</a-s><a-p>));</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L954" href="#L954">954</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L955" href="#L955">955</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L956" href="#L956">956</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L957" href="#L957">957</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L958" href="#L958">958</a><span class="code-text"><a-p>To build and run the tests, simply add a `rust_test` rule with no `srcs`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L959" href="#L959">959</a><span class="code-text"><a-p>and only depends on the `hello_lib` `rust_library` target via the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L960" href="#L960">960</a><span class="code-text"><a-p>`crate` attribute:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L961" href="#L961">961</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L962" href="#L962">962</a><span class="code-text"><a-p>`hello_lib/BUILD`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L963" href="#L963">963</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L964" href="#L964">964</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_test&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L965" href="#L965">965</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L966" href="#L966">966</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L967" href="#L967">967</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L968" href="#L968">968</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L969" href="#L969">969</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L970" href="#L970">970</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L971" href="#L971">971</a><span class="code-text"><a-p>rust_test(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L972" href="#L972">972</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib_test&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L973" href="#L973">973</a><span class="code-text"><a-p>    </a-p><a-v>crate</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;:hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L974" href="#L974">974</a><span class="code-text"><a-p>    </a-p><a-c># You may add other deps that are specific to the test configuration</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L975" href="#L975">975</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;//some/dev/dep&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L976" href="#L976">976</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L977" href="#L977">977</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L978" href="#L978">978</a><span class="code-text"><a-p>Run the test with `bazel test //hello_lib:hello_lib_test`. The crate</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L979" href="#L979">979</a><span class="code-text"><a-p>will be built using the same crate name as the underlying &quot;:hello_lib&quot;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L980" href="#L980">980</a><span class="code-text"><a-p>crate.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L981" href="#L981">981</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L982" href="#L982">982</a><span class="code-text"><a-p>### </a-p><a-tt>Example: `test` directory</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L983" href="#L983">983</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L984" href="#L984">984</a><span class="code-text"><a-p>Integration tests that live in the [`tests` directory][int-tests], they are         essentially built as separate crates. Suppose you have the following directory         structure where `greeting.rs` is an integration test for the `hello_lib`         library crate:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L985" href="#L985">985</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L986" href="#L986">986</a><span class="code-text"><a-tu>[int-tests]</a-tu><a-p>: </a-p><a-tu>http://doc.rust-lang.org/book/testing.html#the-tests-directory</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L987" href="#L987">987</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L988" href="#L988">988</a><span class="code-text"><a-p>```</a-p><a-tl>output</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L989" href="#L989">989</a><span class="code-text"><a-p>[workspace]/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L990" href="#L990">990</a><span class="code-text"><a-p>    WORKSPACE</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L991" href="#L991">991</a><span class="code-text"><a-p>    hello_lib/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L992" href="#L992">992</a><span class="code-text"><a-p>        BUILD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L993" href="#L993">993</a><span class="code-text"><a-p>        src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L994" href="#L994">994</a><span class="code-text"><a-p>            lib.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L995" href="#L995">995</a><span class="code-text"><a-p>        tests/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L996" href="#L996">996</a><span class="code-text"><a-p>            greeting.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L997" href="#L997">997</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L998" href="#L998">998</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L999" href="#L999">999</a><span class="code-text"><a-p>`hello_lib/tests/greeting.rs`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1000" href="#L1000">1000</a><span class="code-text"><a-p>```</a-p><a-tl>rust</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1001" href="#L1001">1001</a><span class="code-text"><a-p>extern </a-p><a-k>crate</a-k><a-p> hello_lib;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1002" href="#L1002">1002</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1003" href="#L1003">1003</a><span class="code-text"><a-p>use hello_lib;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1004" href="#L1004">1004</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1005" href="#L1005">1005</a><span class="code-text"><a-p>#[test]</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1006" href="#L1006">1006</a><span class="code-text"><a-p>fn </a-p><a-f>test_greeting</a-f><a-p>() {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1007" href="#L1007">1007</a><span class="code-text"><a-p>    </a-p><a-k>let</a-k><a-p> hello = greeter::</a-p><a-t>Greeter</a-t><a-p>::</a-p><a-f>new</a-f><a-p>(</a-p><a-s>&quot;Hello&quot;</a-s><a-p>);</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1008" href="#L1008">1008</a><span class="code-text"><a-p>    </a-p><a-m>assert_eq!</a-m><a-p>(</a-p><a-s>&quot;Hello world&quot;</a-s><a-p>, hello.</a-p><a-f>greeting</a-f><a-p>(</a-p><a-s>&quot;world&quot;</a-s><a-p>));</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1009" href="#L1009">1009</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1010" href="#L1010">1010</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1011" href="#L1011">1011</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1012" href="#L1012">1012</a><span class="code-text"><a-p>To build the `greeting.rs` integration test, simply add a `rust_test` target</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1013" href="#L1013">1013</a><span class="code-text"><a-p>with `greeting.rs` in `srcs` and a dependency on the `hello_lib` target:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1014" href="#L1014">1014</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1015" href="#L1015">1015</a><span class="code-text"><a-p>`hello_lib/BUILD`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1016" href="#L1016">1016</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1017" href="#L1017">1017</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_test&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1018" href="#L1018">1018</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1019" href="#L1019">1019</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1020" href="#L1020">1020</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1021" href="#L1021">1021</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1022" href="#L1022">1022</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1023" href="#L1023">1023</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1024" href="#L1024">1024</a><span class="code-text"><a-p>rust_test(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1025" href="#L1025">1025</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;greeting_test&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1026" href="#L1026">1026</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;tests/greeting.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1027" href="#L1027">1027</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;:hello_lib&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1028" href="#L1028">1028</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1029" href="#L1029">1029</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1030" href="#L1030">1030</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1031" href="#L1031">1031</a><span class="code-text"><a-p>Run the test with `bazel test //hello_lib:greeting_test`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1032" href="#L1032">1032</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1033" href="#L1033">1033</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1034" href="#L1034">1034</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1035" href="#L1035">1035</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1036" href="#L1036">1036</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1037" href="#L1037">1037</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1038" href="#L1038">1038</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1039" href="#L1039">1039</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-aliases&quot;&gt;&lt;/a&gt;aliases |  Remap crates to a new name or moniker for linkage to this target&lt;br&gt;&lt;br&gt;These are other &lt;code&gt;rust_library&lt;/code&gt; targets and will be presented as the new name given.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: Label -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1040" href="#L1040">1040</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-compile_data&quot;&gt;&lt;/a&gt;compile_data |  List of files used by this rule at compile time.&lt;br&gt;&lt;br&gt;This attribute can be used to specify any data files that are embedded into the library, such as via the [&lt;code&gt;include_str!&lt;/code&gt;](https://doc.rust-lang.org/std/macro.include_str!.html) macro.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1041" href="#L1041">1041</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-crate&quot;&gt;&lt;/a&gt;crate |  Target inline tests declared in the given crate&lt;br&gt;&lt;br&gt;These tests are typically those that would be held out under &lt;code&gt;#[cfg(test)]&lt;/code&gt; declarations.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1042" href="#L1042">1042</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-crate_features&quot;&gt;&lt;/a&gt;crate_features |  List of features to enable for this crate.&lt;br&gt;&lt;br&gt;Features are defined in the code using the &lt;code&gt;#[cfg(feature = &quot;foo&quot;)]&lt;/code&gt; configuration option. The features listed here will be passed to &lt;code&gt;rustc&lt;/code&gt; with &lt;code&gt;--cfg feature=&quot;${feature_name}&quot;&lt;/code&gt; flags.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1043" href="#L1043">1043</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-crate_name&quot;&gt;&lt;/a&gt;crate_name |  Crate name to use for this target.&lt;br&gt;&lt;br&gt;This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1044" href="#L1044">1044</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-crate_root&quot;&gt;&lt;/a&gt;crate_root |  The file that will be passed to &lt;code&gt;rustc&lt;/code&gt; to be used for building this crate.&lt;br&gt;&lt;br&gt;If &lt;code&gt;crate_root&lt;/code&gt; is not set, then this rule will look for a &lt;code&gt;lib.rs&lt;/code&gt; file (or &lt;code&gt;main.rs&lt;/code&gt; for rust_binary) or the single file in &lt;code&gt;srcs&lt;/code&gt; if &lt;code&gt;srcs&lt;/code&gt; contains only one file.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1045" href="#L1045">1045</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-data&quot;&gt;&lt;/a&gt;data |  List of files used by this rule at compile time and runtime.&lt;br&gt;&lt;br&gt;If including data at compile time with include_str!() and similar, prefer &lt;code&gt;compile_data&lt;/code&gt; over &lt;code&gt;data&lt;/code&gt;, to prevent the data also being included in the runfiles.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1046" href="#L1046">1046</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-deps&quot;&gt;&lt;/a&gt;deps |  List of other libraries to be linked to this library target.&lt;br&gt;&lt;br&gt;These can be either other &lt;code&gt;rust_library&lt;/code&gt; targets or &lt;code&gt;cc_library&lt;/code&gt; targets if linking a native library.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1047" href="#L1047">1047</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-edition&quot;&gt;&lt;/a&gt;edition |  The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1048" href="#L1048">1048</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-env&quot;&gt;&lt;/a&gt;env |  Specifies additional environment variables to set when the test is executed by bazel test. Values are subject to &lt;code&gt;$(rootpath)&lt;/code&gt;, &lt;code&gt;$(execpath)&lt;/code&gt;, location, and [&quot;Make variable&quot;](https://docs.bazel.build/versions/master/be/make-variables.html) substitution.&lt;br&gt;&lt;br&gt;Execpath returns absolute path, and in order to be able to construct the absolute path we need to wrap the test binary in a launcher. Using a launcher comes with complications, such as more complicated debugger attachment.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1049" href="#L1049">1049</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-proc_macro_deps&quot;&gt;&lt;/a&gt;proc_macro_deps |  List of &lt;code&gt;rust_library&lt;/code&gt; targets with kind &lt;code&gt;proc-macro&lt;/code&gt; used to help build this library target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1050" href="#L1050">1050</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-rustc_env&quot;&gt;&lt;/a&gt;rustc_env |  Dictionary of additional &lt;code&gt;&quot;key&quot;: &quot;value&quot;&lt;/code&gt; environment variables to set for rustc.&lt;br&gt;&lt;br&gt;rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()&#39;s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()&#39;s documentation for more.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1051" href="#L1051">1051</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-rustc_env_files&quot;&gt;&lt;/a&gt;rustc_env_files |  Files containing additional environment variables to set for rustc.&lt;br&gt;&lt;br&gt;These files should  contain a single variable per line, of format &lt;code&gt;NAME=value&lt;/code&gt;, and newlines may be included in a value by ending a line with a trailing back-slash (&lt;code&gt;\\&lt;/code&gt;).&lt;br&gt;&lt;br&gt;The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.&lt;br&gt;&lt;br&gt;Note that the variables here are subject to [workspace status](https://docs.bazel.build/versions/main/user-manual.html#workspace_status) stamping should the &lt;code&gt;stamp&lt;/code&gt; attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g. &lt;code&gt;NAME={WORKSPACE_STATUS_VARIABLE}&lt;/code&gt;.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1052" href="#L1052">1052</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-rustc_flags&quot;&gt;&lt;/a&gt;rustc_flags |  List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.&lt;br&gt;&lt;br&gt;These strings are subject to Make variable expansion for predefined source/output path variables like &lt;code&gt;$location&lt;/code&gt;, &lt;code&gt;$execpath&lt;/code&gt;, and &lt;code&gt;$rootpath&lt;/code&gt;. This expansion is useful if you wish to pass a generated file of arguments to rustc: &lt;code&gt;@$(location //package:target)&lt;/code&gt;.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1053" href="#L1053">1053</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-srcs&quot;&gt;&lt;/a&gt;srcs |  List of Rust &lt;code&gt;.rs&lt;/code&gt; source files used to build the library.&lt;br&gt;&lt;br&gt;If &lt;code&gt;srcs&lt;/code&gt; contains more than one file, then there must be a file either named &lt;code&gt;lib.rs&lt;/code&gt;. Otherwise, &lt;code&gt;crate_root&lt;/code&gt; must be set to the source file that is the root of the crate to be passed to rustc to build this crate.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1054" href="#L1054">1054</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-stamp&quot;&gt;&lt;/a&gt;stamp |  Whether to encode build information into the &lt;code&gt;Rustc&lt;/code&gt; action. Possible values:&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 1&lt;/code&gt;: Always stamp the build information into the &lt;code&gt;Rustc&lt;/code&gt; action, even in             [--nostamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) builds.             This setting should be avoided, since it potentially kills remote caching for the target and             any downstream actions that depend on it.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = 0&lt;/code&gt;: Always replace build information by constant values. This gives good build result caching.&lt;br&gt;&lt;br&gt;- &lt;code&gt;stamp = -1&lt;/code&gt;: Embedding of build information is controlled by the             [--[no]stamp](https://docs.bazel.build/versions/main/user-manual.html#flag--stamp) flag.&lt;br&gt;&lt;br&gt;Stamped targets are not rebuilt unless their dependencies change.&lt;br&gt;&lt;br&gt;For example if a &lt;code&gt;rust_library&lt;/code&gt; is stamped, and a &lt;code&gt;rust_binary&lt;/code&gt; depends on that library, the stamped library won&#39;t be rebuilt when we change sources of the &lt;code&gt;rust_binary&lt;/code&gt;. This is different from how [&lt;code&gt;cc_library.linkstamps&lt;/code&gt;](https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp) behaves.   | Integer | optional | -1 |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1055" href="#L1055">1055</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-use_libtest_harness&quot;&gt;&lt;/a&gt;use_libtest_harness |  Whether to use &lt;code&gt;libtest&lt;/code&gt;. For targets using this flag, individual tests can be run by using the [--test_arg](https://docs.bazel.build/versions/4.0.0/command-line-reference.html#flag--test_arg) flag. E.g. &lt;code&gt;bazel test //src:rust_test --test_arg=foo::test::test_fn&lt;/code&gt;.   | Boolean | optional | True |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1056" href="#L1056">1056</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test-version&quot;&gt;&lt;/a&gt;version |  A version to inject in the cargo environment variable.   | String | optional | &quot;0.0.0&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1057" href="#L1057">1057</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1058" href="#L1058">1058</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1059" href="#L1059">1059</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_toolchain&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1060" href="#L1060">1060</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1061" href="#L1061">1061</a><span class="code-text"><a-p>## </a-p><a-tt>rust_toolchain</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1062" href="#L1062">1062</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1063" href="#L1063">1063</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1064" href="#L1064">1064</a><span class="code-text"><a-p>rust_toolchain(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-allocator_library</a-s><a-p>&quot;&gt;allocator_library&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-binary_ext</a-s><a-p>&quot;&gt;binary_ext&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-cargo</a-s><a-p>&quot;&gt;cargo&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-clippy_driver</a-s><a-p>&quot;&gt;clippy_driver&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-debug_info</a-s><a-p>&quot;&gt;debug_info&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1065" href="#L1065">1065</a><span class="code-text"><a-p>               &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-default_edition</a-s><a-p>&quot;&gt;default_edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-dylib_ext</a-s><a-p>&quot;&gt;dylib_ext&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-env</a-s><a-p>&quot;&gt;env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-exec_triple</a-s><a-p>&quot;&gt;exec_triple&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-llvm_cov</a-s><a-p>&quot;&gt;llvm_cov&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-llvm_profdata</a-s><a-p>&quot;&gt;llvm_profdata&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-llvm_tools</a-s><a-p>&quot;&gt;llvm_tools&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1066" href="#L1066">1066</a><span class="code-text"><a-p>               &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-opt_level</a-s><a-p>&quot;&gt;opt_level&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-os</a-s><a-p>&quot;&gt;os&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-rust_doc</a-s><a-p>&quot;&gt;rust_doc&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-rust_lib</a-s><a-p>&quot;&gt;rust_lib&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-rust_std</a-s><a-p>&quot;&gt;rust_std&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-rustc</a-s><a-p>&quot;&gt;rustc&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-rustc_lib</a-s><a-p>&quot;&gt;rustc_lib&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-rustc_srcs</a-s><a-p>&quot;&gt;rustc_srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-rustfmt</a-s><a-p>&quot;&gt;rustfmt&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1067" href="#L1067">1067</a><span class="code-text"><a-p>               &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-staticlib_ext</a-s><a-p>&quot;&gt;staticlib_ext&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-stdlib_linkflags</a-s><a-p>&quot;&gt;stdlib_linkflags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-target_json</a-s><a-p>&quot;&gt;target_json&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain-target_triple</a-s><a-p>&quot;&gt;target_triple&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1068" href="#L1068">1068</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1069" href="#L1069">1069</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1070" href="#L1070">1070</a><span class="code-text"><a-p>Declares a Rust toolchain for use.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1071" href="#L1071">1071</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1072" href="#L1072">1072</a><span class="code-text"><a-p>This is for declaring a custom toolchain, eg. for configuring a particular version of rust or supporting a new platform.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1073" href="#L1073">1073</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1074" href="#L1074">1074</a><span class="code-text"><a-p>Example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1075" href="#L1075">1075</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1076" href="#L1076">1076</a><span class="code-text"><a-p>Suppose the core rust team has ported the compiler to a new target CPU, called `cpuX`. This support can be used in Bazel by defining a new toolchain definition and declaration:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1077" href="#L1077">1077</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1078" href="#L1078">1078</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1079" href="#L1079">1079</a><span class="code-text"><a-p>load(</a-p><a-s>&#39;@rules_rust//rust:toolchain.bzl&#39;</a-s><a-p>, </a-p><a-s>&#39;rust_toolchain&#39;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1080" href="#L1080">1080</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1081" href="#L1081">1081</a><span class="code-text"><a-p>rust_toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1082" href="#L1082">1082</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;rust_cpuX_impl&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1083" href="#L1083">1083</a><span class="code-text"><a-p>    </a-p><a-v>rustc</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;@rust_cpuX//:rustc&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1084" href="#L1084">1084</a><span class="code-text"><a-p>    </a-p><a-v>rustc_lib</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;@rust_cpuX//:rustc_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1085" href="#L1085">1085</a><span class="code-text"><a-p>    </a-p><a-v>rust_std</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;@rust_cpuX//:rust_std&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1086" href="#L1086">1086</a><span class="code-text"><a-p>    </a-p><a-v>rust_doc</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;@rust_cpuX//:rustdoc&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1087" href="#L1087">1087</a><span class="code-text"><a-p>    </a-p><a-v>binary_ext</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1088" href="#L1088">1088</a><span class="code-text"><a-p>    </a-p><a-v>staticlib_ext</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;.a&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1089" href="#L1089">1089</a><span class="code-text"><a-p>    </a-p><a-v>dylib_ext</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;.so&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1090" href="#L1090">1090</a><span class="code-text"><a-p>    </a-p><a-v>stdlib_linkflags</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;-lpthread&quot;</a-s><a-p>, </a-p><a-s>&quot;-ldl&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1091" href="#L1091">1091</a><span class="code-text"><a-p>    </a-p><a-v>os</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;linux&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1092" href="#L1092">1092</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1093" href="#L1093">1093</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1094" href="#L1094">1094</a><span class="code-text"><a-p>toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1095" href="#L1095">1095</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;rust_cpuX&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1096" href="#L1096">1096</a><span class="code-text"><a-p>    </a-p><a-v>exec_compatible_with</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1097" href="#L1097">1097</a><span class="code-text"><a-p>        </a-p><a-s>&quot;@platforms//cpu:cpuX&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1098" href="#L1098">1098</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1099" href="#L1099">1099</a><span class="code-text"><a-p>    </a-p><a-v>target_compatible_with</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1100" href="#L1100">1100</a><span class="code-text"><a-p>        </a-p><a-s>&quot;@platforms//cpu:cpuX&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1101" href="#L1101">1101</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1102" href="#L1102">1102</a><span class="code-text"><a-p>    </a-p><a-v>toolchain</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;:rust_cpuX_impl&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1103" href="#L1103">1103</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1104" href="#L1104">1104</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1105" href="#L1105">1105</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1106" href="#L1106">1106</a><span class="code-text"><a-p>Then, either add the label of the toolchain rule to `register_toolchains` in the WORKSPACE, or pass it to the `&quot;--extra_toolchains&quot;` flag for Bazel, and it will be used.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1107" href="#L1107">1107</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1108" href="#L1108">1108</a><span class="code-text"><a-p>See @rules_rust//rust:repositories.bzl for examples of defining the @rust_cpuX repository with the actual binaries and libraries.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1109" href="#L1109">1109</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1110" href="#L1110">1110</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1111" href="#L1111">1111</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1112" href="#L1112">1112</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1113" href="#L1113">1113</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1114" href="#L1114">1114</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1115" href="#L1115">1115</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1116" href="#L1116">1116</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1117" href="#L1117">1117</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-allocator_library&quot;&gt;&lt;/a&gt;allocator_library |  Target that provides allocator functions when rust_library targets are embedded in a cc_binary.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1118" href="#L1118">1118</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-binary_ext&quot;&gt;&lt;/a&gt;binary_ext |  The extension for binaries created from rustc.   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1119" href="#L1119">1119</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-cargo&quot;&gt;&lt;/a&gt;cargo |  The location of the &lt;code&gt;cargo&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1120" href="#L1120">1120</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-clippy_driver&quot;&gt;&lt;/a&gt;clippy_driver |  The location of the &lt;code&gt;clippy-driver&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1121" href="#L1121">1121</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-debug_info&quot;&gt;&lt;/a&gt;debug_info |  Rustc debug info levels per opt level   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {&quot;dbg&quot;: &quot;2&quot;, &quot;fastbuild&quot;: &quot;0&quot;, &quot;opt&quot;: &quot;0&quot;} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1122" href="#L1122">1122</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-default_edition&quot;&gt;&lt;/a&gt;default_edition |  The edition to use for rust_* rules that don&#39;t specify an edition. If absent, every rule is required to specify its &lt;code&gt;edition&lt;/code&gt; attribute.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1123" href="#L1123">1123</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-dylib_ext&quot;&gt;&lt;/a&gt;dylib_ext |  The extension for dynamic libraries created from rustc.   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1124" href="#L1124">1124</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-env&quot;&gt;&lt;/a&gt;env |  Environment variables to set in actions.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1125" href="#L1125">1125</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-exec_triple&quot;&gt;&lt;/a&gt;exec_triple |  The platform triple for the toolchains execution environment. For more details see: https://docs.bazel.build/versions/master/skylark/rules.html#configurations   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1126" href="#L1126">1126</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-llvm_cov&quot;&gt;&lt;/a&gt;llvm_cov |  The location of the &lt;code&gt;llvm-cov&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item. If None, rust code is not instrumented for coverage.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1127" href="#L1127">1127</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-llvm_profdata&quot;&gt;&lt;/a&gt;llvm_profdata |  The location of the &lt;code&gt;llvm-profdata&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item. If &lt;code&gt;llvm_cov&lt;/code&gt; is None, this can be None as well and rust code is not instrumented for coverage.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1128" href="#L1128">1128</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-llvm_tools&quot;&gt;&lt;/a&gt;llvm_tools |  LLVM tools that are shipped with the Rust toolchain.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1129" href="#L1129">1129</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-opt_level&quot;&gt;&lt;/a&gt;opt_level |  Rustc optimization levels.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {&quot;dbg&quot;: &quot;0&quot;, &quot;fastbuild&quot;: &quot;0&quot;, &quot;opt&quot;: &quot;3&quot;} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1130" href="#L1130">1130</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-os&quot;&gt;&lt;/a&gt;os |  The operating system for the current toolchain   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1131" href="#L1131">1131</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-rust_doc&quot;&gt;&lt;/a&gt;rust_doc |  The location of the &lt;code&gt;rustdoc&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1132" href="#L1132">1132</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-rust_lib&quot;&gt;&lt;/a&gt;rust_lib |  **Deprecated**: Use &lt;code&gt;rust_std&lt;/code&gt;   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1133" href="#L1133">1133</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-rust_std&quot;&gt;&lt;/a&gt;rust_std |  The Rust standard library.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1134" href="#L1134">1134</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-rustc&quot;&gt;&lt;/a&gt;rustc |  The location of the &lt;code&gt;rustc&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1135" href="#L1135">1135</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-rustc_lib&quot;&gt;&lt;/a&gt;rustc_lib |  The libraries used by rustc during compilation.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1136" href="#L1136">1136</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-rustc_srcs&quot;&gt;&lt;/a&gt;rustc_srcs |  The source code of rustc.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1137" href="#L1137">1137</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-rustfmt&quot;&gt;&lt;/a&gt;rustfmt |  The location of the &lt;code&gt;rustfmt&lt;/code&gt; binary. Can be a direct source or a filegroup containing one item.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1138" href="#L1138">1138</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-staticlib_ext&quot;&gt;&lt;/a&gt;staticlib_ext |  The extension for static libraries created from rustc.   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1139" href="#L1139">1139</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-stdlib_linkflags&quot;&gt;&lt;/a&gt;stdlib_linkflags |  Additional linker flags to use when Rust standard library is linked by a C++ linker (rustc will deal with these automatically). Subject to location expansion with respect to the srcs of the &lt;code&gt;rust_std&lt;/code&gt; attribute.   | List of strings | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1140" href="#L1140">1140</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-target_json&quot;&gt;&lt;/a&gt;target_json |  Override the target_triple with a custom target specification. For more details see: https://doc.rust-lang.org/rustc/targets/custom.html   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1141" href="#L1141">1141</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain-target_triple&quot;&gt;&lt;/a&gt;target_triple |  The platform triple for the toolchains target environment. For more details see: https://docs.bazel.build/versions/master/skylark/rules.html#configurations   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1142" href="#L1142">1142</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1143" href="#L1143">1143</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1144" href="#L1144">1144</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_toolchain_repository&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1145" href="#L1145">1145</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1146" href="#L1146">1146</a><span class="code-text"><a-p>## </a-p><a-tt>rust_toolchain_repository</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1147" href="#L1147">1147</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1148" href="#L1148">1148</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1149" href="#L1149">1149</a><span class="code-text"><a-p>rust_toolchain_repository(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-auth</a-s><a-p>&quot;&gt;auth&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-dev_components</a-s><a-p>&quot;&gt;dev_components&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-exec_triple</a-s><a-p>&quot;&gt;exec_triple&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-extra_target_triples</a-s><a-p>&quot;&gt;extra_target_triples&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1150" href="#L1150">1150</a><span class="code-text"><a-p>                          &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-include_rustc_srcs</a-s><a-p>&quot;&gt;include_rustc_srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-iso_date</a-s><a-p>&quot;&gt;iso_date&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-repo_mapping</a-s><a-p>&quot;&gt;repo_mapping&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-rustfmt_version</a-s><a-p>&quot;&gt;rustfmt_version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-sha256s</a-s><a-p>&quot;&gt;sha256s&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1151" href="#L1151">1151</a><span class="code-text"><a-p>                          &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-toolchain_name_prefix</a-s><a-p>&quot;&gt;toolchain_name_prefix&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-urls</a-s><a-p>&quot;&gt;urls&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1152" href="#L1152">1152</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1153" href="#L1153">1153</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1154" href="#L1154">1154</a><span class="code-text"><a-p>Composes a single workspace containing the toolchain components for compiling on a given platform to a series of target platforms.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1155" href="#L1155">1155</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1156" href="#L1156">1156</a><span class="code-text"><a-p>A given instance of this rule should be accompanied by a rust_toolchain_repository_proxy invocation to declare its toolchains to Bazel; the indirection allows separating toolchain selection from toolchain fetching.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1157" href="#L1157">1157</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1158" href="#L1158">1158</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1159" href="#L1159">1159</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1160" href="#L1160">1160</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1161" href="#L1161">1161</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1162" href="#L1162">1162</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1163" href="#L1163">1163</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-name&quot;&gt;&lt;/a&gt;name |  A unique name for this repository.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1164" href="#L1164">1164</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-auth&quot;&gt;&lt;/a&gt;auth |  Auth object compatible with repository_ctx.download to use when downloading files. See [repository_ctx.download](https://docs.bazel.build/versions/main/skylark/lib/repository_ctx.html#download) for more details.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1165" href="#L1165">1165</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-dev_components&quot;&gt;&lt;/a&gt;dev_components |  Whether to download the rustc-dev components (defaults to False). Requires version to be &quot;nightly&quot;.   | Boolean | optional | False |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1166" href="#L1166">1166</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-edition&quot;&gt;&lt;/a&gt;edition |  The rust edition to be used by default (2015, 2018, or 2021). If absent, every rule is required to specify its &lt;code&gt;edition&lt;/code&gt; attribute.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1167" href="#L1167">1167</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-exec_triple&quot;&gt;&lt;/a&gt;exec_triple |  The Rust-style target that this compiler runs on   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1168" href="#L1168">1168</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-extra_target_triples&quot;&gt;&lt;/a&gt;extra_target_triples |  Additional rust-style targets that this set of toolchains should support.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1169" href="#L1169">1169</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-include_rustc_srcs&quot;&gt;&lt;/a&gt;include_rustc_srcs |  Whether to download and unpack the rustc source files. These are very large, and slow to unpack, but are required to support rust analyzer. An environment variable &lt;code&gt;RULES_RUST_TOOLCHAIN_INCLUDE_RUSTC_SRCS&lt;/code&gt; can also be used to control this attribute. This variable will take precedence over the hard coded attribute. Setting it to &lt;code&gt;true&lt;/code&gt; to activates this attribute where all other values deactivate it.   | Boolean | optional | False |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1170" href="#L1170">1170</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-iso_date&quot;&gt;&lt;/a&gt;iso_date |  The date of the tool (or None, if the version is a specific version).   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1171" href="#L1171">1171</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-repo_mapping&quot;&gt;&lt;/a&gt;repo_mapping |  A dictionary from local repository name to global repository name. This allows controls over workspace dependency resolution for dependencies of this repository.&amp;lt;p&amp;gt;For example, an entry &lt;code&gt;&quot;@foo&quot;: &quot;@bar&quot;&lt;/code&gt; declares that, for any time this repository depends on &lt;code&gt;@foo&lt;/code&gt; (such as a dependency on &lt;code&gt;@foo//some:target&lt;/code&gt;, it should actually resolve that dependency within globally-declared &lt;code&gt;@bar&lt;/code&gt; (&lt;code&gt;@bar//some:target&lt;/code&gt;).   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1172" href="#L1172">1172</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-rustfmt_version&quot;&gt;&lt;/a&gt;rustfmt_version |  The version of the tool among &quot;nightly&quot;, &quot;beta&quot;, or an exact version.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1173" href="#L1173">1173</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-sha256s&quot;&gt;&lt;/a&gt;sha256s |  A dict associating tool subdirectories to sha256 hashes. See [rust_repositories](#rust_repositories) for more details.   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | optional | {} |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1174" href="#L1174">1174</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-toolchain_name_prefix&quot;&gt;&lt;/a&gt;toolchain_name_prefix |  The per-target prefix expected for the rust_toolchain declarations in the parent workspace.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1175" href="#L1175">1175</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-urls&quot;&gt;&lt;/a&gt;urls |  A list of mirror urls containing the tools from the Rust-lang static file server. These must contain the &#39;{}&#39; used to substitute the tool being fetched (using .format).   | List of strings | optional | [&quot;https://static.rust-lang.org/dist/{}.tar.gz&quot;] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1176" href="#L1176">1176</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository-version&quot;&gt;&lt;/a&gt;version |  The version of the tool among &quot;nightly&quot;, &quot;beta&quot;, or an exact version.   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1177" href="#L1177">1177</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1178" href="#L1178">1178</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1179" href="#L1179">1179</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_toolchain_repository_proxy&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1180" href="#L1180">1180</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1181" href="#L1181">1181</a><span class="code-text"><a-p>## </a-p><a-tt>rust_toolchain_repository_proxy</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1182" href="#L1182">1182</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1183" href="#L1183">1183</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1184" href="#L1184">1184</a><span class="code-text"><a-p>rust_toolchain_repository_proxy(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository_proxy-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository_proxy-exec_triple</a-s><a-p>&quot;&gt;exec_triple&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository_proxy-extra_target_triples</a-s><a-p>&quot;&gt;extra_target_triples&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository_proxy-parent_workspace_name</a-s><a-p>&quot;&gt;parent_workspace_name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1185" href="#L1185">1185</a><span class="code-text"><a-p>                                &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository_proxy-repo_mapping</a-s><a-p>&quot;&gt;repo_mapping&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_toolchain_repository_proxy-toolchain_name_prefix</a-s><a-p>&quot;&gt;toolchain_name_prefix&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1186" href="#L1186">1186</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1187" href="#L1187">1187</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1188" href="#L1188">1188</a><span class="code-text"><a-p>Generates a toolchain-bearing repository that declares the toolchains from some other rust_toolchain_repository.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1189" href="#L1189">1189</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1190" href="#L1190">1190</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1191" href="#L1191">1191</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1192" href="#L1192">1192</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1193" href="#L1193">1193</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1194" href="#L1194">1194</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1195" href="#L1195">1195</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository_proxy-name&quot;&gt;&lt;/a&gt;name |  A unique name for this repository.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1196" href="#L1196">1196</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository_proxy-exec_triple&quot;&gt;&lt;/a&gt;exec_triple |  The Rust-style target triple for the compilation platform   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1197" href="#L1197">1197</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository_proxy-extra_target_triples&quot;&gt;&lt;/a&gt;extra_target_triples |  The Rust-style triples for extra compilation targets   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1198" href="#L1198">1198</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository_proxy-parent_workspace_name&quot;&gt;&lt;/a&gt;parent_workspace_name |  The name of the other rust_toolchain_repository   | String | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1199" href="#L1199">1199</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository_proxy-repo_mapping&quot;&gt;&lt;/a&gt;repo_mapping |  A dictionary from local repository name to global repository name. This allows controls over workspace dependency resolution for dependencies of this repository.&amp;lt;p&amp;gt;For example, an entry &lt;code&gt;&quot;@foo&quot;: &quot;@bar&quot;&lt;/code&gt; declares that, for any time this repository depends on &lt;code&gt;@foo&lt;/code&gt; (such as a dependency on &lt;code&gt;@foo//some:target&lt;/code&gt;, it should actually resolve that dependency within globally-declared &lt;code&gt;@bar&lt;/code&gt; (&lt;code&gt;@bar//some:target&lt;/code&gt;).   | &lt;a href=&quot;https://bazel.build/docs/skylark/lib/dict.html&quot;&gt;Dictionary: String -&gt; String&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1200" href="#L1200">1200</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_toolchain_repository_proxy-toolchain_name_prefix&quot;&gt;&lt;/a&gt;toolchain_name_prefix |  The per-target prefix expected for the rust_toolchain declarations in the parent workspace.   | String | optional | &quot;&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1201" href="#L1201">1201</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1202" href="#L1202">1202</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1203" href="#L1203">1203</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_wasm_bindgen&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1204" href="#L1204">1204</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1205" href="#L1205">1205</a><span class="code-text"><a-p>## </a-p><a-tt>rust_wasm_bindgen</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1206" href="#L1206">1206</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1207" href="#L1207">1207</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1208" href="#L1208">1208</a><span class="code-text"><a-p>rust_wasm_bindgen(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_wasm_bindgen-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_wasm_bindgen-bindgen_flags</a-s><a-p>&quot;&gt;bindgen_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_wasm_bindgen-target</a-s><a-p>&quot;&gt;target&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_wasm_bindgen-wasm_file</a-s><a-p>&quot;&gt;wasm_file&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1209" href="#L1209">1209</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1210" href="#L1210">1210</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1211" href="#L1211">1211</a><span class="code-text"><a-p>Generates javascript and typescript bindings for a webassembly module using [wasm-bindgen][ws].</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1212" href="#L1212">1212</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1213" href="#L1213">1213</a><span class="code-text"><a-tu>[ws]</a-tu><a-p>: </a-p><a-tu>https://rustwasm.github.io/docs/wasm-bindgen/</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1214" href="#L1214">1214</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1215" href="#L1215">1215</a><span class="code-text"><a-p>To use the Rust WebAssembly bindgen rules, add the following to your `WORKSPACE` file to add the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1216" href="#L1216">1216</a><span class="code-text"><a-p>external repositories for the Rust bindgen toolchain (in addition to the Rust rules setup):</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1217" href="#L1217">1217</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1218" href="#L1218">1218</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1219" href="#L1219">1219</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//wasm_bindgen:repositories.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_wasm_bindgen_repositories&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1220" href="#L1220">1220</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1221" href="#L1221">1221</a><span class="code-text"><a-p>rust_wasm_bindgen_repositories()</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1222" href="#L1222">1222</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1223" href="#L1223">1223</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1224" href="#L1224">1224</a><span class="code-text"><a-p>For more details on `rust_wasm_bindgen_repositories`, see [here](#rust_wasm_bindgen_repositories).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1225" href="#L1225">1225</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1226" href="#L1226">1226</a><span class="code-text"><a-p>An example of this rule in use can be seen at [@rules_rust//examples/wasm](../examples/wasm)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1227" href="#L1227">1227</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1228" href="#L1228">1228</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1229" href="#L1229">1229</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1230" href="#L1230">1230</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1231" href="#L1231">1231</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1232" href="#L1232">1232</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1233" href="#L1233">1233</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1234" href="#L1234">1234</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_wasm_bindgen-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1235" href="#L1235">1235</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_wasm_bindgen-bindgen_flags&quot;&gt;&lt;/a&gt;bindgen_flags |  Flags to pass directly to the bindgen executable. See https://github.com/rustwasm/wasm-bindgen/ for details.   | List of strings | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1236" href="#L1236">1236</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_wasm_bindgen-target&quot;&gt;&lt;/a&gt;target |  The type of output to generate. See https://rustwasm.github.io/wasm-bindgen/reference/deployment.html for details.   | String | optional | &quot;bundler&quot; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1237" href="#L1237">1237</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_wasm_bindgen-wasm_file&quot;&gt;&lt;/a&gt;wasm_file |  The &lt;code&gt;.wasm&lt;/code&gt; file or crate to generate bindings for.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1238" href="#L1238">1238</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1239" href="#L1239">1239</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1240" href="#L1240">1240</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_wasm_bindgen_toolchain&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1241" href="#L1241">1241</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1242" href="#L1242">1242</a><span class="code-text"><a-p>## </a-p><a-tt>rust_wasm_bindgen_toolchain</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1243" href="#L1243">1243</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1244" href="#L1244">1244</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1245" href="#L1245">1245</a><span class="code-text"><a-p>rust_wasm_bindgen_toolchain(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_wasm_bindgen_toolchain-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_wasm_bindgen_toolchain-bindgen</a-s><a-p>&quot;&gt;bindgen&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1246" href="#L1246">1246</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1247" href="#L1247">1247</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1248" href="#L1248">1248</a><span class="code-text"><a-p>The tools required for the `rust_wasm_bindgen` rule.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1249" href="#L1249">1249</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1250" href="#L1250">1250</a><span class="code-text"><a-p>In cases where users want to control or change the version of `wasm-bindgen` used by [rust_wasm_bindgen](#rust_wasm_bindgen),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1251" href="#L1251">1251</a><span class="code-text"><a-p>a unique toolchain can be created as in the example below:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1252" href="#L1252">1252</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1253" href="#L1253">1253</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1254" href="#L1254">1254</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//bindgen:bindgen.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_bindgen_toolchain&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1255" href="#L1255">1255</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1256" href="#L1256">1256</a><span class="code-text"><a-p>rust_bindgen_toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1257" href="#L1257">1257</a><span class="code-text"><a-p>    </a-p><a-v>bindgen</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;//my/cargo_raze:cargo_bin_wasm_bindgen&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1258" href="#L1258">1258</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1259" href="#L1259">1259</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1260" href="#L1260">1260</a><span class="code-text"><a-p>toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1261" href="#L1261">1261</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;wasm_bindgen_toolchain&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1262" href="#L1262">1262</a><span class="code-text"><a-p>    </a-p><a-v>toolchain</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;wasm_bindgen_toolchain_impl&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1263" href="#L1263">1263</a><span class="code-text"><a-p>    </a-p><a-v>toolchain_type</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;@rules_rust//wasm_bindgen:wasm_bindgen_toolchain&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1264" href="#L1264">1264</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1265" href="#L1265">1265</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1266" href="#L1266">1266</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1267" href="#L1267">1267</a><span class="code-text"><a-p>Now that you have your own toolchain, you need to register it by</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1268" href="#L1268">1268</a><span class="code-text"><a-p>inserting the following statement in your `WORKSPACE` file:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1269" href="#L1269">1269</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1270" href="#L1270">1270</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1271" href="#L1271">1271</a><span class="code-text"><a-p>register_toolchains(</a-p><a-s>&quot;//my/toolchains:wasm_bindgen_toolchain&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1272" href="#L1272">1272</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1273" href="#L1273">1273</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1274" href="#L1274">1274</a><span class="code-text"><a-p>For additional information, see the [Bazel toolchains documentation][toolchains].</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1275" href="#L1275">1275</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1276" href="#L1276">1276</a><span class="code-text"><a-tu>[toolchains]</a-tu><a-p>: </a-p><a-tu>https://docs.bazel.build/versions/master/toolchains.html</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1277" href="#L1277">1277</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1278" href="#L1278">1278</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1279" href="#L1279">1279</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1280" href="#L1280">1280</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1281" href="#L1281">1281</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1282" href="#L1282">1282</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1283" href="#L1283">1283</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1284" href="#L1284">1284</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_wasm_bindgen_toolchain-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1285" href="#L1285">1285</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_wasm_bindgen_toolchain-bindgen&quot;&gt;&lt;/a&gt;bindgen |  The label of a &lt;code&gt;wasm-bindgen-cli&lt;/code&gt; executable.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;Label&lt;/a&gt; | optional | None |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1286" href="#L1286">1286</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1287" href="#L1287">1287</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1288" href="#L1288">1288</a><span class="code-text"><a-p>&lt;a id=&quot;#rustfmt_test&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1289" href="#L1289">1289</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1290" href="#L1290">1290</a><span class="code-text"><a-p>## </a-p><a-tt>rustfmt_test</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1291" href="#L1291">1291</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1292" href="#L1292">1292</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1293" href="#L1293">1293</a><span class="code-text"><a-p>rustfmt_test(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rustfmt_test-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rustfmt_test-targets</a-s><a-p>&quot;&gt;targets&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1294" href="#L1294">1294</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1295" href="#L1295">1295</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1296" href="#L1296">1296</a><span class="code-text"><a-p>A test rule for performing `rustfmt --check` on a set of targets</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1297" href="#L1297">1297</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1298" href="#L1298">1298</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1299" href="#L1299">1299</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1300" href="#L1300">1300</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1301" href="#L1301">1301</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1302" href="#L1302">1302</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1303" href="#L1303">1303</a><span class="code-text"><a-p>| &lt;a id=&quot;rustfmt_test-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1304" href="#L1304">1304</a><span class="code-text"><a-p>| &lt;a id=&quot;rustfmt_test-targets&quot;&gt;&lt;/a&gt;targets |  Rust targets to run &lt;code&gt;rustfmt --check&lt;/code&gt; on.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#labels&quot;&gt;List of labels&lt;/a&gt; | optional | [] |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1305" href="#L1305">1305</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1306" href="#L1306">1306</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1307" href="#L1307">1307</a><span class="code-text"><a-p>&lt;a id=&quot;#CrateInfo&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1308" href="#L1308">1308</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1309" href="#L1309">1309</a><span class="code-text"><a-p>## </a-p><a-tt>CrateInfo</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1310" href="#L1310">1310</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1311" href="#L1311">1311</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1312" href="#L1312">1312</a><span class="code-text"><a-p>CrateInfo(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-aliases</a-s><a-p>&quot;&gt;aliases&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-compile_data</a-s><a-p>&quot;&gt;compile_data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-is_test</a-s><a-p>&quot;&gt;is_test&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-output</a-s><a-p>&quot;&gt;output&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-owner</a-s><a-p>&quot;&gt;owner&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-proc_macro_deps</a-s><a-p>&quot;&gt;proc_macro_deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-root</a-s><a-p>&quot;&gt;root&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1313" href="#L1313">1313</a><span class="code-text"><a-p>          &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-rustc_env</a-s><a-p>&quot;&gt;rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-type</a-s><a-p>&quot;&gt;type&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#CrateInfo-wrapped_crate_type</a-s><a-p>&quot;&gt;wrapped_crate_type&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1314" href="#L1314">1314</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1315" href="#L1315">1315</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1316" href="#L1316">1316</a><span class="code-text"><a-p>A provider containing general Crate information.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1317" href="#L1317">1317</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1318" href="#L1318">1318</a><span class="code-text"><a-p>**FIELDS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1319" href="#L1319">1319</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1320" href="#L1320">1320</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1321" href="#L1321">1321</a><span class="code-text"><a-p>| Name  | Description |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1322" href="#L1322">1322</a><span class="code-text"><a-p>| :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1323" href="#L1323">1323</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-aliases&quot;&gt;&lt;/a&gt;aliases |  Dict[Label, String]: Renamed and aliased crates    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1324" href="#L1324">1324</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-compile_data&quot;&gt;&lt;/a&gt;compile_data |  depset[File]: Compile data required by this crate.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1325" href="#L1325">1325</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-deps&quot;&gt;&lt;/a&gt;deps |  depset[DepVariantInfo]: This crate&#39;s (rust or cc) dependencies&#39; providers.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1326" href="#L1326">1326</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-edition&quot;&gt;&lt;/a&gt;edition |  str: The edition of this crate.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1327" href="#L1327">1327</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-is_test&quot;&gt;&lt;/a&gt;is_test |  bool: If the crate is being compiled in a test context    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1328" href="#L1328">1328</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-name&quot;&gt;&lt;/a&gt;name |  str: The name of this crate.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1329" href="#L1329">1329</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-output&quot;&gt;&lt;/a&gt;output |  File: The output File that will be produced, depends on crate type.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1330" href="#L1330">1330</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-owner&quot;&gt;&lt;/a&gt;owner |  Label: The label of the target that produced this CrateInfo    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1331" href="#L1331">1331</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-proc_macro_deps&quot;&gt;&lt;/a&gt;proc_macro_deps |  depset[DepVariantInfo]: This crate&#39;s rust proc_macro dependencies&#39; providers.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1332" href="#L1332">1332</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-root&quot;&gt;&lt;/a&gt;root |  File: The source File entrypoint to this crate, eg. lib.rs    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1333" href="#L1333">1333</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-rustc_env&quot;&gt;&lt;/a&gt;rustc_env |  Dict[String, String]: Additional &lt;code&gt;&quot;key&quot;: &quot;value&quot;&lt;/code&gt; environment variables to set for rustc.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1334" href="#L1334">1334</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-srcs&quot;&gt;&lt;/a&gt;srcs |  depset[File]: All source Files that are part of the crate.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1335" href="#L1335">1335</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-type&quot;&gt;&lt;/a&gt;type |  str: The type of this crate (see [rustc --crate-type](https://doc.rust-lang.org/rustc/command-line-arguments.html#--crate-type-a-list-of-types-of-crates-for-the-compiler-to-emit)).    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1336" href="#L1336">1336</a><span class="code-text"><a-p>| &lt;a id=&quot;CrateInfo-wrapped_crate_type&quot;&gt;&lt;/a&gt;wrapped_crate_type |  str, optional: The original crate type for targets generated using a previously defined crate (typically tests using the &lt;code&gt;rust_test::crate&lt;/code&gt; attribute)    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1337" href="#L1337">1337</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1338" href="#L1338">1338</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1339" href="#L1339">1339</a><span class="code-text"><a-p>&lt;a id=&quot;#DepInfo&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1340" href="#L1340">1340</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1341" href="#L1341">1341</a><span class="code-text"><a-p>## </a-p><a-tt>DepInfo</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1342" href="#L1342">1342</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1343" href="#L1343">1343</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1344" href="#L1344">1344</a><span class="code-text"><a-p>DepInfo(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#DepInfo-dep_env</a-s><a-p>&quot;&gt;dep_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#DepInfo-direct_crates</a-s><a-p>&quot;&gt;direct_crates&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#DepInfo-link_search_path_files</a-s><a-p>&quot;&gt;link_search_path_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#DepInfo-transitive_build_infos</a-s><a-p>&quot;&gt;transitive_build_infos&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1345" href="#L1345">1345</a><span class="code-text"><a-p>        &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#DepInfo-transitive_crate_outputs</a-s><a-p>&quot;&gt;transitive_crate_outputs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#DepInfo-transitive_crates</a-s><a-p>&quot;&gt;transitive_crates&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#DepInfo-transitive_noncrates</a-s><a-p>&quot;&gt;transitive_noncrates&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1346" href="#L1346">1346</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1347" href="#L1347">1347</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1348" href="#L1348">1348</a><span class="code-text"><a-p>A provider containing information about a Crate&#39;s dependencies.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1349" href="#L1349">1349</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1350" href="#L1350">1350</a><span class="code-text"><a-p>**FIELDS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1351" href="#L1351">1351</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1352" href="#L1352">1352</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1353" href="#L1353">1353</a><span class="code-text"><a-p>| Name  | Description |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1354" href="#L1354">1354</a><span class="code-text"><a-p>| :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1355" href="#L1355">1355</a><span class="code-text"><a-p>| &lt;a id=&quot;DepInfo-dep_env&quot;&gt;&lt;/a&gt;dep_env |  File: File with environment variables direct dependencies build scripts rely upon.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1356" href="#L1356">1356</a><span class="code-text"><a-p>| &lt;a id=&quot;DepInfo-direct_crates&quot;&gt;&lt;/a&gt;direct_crates |  depset[AliasableDepInfo]    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1357" href="#L1357">1357</a><span class="code-text"><a-p>| &lt;a id=&quot;DepInfo-link_search_path_files&quot;&gt;&lt;/a&gt;link_search_path_files |  depset[File]: All transitive files containing search paths to pass to the linker    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1358" href="#L1358">1358</a><span class="code-text"><a-p>| &lt;a id=&quot;DepInfo-transitive_build_infos&quot;&gt;&lt;/a&gt;transitive_build_infos |  depset[BuildInfo]    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1359" href="#L1359">1359</a><span class="code-text"><a-p>| &lt;a id=&quot;DepInfo-transitive_crate_outputs&quot;&gt;&lt;/a&gt;transitive_crate_outputs |  depset[File]: All transitive crate outputs.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1360" href="#L1360">1360</a><span class="code-text"><a-p>| &lt;a id=&quot;DepInfo-transitive_crates&quot;&gt;&lt;/a&gt;transitive_crates |  depset[CrateInfo]    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1361" href="#L1361">1361</a><span class="code-text"><a-p>| &lt;a id=&quot;DepInfo-transitive_noncrates&quot;&gt;&lt;/a&gt;transitive_noncrates |  depset[LinkerInput]: All transitive dependencies that aren&#39;t crates.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1362" href="#L1362">1362</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1363" href="#L1363">1363</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1364" href="#L1364">1364</a><span class="code-text"><a-p>&lt;a id=&quot;#StdLibInfo&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1365" href="#L1365">1365</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1366" href="#L1366">1366</a><span class="code-text"><a-p>## </a-p><a-tt>StdLibInfo</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1367" href="#L1367">1367</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1368" href="#L1368">1368</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1369" href="#L1369">1369</a><span class="code-text"><a-p>StdLibInfo(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-alloc_files</a-s><a-p>&quot;&gt;alloc_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-between_alloc_and_core_files</a-s><a-p>&quot;&gt;between_alloc_and_core_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-between_core_and_std_files</a-s><a-p>&quot;&gt;between_core_and_std_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-core_files</a-s><a-p>&quot;&gt;core_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1370" href="#L1370">1370</a><span class="code-text"><a-p>           &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-dot_a_files</a-s><a-p>&quot;&gt;dot_a_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-memchr_files</a-s><a-p>&quot;&gt;memchr_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-self_contained_files</a-s><a-p>&quot;&gt;self_contained_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-std_files</a-s><a-p>&quot;&gt;std_files&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#StdLibInfo-std_rlibs</a-s><a-p>&quot;&gt;std_rlibs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1371" href="#L1371">1371</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1372" href="#L1372">1372</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1373" href="#L1373">1373</a><span class="code-text"><a-p>A collection of files either found within the `rust-stdlib` artifact or generated based on existing files.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1374" href="#L1374">1374</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1375" href="#L1375">1375</a><span class="code-text"><a-p>**FIELDS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1376" href="#L1376">1376</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1377" href="#L1377">1377</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1378" href="#L1378">1378</a><span class="code-text"><a-p>| Name  | Description |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1379" href="#L1379">1379</a><span class="code-text"><a-p>| :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1380" href="#L1380">1380</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-alloc_files&quot;&gt;&lt;/a&gt;alloc_files |  List[File]: &lt;code&gt;.a&lt;/code&gt; files related to the &lt;code&gt;alloc&lt;/code&gt; module.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1381" href="#L1381">1381</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-between_alloc_and_core_files&quot;&gt;&lt;/a&gt;between_alloc_and_core_files |  List[File]: &lt;code&gt;.a&lt;/code&gt; files related to the &lt;code&gt;compiler_builtins&lt;/code&gt; module.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1382" href="#L1382">1382</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-between_core_and_std_files&quot;&gt;&lt;/a&gt;between_core_and_std_files |  List[File]: &lt;code&gt;.a&lt;/code&gt; files related to all modules except &lt;code&gt;adler&lt;/code&gt;, &lt;code&gt;alloc&lt;/code&gt;, &lt;code&gt;compiler_builtins&lt;/code&gt;, &lt;code&gt;core&lt;/code&gt;, and &lt;code&gt;std&lt;/code&gt;.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1383" href="#L1383">1383</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-core_files&quot;&gt;&lt;/a&gt;core_files |  List[File]: &lt;code&gt;.a&lt;/code&gt; files related to the &lt;code&gt;core&lt;/code&gt; and &lt;code&gt;adler&lt;/code&gt; modules    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1384" href="#L1384">1384</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-dot_a_files&quot;&gt;&lt;/a&gt;dot_a_files |  Depset[File]: Generated &lt;code&gt;.a&lt;/code&gt; files    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1385" href="#L1385">1385</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-memchr_files&quot;&gt;&lt;/a&gt;memchr_files |  Depset[File]: &lt;code&gt;.a&lt;/code&gt; files associated with the &lt;code&gt;memchr&lt;/code&gt; module.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1386" href="#L1386">1386</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-self_contained_files&quot;&gt;&lt;/a&gt;self_contained_files |  List[File]: All &lt;code&gt;.o&lt;/code&gt; files from the &lt;code&gt;self-contained&lt;/code&gt; directory.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1387" href="#L1387">1387</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-srcs&quot;&gt;&lt;/a&gt;srcs |  List[Target]: All targets from the original &lt;code&gt;srcs&lt;/code&gt; attribute.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1388" href="#L1388">1388</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-std_files&quot;&gt;&lt;/a&gt;std_files |  Depset[File]: &lt;code&gt;.a&lt;/code&gt; files associated with the &lt;code&gt;std&lt;/code&gt; module.    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1389" href="#L1389">1389</a><span class="code-text"><a-p>| &lt;a id=&quot;StdLibInfo-std_rlibs&quot;&gt;&lt;/a&gt;std_rlibs |  List[File]: All &lt;code&gt;.rlib&lt;/code&gt; files    |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1390" href="#L1390">1390</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1391" href="#L1391">1391</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1392" href="#L1392">1392</a><span class="code-text"><a-p>&lt;a id=&quot;#cargo_build_script&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1393" href="#L1393">1393</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1394" href="#L1394">1394</a><span class="code-text"><a-p>## </a-p><a-tt>cargo_build_script</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1395" href="#L1395">1395</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1396" href="#L1396">1396</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1397" href="#L1397">1397</a><span class="code-text"><a-p>cargo_build_script(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-crate_features</a-s><a-p>&quot;&gt;crate_features&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-deps</a-s><a-p>&quot;&gt;deps&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-build_script_env</a-s><a-p>&quot;&gt;build_script_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-data</a-s><a-p>&quot;&gt;data&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-tools</a-s><a-p>&quot;&gt;tools&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-links</a-s><a-p>&quot;&gt;links&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1398" href="#L1398">1398</a><span class="code-text"><a-p>                   &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-rustc_env</a-s><a-p>&quot;&gt;rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-rustc_flags</a-s><a-p>&quot;&gt;rustc_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-visibility</a-s><a-p>&quot;&gt;visibility&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-tags</a-s><a-p>&quot;&gt;tags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_build_script-kwargs</a-s><a-p>&quot;&gt;kwargs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1399" href="#L1399">1399</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1400" href="#L1400">1400</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1401" href="#L1401">1401</a><span class="code-text"><a-p>Compile and execute a rust build script to generate build attributes</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1402" href="#L1402">1402</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1403" href="#L1403">1403</a><span class="code-text"><a-p>This rules take the same arguments as rust_binary.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1404" href="#L1404">1404</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1405" href="#L1405">1405</a><span class="code-text"><a-p>Example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1406" href="#L1406">1406</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1407" href="#L1407">1407</a><span class="code-text"><a-p>Suppose you have a crate with a cargo build script `build.rs`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1408" href="#L1408">1408</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1409" href="#L1409">1409</a><span class="code-text"><a-p>```</a-p><a-tl>output</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1410" href="#L1410">1410</a><span class="code-text"><a-p>[workspace]/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1411" href="#L1411">1411</a><span class="code-text"><a-p>    hello_lib/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1412" href="#L1412">1412</a><span class="code-text"><a-p>        BUILD</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1413" href="#L1413">1413</a><span class="code-text"><a-p>        build.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1414" href="#L1414">1414</a><span class="code-text"><a-p>        src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1415" href="#L1415">1415</a><span class="code-text"><a-p>            lib.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1416" href="#L1416">1416</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1417" href="#L1417">1417</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1418" href="#L1418">1418</a><span class="code-text"><a-p>Then you want to use the build script in the following:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1419" href="#L1419">1419</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1420" href="#L1420">1420</a><span class="code-text"><a-p>`hello_lib/BUILD`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1421" href="#L1421">1421</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1422" href="#L1422">1422</a><span class="code-text"><a-p>package(</a-p><a-v>default_visibility</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;//visibility:public&quot;</a-s><a-p>])</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1423" href="#L1423">1423</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1424" href="#L1424">1424</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_binary&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1425" href="#L1425">1425</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//cargo:cargo_build_script.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;cargo_build_script&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1426" href="#L1426">1426</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1427" href="#L1427">1427</a><span class="code-text"><a-p># This will run the build script from the root of the workspace, and</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1428" href="#L1428">1428</a><span class="code-text"><a-p># collect the outputs.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1429" href="#L1429">1429</a><span class="code-text"><a-p>cargo_build_script(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1430" href="#L1430">1430</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;build_script&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1431" href="#L1431">1431</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;build.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1432" href="#L1432">1432</a><span class="code-text"><a-p>    </a-p><a-c># Optional environment variables passed during build.rs compilation</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1433" href="#L1433">1433</a><span class="code-text"><a-p>    </a-p><a-v>rustc_env</a-v><a-p> </a-p><a-o>=</a-o><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1434" href="#L1434">1434</a><span class="code-text"><a-p>       </a-p><a-s>&quot;CARGO_PKG_VERSION&quot;</a-s><a-p>: </a-p><a-s>&quot;0.1.2&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1435" href="#L1435">1435</a><span class="code-text"><a-p>    },</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1436" href="#L1436">1436</a><span class="code-text"><a-p>    </a-p><a-c># Optional environment variables passed during build.rs execution.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1437" href="#L1437">1437</a><span class="code-text"><a-p>    </a-p><a-c># Note that as the build script&#39;s working directory is not execroot,</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1438" href="#L1438">1438</a><span class="code-text"><a-p>    </a-p><a-c># execpath/location will return an absolute path, instead of a relative</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1439" href="#L1439">1439</a><span class="code-text"><a-p>    </a-p><a-c># one.</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1440" href="#L1440">1440</a><span class="code-text"><a-p>    </a-p><a-v>build_script_env</a-v><a-p> </a-p><a-o>=</a-o><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1441" href="#L1441">1441</a><span class="code-text"><a-p>        </a-p><a-s>&quot;SOME_TOOL_OR_FILE&quot;</a-s><a-p>: </a-p><a-s>&quot;$(execpath @tool//:binary)&quot;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1442" href="#L1442">1442</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1443" href="#L1443">1443</a><span class="code-text"><a-p>    </a-p><a-c># Optional data/tool dependencies</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1444" href="#L1444">1444</a><span class="code-text"><a-p>    </a-p><a-v>data</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;@tool//:binary&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1445" href="#L1445">1445</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1446" href="#L1446">1446</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1447" href="#L1447">1447</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1448" href="#L1448">1448</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1449" href="#L1449">1449</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1450" href="#L1450">1450</a><span class="code-text"><a-p>        </a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1451" href="#L1451">1451</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1452" href="#L1452">1452</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;:build_script&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1453" href="#L1453">1453</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1454" href="#L1454">1454</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1455" href="#L1455">1455</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1456" href="#L1456">1456</a><span class="code-text"><a-p>The `hello_lib` target will be build with the flags and the environment variables declared by the     build script in addition to the file generated by it.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1457" href="#L1457">1457</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1458" href="#L1458">1458</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1459" href="#L1459">1459</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1460" href="#L1460">1460</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1461" href="#L1461">1461</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1462" href="#L1462">1462</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1463" href="#L1463">1463</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1464" href="#L1464">1464</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-name&quot;&gt;&lt;/a&gt;name |  The name for the underlying rule. This should be the name of the package being compiled, optionally with a suffix of _build_script.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1465" href="#L1465">1465</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-crate_features&quot;&gt;&lt;/a&gt;crate_features |  A list of features to enable for the build script.   |  &lt;code&gt;[]&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1466" href="#L1466">1466</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-version&quot;&gt;&lt;/a&gt;version |  The semantic version (semver) of the crate.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1467" href="#L1467">1467</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-deps&quot;&gt;&lt;/a&gt;deps |  The dependencies of the crate.   |  &lt;code&gt;[]&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1468" href="#L1468">1468</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-build_script_env&quot;&gt;&lt;/a&gt;build_script_env |  Environment variables for build scripts.   |  &lt;code&gt;{}&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1469" href="#L1469">1469</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-data&quot;&gt;&lt;/a&gt;data |  Files needed by the build script.   |  &lt;code&gt;[]&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1470" href="#L1470">1470</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-tools&quot;&gt;&lt;/a&gt;tools |  Tools (executables) needed by the build script.   |  &lt;code&gt;[]&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1471" href="#L1471">1471</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-links&quot;&gt;&lt;/a&gt;links |  Name of the native library this crate links against.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1472" href="#L1472">1472</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-rustc_env&quot;&gt;&lt;/a&gt;rustc_env |  Environment variables to set in rustc when compiling the build script.   |  &lt;code&gt;{}&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1473" href="#L1473">1473</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-rustc_flags&quot;&gt;&lt;/a&gt;rustc_flags |  List of compiler flags passed to &lt;code&gt;rustc&lt;/code&gt;.   |  &lt;code&gt;[]&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1474" href="#L1474">1474</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-visibility&quot;&gt;&lt;/a&gt;visibility |  Visibility to apply to the generated build script output.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1475" href="#L1475">1475</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-tags&quot;&gt;&lt;/a&gt;tags |  (list of str, optional): Tags to apply to the generated build script output.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1476" href="#L1476">1476</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_build_script-kwargs&quot;&gt;&lt;/a&gt;kwargs |  Forwards to the underlying &lt;code&gt;rust_binary&lt;/code&gt; rule.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1477" href="#L1477">1477</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1478" href="#L1478">1478</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1479" href="#L1479">1479</a><span class="code-text"><a-p>&lt;a id=&quot;#cargo_env&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1480" href="#L1480">1480</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1481" href="#L1481">1481</a><span class="code-text"><a-p>## </a-p><a-tt>cargo_env</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1482" href="#L1482">1482</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1483" href="#L1483">1483</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1484" href="#L1484">1484</a><span class="code-text"><a-p>cargo_env(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#cargo_env-env</a-s><a-p>&quot;&gt;env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1485" href="#L1485">1485</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1486" href="#L1486">1486</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1487" href="#L1487">1487</a><span class="code-text"><a-p>A helper for generating platform specific environment variables</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1488" href="#L1488">1488</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1489" href="#L1489">1489</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1490" href="#L1490">1490</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_common&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1491" href="#L1491">1491</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//cargo:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;cargo_bootstrap_repository&quot;</a-s><a-p>, </a-p><a-s>&quot;cargo_env&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1492" href="#L1492">1492</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1493" href="#L1493">1493</a><span class="code-text"><a-p>cargo_bootstrap_repository(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1494" href="#L1494">1494</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;bootstrapped_bin&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1495" href="#L1495">1495</a><span class="code-text"><a-p>    </a-p><a-v>cargo_lockfile</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;//:Cargo.lock&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1496" href="#L1496">1496</a><span class="code-text"><a-p>    </a-p><a-v>cargo_toml</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;//:Cargo.toml&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1497" href="#L1497">1497</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;//:resolver_srcs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1498" href="#L1498">1498</a><span class="code-text"><a-p>    </a-p><a-v>version</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-v>rust_common</a-v><a-p>.</a-p><a-pr>default_version</a-pr><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1499" href="#L1499">1499</a><span class="code-text"><a-p>    </a-p><a-v>binary</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;my-crate-binary&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1500" href="#L1500">1500</a><span class="code-text"><a-p>    </a-p><a-v>env</a-v><a-p> </a-p><a-o>=</a-o><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1501" href="#L1501">1501</a><span class="code-text"><a-p>        </a-p><a-s>&quot;x86_64-unknown-linux-gnu&quot;</a-s><a-p>: </a-p><a-f>cargo_env</a-f><a-p>({</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1502" href="#L1502">1502</a><span class="code-text"><a-p>            </a-p><a-s>&quot;FOO&quot;</a-s><a-p>: </a-p><a-s>&quot;BAR&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1503" href="#L1503">1503</a><span class="code-text"><a-p>        }),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1504" href="#L1504">1504</a><span class="code-text"><a-p>    },</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1505" href="#L1505">1505</a><span class="code-text"><a-p>    </a-p><a-v>env_label</a-v><a-p> </a-p><a-o>=</a-o><a-p> {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1506" href="#L1506">1506</a><span class="code-text"><a-p>        </a-p><a-s>&quot;aarch64-unknown-linux-musl&quot;</a-s><a-p>: </a-p><a-f>cargo_env</a-f><a-p>({</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1507" href="#L1507">1507</a><span class="code-text"><a-p>            </a-p><a-s>&quot;DOC&quot;</a-s><a-p>: </a-p><a-s>&quot;//:README.md&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1508" href="#L1508">1508</a><span class="code-text"><a-p>        }),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1509" href="#L1509">1509</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1510" href="#L1510">1510</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1511" href="#L1511">1511</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1512" href="#L1512">1512</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1513" href="#L1513">1513</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1514" href="#L1514">1514</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1515" href="#L1515">1515</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1516" href="#L1516">1516</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1517" href="#L1517">1517</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1518" href="#L1518">1518</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1519" href="#L1519">1519</a><span class="code-text"><a-p>| &lt;a id=&quot;cargo_env-env&quot;&gt;&lt;/a&gt;env |  A map of environment variables   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1520" href="#L1520">1520</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1521" href="#L1521">1521</a><span class="code-text"><a-p>**RETURNS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1522" href="#L1522">1522</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1523" href="#L1523">1523</a><span class="code-text"><a-p>str: A json encoded string of the environment variables</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1524" href="#L1524">1524</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1525" href="#L1525">1525</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1526" href="#L1526">1526</a><span class="code-text"><a-p>&lt;a id=&quot;#rules_rust_dependencies&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1527" href="#L1527">1527</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1528" href="#L1528">1528</a><span class="code-text"><a-p>## </a-p><a-tt>rules_rust_dependencies</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1529" href="#L1529">1529</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1530" href="#L1530">1530</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1531" href="#L1531">1531</a><span class="code-text"><a-p>rules_rust_dependencies()</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1532" href="#L1532">1532</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1533" href="#L1533">1533</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1534" href="#L1534">1534</a><span class="code-text"><a-p>Dependencies used in the implementation of `rules_rust`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1535" href="#L1535">1535</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1536" href="#L1536">1536</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1537" href="#L1537">1537</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1538" href="#L1538">1538</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_bindgen_dependencies&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1539" href="#L1539">1539</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1540" href="#L1540">1540</a><span class="code-text"><a-p>## </a-p><a-tt>rust_bindgen_dependencies</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1541" href="#L1541">1541</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1542" href="#L1542">1542</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1543" href="#L1543">1543</a><span class="code-text"><a-p>rust_bindgen_dependencies()</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1544" href="#L1544">1544</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1545" href="#L1545">1545</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1546" href="#L1546">1546</a><span class="code-text"><a-p>Declare dependencies needed for bindgen.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1547" href="#L1547">1547</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1548" href="#L1548">1548</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1549" href="#L1549">1549</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1550" href="#L1550">1550</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_bindgen_library&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1551" href="#L1551">1551</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1552" href="#L1552">1552</a><span class="code-text"><a-p>## </a-p><a-tt>rust_bindgen_library</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1553" href="#L1553">1553</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1554" href="#L1554">1554</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1555" href="#L1555">1555</a><span class="code-text"><a-p>rust_bindgen_library(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_library-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_library-header</a-s><a-p>&quot;&gt;header&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_library-cc_lib</a-s><a-p>&quot;&gt;cc_lib&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_library-bindgen_flags</a-s><a-p>&quot;&gt;bindgen_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_library-clang_flags</a-s><a-p>&quot;&gt;clang_flags&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_library-rustfmt</a-s><a-p>&quot;&gt;rustfmt&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_library-kwargs</a-s><a-p>&quot;&gt;kwargs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1556" href="#L1556">1556</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1557" href="#L1557">1557</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1558" href="#L1558">1558</a><span class="code-text"><a-p>Generates a rust source file for `header`, and builds a rust_library.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1559" href="#L1559">1559</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1560" href="#L1560">1560</a><span class="code-text"><a-p>Arguments are the same as `rust_bindgen`, and `kwargs` are passed directly to rust_library.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1561" href="#L1561">1561</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1562" href="#L1562">1562</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1563" href="#L1563">1563</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1564" href="#L1564">1564</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1565" href="#L1565">1565</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1566" href="#L1566">1566</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1567" href="#L1567">1567</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1568" href="#L1568">1568</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_library-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1569" href="#L1569">1569</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_library-header&quot;&gt;&lt;/a&gt;header |  The label of the .h file to generate bindings for.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1570" href="#L1570">1570</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_library-cc_lib&quot;&gt;&lt;/a&gt;cc_lib |  The label of the cc_library that contains the .h file. This is used to find the transitive includes.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1571" href="#L1571">1571</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_library-bindgen_flags&quot;&gt;&lt;/a&gt;bindgen_flags |  Flags to pass directly to the bindgen executable. See https://rust-lang.github.io/rust-bindgen/ for details.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1572" href="#L1572">1572</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_library-clang_flags&quot;&gt;&lt;/a&gt;clang_flags |  Flags to pass directly to the clang executable.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1573" href="#L1573">1573</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_library-rustfmt&quot;&gt;&lt;/a&gt;rustfmt |  Enable or disable running rustfmt on the generated file.   |  &lt;code&gt;True&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1574" href="#L1574">1574</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_library-kwargs&quot;&gt;&lt;/a&gt;kwargs |  Arguments to forward to the underlying &lt;code&gt;rust_library&lt;/code&gt; rule.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1575" href="#L1575">1575</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1576" href="#L1576">1576</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1577" href="#L1577">1577</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_bindgen_register_toolchains&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1578" href="#L1578">1578</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1579" href="#L1579">1579</a><span class="code-text"><a-p>## </a-p><a-tt>rust_bindgen_register_toolchains</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1580" href="#L1580">1580</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1581" href="#L1581">1581</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1582" href="#L1582">1582</a><span class="code-text"><a-p>rust_bindgen_register_toolchains(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_bindgen_register_toolchains-register_toolchains</a-s><a-p>&quot;&gt;register_toolchains&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1583" href="#L1583">1583</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1584" href="#L1584">1584</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1585" href="#L1585">1585</a><span class="code-text"><a-p>Registers the default toolchains for the `rules_rust` [bindgen][bg] rules.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1586" href="#L1586">1586</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1587" href="#L1587">1587</a><span class="code-text"><a-tu>[bg]</a-tu><a-p>: </a-p><a-tu>https://rust-lang.github.io/rust-bindgen/</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1588" href="#L1588">1588</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1589" href="#L1589">1589</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1590" href="#L1590">1590</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1591" href="#L1591">1591</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1592" href="#L1592">1592</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1593" href="#L1593">1593</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1594" href="#L1594">1594</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1595" href="#L1595">1595</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_bindgen_register_toolchains-register_toolchains&quot;&gt;&lt;/a&gt;register_toolchains |  Whether or not to register toolchains.   |  &lt;code&gt;True&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1596" href="#L1596">1596</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1597" href="#L1597">1597</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1598" href="#L1598">1598</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_proto_repositories&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1599" href="#L1599">1599</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1600" href="#L1600">1600</a><span class="code-text"><a-p>## </a-p><a-tt>rust_proto_repositories</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1601" href="#L1601">1601</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1602" href="#L1602">1602</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1603" href="#L1603">1603</a><span class="code-text"><a-p>rust_proto_repositories(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_proto_repositories-register_default_toolchain</a-s><a-p>&quot;&gt;register_default_toolchain&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1604" href="#L1604">1604</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1605" href="#L1605">1605</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1606" href="#L1606">1606</a><span class="code-text"><a-p>Declare dependencies needed for proto compilation.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1607" href="#L1607">1607</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1608" href="#L1608">1608</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1609" href="#L1609">1609</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1610" href="#L1610">1610</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1611" href="#L1611">1611</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1612" href="#L1612">1612</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1613" href="#L1613">1613</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_proto_repositories-register_default_toolchain&quot;&gt;&lt;/a&gt;register_default_toolchain |  If True, the default [rust_proto_toolchain](#rust_proto_toolchain) (&lt;code&gt;@rules_rust//proto:default-proto-toolchain&lt;/code&gt;) is registered. This toolchain requires a set of dependencies that were generated using [cargo raze](https://github.com/google/cargo-raze). These will also be loaded.   |  &lt;code&gt;True&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1614" href="#L1614">1614</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1615" href="#L1615">1615</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1616" href="#L1616">1616</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_proto_transitive_repositories&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1617" href="#L1617">1617</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1618" href="#L1618">1618</a><span class="code-text"><a-p>## </a-p><a-tt>rust_proto_transitive_repositories</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1619" href="#L1619">1619</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1620" href="#L1620">1620</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1621" href="#L1621">1621</a><span class="code-text"><a-p>rust_proto_transitive_repositories()</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1622" href="#L1622">1622</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1623" href="#L1623">1623</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1624" href="#L1624">1624</a><span class="code-text"><a-p>Load transitive dependencies of the `@rules_rust//proto` rules.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1625" href="#L1625">1625</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1626" href="#L1626">1626</a><span class="code-text"><a-p>This macro should be called immediately after the `rust_proto_repositories` macro.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1627" href="#L1627">1627</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1628" href="#L1628">1628</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1629" href="#L1629">1629</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1630" href="#L1630">1630</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_register_toolchains&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1631" href="#L1631">1631</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1632" href="#L1632">1632</a><span class="code-text"><a-p>## </a-p><a-tt>rust_register_toolchains</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1633" href="#L1633">1633</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1634" href="#L1634">1634</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1635" href="#L1635">1635</a><span class="code-text"><a-p>rust_register_toolchains(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-dev_components</a-s><a-p>&quot;&gt;dev_components&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-include_rustc_srcs</a-s><a-p>&quot;&gt;include_rustc_srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-iso_date</a-s><a-p>&quot;&gt;iso_date&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-register_toolchains</a-s><a-p>&quot;&gt;register_toolchains&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1636" href="#L1636">1636</a><span class="code-text"><a-p>                         &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-rustfmt_version</a-s><a-p>&quot;&gt;rustfmt_version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-sha256s</a-s><a-p>&quot;&gt;sha256s&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-extra_target_triples</a-s><a-p>&quot;&gt;extra_target_triples&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-urls</a-s><a-p>&quot;&gt;urls&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_register_toolchains-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1637" href="#L1637">1637</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1638" href="#L1638">1638</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1639" href="#L1639">1639</a><span class="code-text"><a-p>Emits a default set of toolchains for Linux, MacOS, and Freebsd</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1640" href="#L1640">1640</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1641" href="#L1641">1641</a><span class="code-text"><a-p>Skip this macro and call the `rust_repository_set` macros directly if you need a compiler for     other hosts or for additional target triples.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1642" href="#L1642">1642</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1643" href="#L1643">1643</a><span class="code-text"><a-p>The `sha256` attribute represents a dict associating tool subdirectories to sha256 hashes. As an example:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1644" href="#L1644">1644</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1645" href="#L1645">1645</a><span class="code-text"><a-p>{</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1646" href="#L1646">1646</a><span class="code-text"><a-p>    </a-p><a-s>&quot;rust-1.46.0-x86_64-unknown-linux-gnu&quot;</a-s><a-p>: </a-p><a-s>&quot;e3b98bc3440fe92817881933f9564389eccb396f5f431f33d48b979fa2fbdcf5&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1647" href="#L1647">1647</a><span class="code-text"><a-p>    </a-p><a-s>&quot;rustfmt-1.4.12-x86_64-unknown-linux-gnu&quot;</a-s><a-p>: </a-p><a-s>&quot;1894e76913303d66bf40885a601462844eec15fca9e76a6d13c390d7000d64b0&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1648" href="#L1648">1648</a><span class="code-text"><a-p>    </a-p><a-s>&quot;rust-std-1.46.0-x86_64-unknown-linux-gnu&quot;</a-s><a-p>: </a-p><a-s>&quot;ac04aef80423f612c0079829b504902de27a6997214eb58ab0765d02f7ec1dbc&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1649" href="#L1649">1649</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1650" href="#L1650">1650</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1651" href="#L1651">1651</a><span class="code-text"><a-p>This would match for `exec_triple = &quot;x86_64-unknown-linux-gnu&quot;`.  If not specified, rules_rust pulls from a non-exhaustive     list of known checksums..</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1652" href="#L1652">1652</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1653" href="#L1653">1653</a><span class="code-text"><a-p>See `load_arbitrary_tool` in `@rules_rust//rust:repositories.bzl` for more details.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1654" href="#L1654">1654</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1655" href="#L1655">1655</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1656" href="#L1656">1656</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1657" href="#L1657">1657</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1658" href="#L1658">1658</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1659" href="#L1659">1659</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1660" href="#L1660">1660</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1661" href="#L1661">1661</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-dev_components&quot;&gt;&lt;/a&gt;dev_components |  Whether to download the rustc-dev components (defaults to False). Requires version to be &quot;nightly&quot;.   |  &lt;code&gt;False&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1662" href="#L1662">1662</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-edition&quot;&gt;&lt;/a&gt;edition |  The rust edition to be used by default (2015, 2018, or 2021). If absent, every target is required to specify its &lt;code&gt;edition&lt;/code&gt; attribute.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1663" href="#L1663">1663</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-include_rustc_srcs&quot;&gt;&lt;/a&gt;include_rustc_srcs |  Whether to download rustc&#39;s src code. This is required in order to use rust-analyzer support. See [rust_toolchain_repository.include_rustc_srcs](#rust_toolchain_repository-include_rustc_srcs). for more details   |  &lt;code&gt;False&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1664" href="#L1664">1664</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-iso_date&quot;&gt;&lt;/a&gt;iso_date |  The date of the nightly or beta release (ignored if the version is a specific version).   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1665" href="#L1665">1665</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-register_toolchains&quot;&gt;&lt;/a&gt;register_toolchains |  If true, repositories will be generated to produce and register &lt;code&gt;rust_toolchain&lt;/code&gt; targets.   |  &lt;code&gt;True&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1666" href="#L1666">1666</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-rustfmt_version&quot;&gt;&lt;/a&gt;rustfmt_version |  The version of rustfmt. Either &quot;nightly&quot;, &quot;beta&quot;, or an exact version. Defaults to &lt;code&gt;version&lt;/code&gt; if not specified.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1667" href="#L1667">1667</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-sha256s&quot;&gt;&lt;/a&gt;sha256s |  A dict associating tool subdirectories to sha256 hashes.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1668" href="#L1668">1668</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-extra_target_triples&quot;&gt;&lt;/a&gt;extra_target_triples |  Additional rust-style targets that rust toolchains should support.   |  &lt;code&gt;[&quot;wasm32-unknown-unknown&quot;, &quot;wasm32-wasi&quot;]&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1669" href="#L1669">1669</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-urls&quot;&gt;&lt;/a&gt;urls |  A list of mirror urls containing the tools from the Rust-lang static file server. These must contain the &#39;{}&#39; used to substitute the tool being fetched (using .format).   |  &lt;code&gt;[&quot;https://static.rust-lang.org/dist/{}.tar.gz&quot;]&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1670" href="#L1670">1670</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_register_toolchains-version&quot;&gt;&lt;/a&gt;version |  The version of Rust. Either &quot;nightly&quot;, &quot;beta&quot;, or an exact version. Defaults to a modern version.   |  &lt;code&gt;&quot;1.62.0&quot;&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1671" href="#L1671">1671</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1672" href="#L1672">1672</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1673" href="#L1673">1673</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_repositories&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1674" href="#L1674">1674</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1675" href="#L1675">1675</a><span class="code-text"><a-p>## </a-p><a-tt>rust_repositories</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1676" href="#L1676">1676</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1677" href="#L1677">1677</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1678" href="#L1678">1678</a><span class="code-text"><a-p>rust_repositories(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repositories-kwargs</a-s><a-p>&quot;&gt;kwargs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1679" href="#L1679">1679</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1680" href="#L1680">1680</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1681" href="#L1681">1681</a><span class="code-text"><a-p>**Deprecated**: Use [rules_rust_dependencies](#rules_rust_dependencies)     and [rust_register_toolchains](#rust_register_toolchains) directly.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1682" href="#L1682">1682</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1683" href="#L1683">1683</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1684" href="#L1684">1684</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1685" href="#L1685">1685</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1686" href="#L1686">1686</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1687" href="#L1687">1687</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1688" href="#L1688">1688</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repositories-kwargs&quot;&gt;&lt;/a&gt;kwargs |  Keyword arguments for the &lt;code&gt;rust_register_toolchains&lt;/code&gt; macro.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1689" href="#L1689">1689</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1690" href="#L1690">1690</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1691" href="#L1691">1691</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_repository_set&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1692" href="#L1692">1692</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1693" href="#L1693">1693</a><span class="code-text"><a-p>## </a-p><a-tt>rust_repository_set</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1694" href="#L1694">1694</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1695" href="#L1695">1695</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1696" href="#L1696">1696</a><span class="code-text"><a-p>rust_repository_set(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-version</a-s><a-p>&quot;&gt;version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-exec_triple</a-s><a-p>&quot;&gt;exec_triple&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-include_rustc_srcs</a-s><a-p>&quot;&gt;include_rustc_srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-extra_target_triples</a-s><a-p>&quot;&gt;extra_target_triples&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-iso_date</a-s><a-p>&quot;&gt;iso_date&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1697" href="#L1697">1697</a><span class="code-text"><a-p>                    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-rustfmt_version</a-s><a-p>&quot;&gt;rustfmt_version&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-edition</a-s><a-p>&quot;&gt;edition&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-dev_components</a-s><a-p>&quot;&gt;dev_components&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-sha256s</a-s><a-p>&quot;&gt;sha256s&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-urls</a-s><a-p>&quot;&gt;urls&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-auth</a-s><a-p>&quot;&gt;auth&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_repository_set-register_toolchain</a-s><a-p>&quot;&gt;register_toolchain&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1698" href="#L1698">1698</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1699" href="#L1699">1699</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1700" href="#L1700">1700</a><span class="code-text"><a-p>Assembles a remote repository for the given toolchain params, produces a proxy repository     to contain the toolchain declaration, and registers the toolchains.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1701" href="#L1701">1701</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1702" href="#L1702">1702</a><span class="code-text"><a-p>N.B. A &quot;proxy repository&quot; is needed to allow for registering the toolchain (with constraints)     without actually downloading the toolchain.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1703" href="#L1703">1703</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1704" href="#L1704">1704</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1705" href="#L1705">1705</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1706" href="#L1706">1706</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1707" href="#L1707">1707</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1708" href="#L1708">1708</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1709" href="#L1709">1709</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1710" href="#L1710">1710</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-name&quot;&gt;&lt;/a&gt;name |  The name of the generated repository   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1711" href="#L1711">1711</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-version&quot;&gt;&lt;/a&gt;version |  The version of the tool among &quot;nightly&quot;, &quot;beta&#39;, or an exact version.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1712" href="#L1712">1712</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-exec_triple&quot;&gt;&lt;/a&gt;exec_triple |  The Rust-style target that this compiler runs on   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1713" href="#L1713">1713</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-include_rustc_srcs&quot;&gt;&lt;/a&gt;include_rustc_srcs |  Whether to download rustc&#39;s src code. This is required in order to use rust-analyzer support. Defaults to False.   |  &lt;code&gt;False&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1714" href="#L1714">1714</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-extra_target_triples&quot;&gt;&lt;/a&gt;extra_target_triples |  Additional rust-style targets that this set of toolchains should support. Defaults to [].   |  &lt;code&gt;[]&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1715" href="#L1715">1715</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-iso_date&quot;&gt;&lt;/a&gt;iso_date |  The date of the tool. Defaults to None.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1716" href="#L1716">1716</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-rustfmt_version&quot;&gt;&lt;/a&gt;rustfmt_version |  The version of rustfmt to be associated with the toolchain. Defaults to None.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1717" href="#L1717">1717</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-edition&quot;&gt;&lt;/a&gt;edition |  The rust edition to be used by default (2015, 2018, or 2021). If absent, every rule is required to specify its &lt;code&gt;edition&lt;/code&gt; attribute.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1718" href="#L1718">1718</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-dev_components&quot;&gt;&lt;/a&gt;dev_components |  Whether to download the rustc-dev components. Requires version to be &quot;nightly&quot;. Defaults to False.   |  &lt;code&gt;False&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1719" href="#L1719">1719</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-sha256s&quot;&gt;&lt;/a&gt;sha256s |  A dict associating tool subdirectories to sha256 hashes. See [rust_repositories](#rust_repositories) for more details.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1720" href="#L1720">1720</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-urls&quot;&gt;&lt;/a&gt;urls |  A list of mirror urls containing the tools from the Rust-lang static file server. These must contain the &#39;{}&#39; used to substitute the tool being fetched (using .format). Defaults to [&#39;https://static.rust-lang.org/dist/{}.tar.gz&#39;]   |  &lt;code&gt;[&quot;https://static.rust-lang.org/dist/{}.tar.gz&quot;]&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1721" href="#L1721">1721</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-auth&quot;&gt;&lt;/a&gt;auth |  Auth object compatible with repository_ctx.download to use when downloading files. See [repository_ctx.download](https://docs.bazel.build/versions/main/skylark/lib/repository_ctx.html#download) for more details.   |  &lt;code&gt;None&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1722" href="#L1722">1722</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_repository_set-register_toolchain&quot;&gt;&lt;/a&gt;register_toolchain |  If True, the generated &lt;code&gt;rust_toolchain&lt;/code&gt; target will become a registered toolchain.   |  &lt;code&gt;True&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1723" href="#L1723">1723</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1724" href="#L1724">1724</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1725" href="#L1725">1725</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_test_suite&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1726" href="#L1726">1726</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1727" href="#L1727">1727</a><span class="code-text"><a-p>## </a-p><a-tt>rust_test_suite</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1728" href="#L1728">1728</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1729" href="#L1729">1729</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1730" href="#L1730">1730</a><span class="code-text"><a-p>rust_test_suite(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test_suite-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test_suite-srcs</a-s><a-p>&quot;&gt;srcs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_test_suite-kwargs</a-s><a-p>&quot;&gt;kwargs&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1731" href="#L1731">1731</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1732" href="#L1732">1732</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1733" href="#L1733">1733</a><span class="code-text"><a-p>A rule for creating a test suite for a set of `rust_test` targets.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1734" href="#L1734">1734</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1735" href="#L1735">1735</a><span class="code-text"><a-p>This rule can be used for setting up typical rust [integration tests][it]. Given the following</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1736" href="#L1736">1736</a><span class="code-text"><a-p>directory structure:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1737" href="#L1737">1737</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1738" href="#L1738">1738</a><span class="code-text"><a-p>```</a-p><a-tl>text</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1739" href="#L1739">1739</a><span class="code-text"><a-p>[crate]/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1740" href="#L1740">1740</a><span class="code-text"><a-p>    BUILD.bazel</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1741" href="#L1741">1741</a><span class="code-text"><a-p>    src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1742" href="#L1742">1742</a><span class="code-text"><a-p>        lib.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1743" href="#L1743">1743</a><span class="code-text"><a-p>        main.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1744" href="#L1744">1744</a><span class="code-text"><a-p>    tests/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1745" href="#L1745">1745</a><span class="code-text"><a-p>        integrated_test_a.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1746" href="#L1746">1746</a><span class="code-text"><a-p>        integrated_test_b.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1747" href="#L1747">1747</a><span class="code-text"><a-p>        integrated_test_c.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1748" href="#L1748">1748</a><span class="code-text"><a-p>        patterns/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1749" href="#L1749">1749</a><span class="code-text"><a-p>            fibonacci_test.rs</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1750" href="#L1750">1750</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1751" href="#L1751">1751</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1752" href="#L1752">1752</a><span class="code-text"><a-p>The rule can be used to generate [rust_test](#rust_test) targets for each source file under `tests`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1753" href="#L1753">1753</a><span class="code-text"><a-p>and a [test_suite][ts] which encapsulates all tests.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1754" href="#L1754">1754</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1755" href="#L1755">1755</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1756" href="#L1756">1756</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_binary&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_test_suite&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1757" href="#L1757">1757</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1758" href="#L1758">1758</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1759" href="#L1759">1759</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;math_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1760" href="#L1760">1760</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1761" href="#L1761">1761</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1762" href="#L1762">1762</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1763" href="#L1763">1763</a><span class="code-text"><a-p>rust_binary(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1764" href="#L1764">1764</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;math_bin&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1765" href="#L1765">1765</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/main.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1766" href="#L1766">1766</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1767" href="#L1767">1767</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1768" href="#L1768">1768</a><span class="code-text"><a-p>rust_test_suite(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1769" href="#L1769">1769</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;integrated_tests_suite&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1770" href="#L1770">1770</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-f>glob</a-f><a-p>([</a-p><a-s>&quot;tests/**&quot;</a-s><a-p>]),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1771" href="#L1771">1771</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;:math_lib&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1772" href="#L1772">1772</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1773" href="#L1773">1773</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1774" href="#L1774">1774</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1775" href="#L1775">1775</a><span class="code-text"><a-tu>[it]</a-tu><a-p>: </a-p><a-tu>https://doc.rust-lang.org/rust-by-example/testing/integration_testing.html</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1776" href="#L1776">1776</a><span class="code-text"><a-tu>[ts]</a-tu><a-p>: </a-p><a-tu>https://docs.bazel.build/versions/master/be/general.html#test_suite</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1777" href="#L1777">1777</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1778" href="#L1778">1778</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1779" href="#L1779">1779</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1780" href="#L1780">1780</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1781" href="#L1781">1781</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1782" href="#L1782">1782</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1783" href="#L1783">1783</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1784" href="#L1784">1784</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test_suite-name&quot;&gt;&lt;/a&gt;name |  The name of the &lt;code&gt;test_suite&lt;/code&gt;.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1785" href="#L1785">1785</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test_suite-srcs&quot;&gt;&lt;/a&gt;srcs |  All test sources, typically &lt;code&gt;glob([&quot;tests/**/*.rs&quot;])&lt;/code&gt;.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1786" href="#L1786">1786</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_test_suite-kwargs&quot;&gt;&lt;/a&gt;kwargs |  Additional keyword arguments for the underyling [rust_test](#rust_test) targets. The &lt;code&gt;tags&lt;/code&gt; argument is also passed to the generated &lt;code&gt;test_suite&lt;/code&gt; target.   |  none |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1787" href="#L1787">1787</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1788" href="#L1788">1788</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1789" href="#L1789">1789</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_wasm_bindgen_dependencies&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1790" href="#L1790">1790</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1791" href="#L1791">1791</a><span class="code-text"><a-p>## </a-p><a-tt>rust_wasm_bindgen_dependencies</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1792" href="#L1792">1792</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1793" href="#L1793">1793</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1794" href="#L1794">1794</a><span class="code-text"><a-p>rust_wasm_bindgen_dependencies()</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1795" href="#L1795">1795</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1796" href="#L1796">1796</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1797" href="#L1797">1797</a><span class="code-text"><a-p>Declare dependencies needed for the `rules_rust` [wasm-bindgen][wb] rules.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1798" href="#L1798">1798</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1799" href="#L1799">1799</a><span class="code-text"><a-tu>[wb]</a-tu><a-p>: </a-p><a-tu>https://github.com/rustwasm/wasm-bindgen</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1800" href="#L1800">1800</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1801" href="#L1801">1801</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1802" href="#L1802">1802</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1803" href="#L1803">1803</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_wasm_bindgen_register_toolchains&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1804" href="#L1804">1804</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1805" href="#L1805">1805</a><span class="code-text"><a-p>## </a-p><a-tt>rust_wasm_bindgen_register_toolchains</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1806" href="#L1806">1806</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1807" href="#L1807">1807</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1808" href="#L1808">1808</a><span class="code-text"><a-p>rust_wasm_bindgen_register_toolchains(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_wasm_bindgen_register_toolchains-register_toolchains</a-s><a-p>&quot;&gt;register_toolchains&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1809" href="#L1809">1809</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1810" href="#L1810">1810</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1811" href="#L1811">1811</a><span class="code-text"><a-p>Registers the default toolchains for the `rules_rust` [wasm-bindgen][wb] rules.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1812" href="#L1812">1812</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1813" href="#L1813">1813</a><span class="code-text"><a-tu>[wb]</a-tu><a-p>: </a-p><a-tu>https://github.com/rustwasm/wasm-bindgen</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1814" href="#L1814">1814</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1815" href="#L1815">1815</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1816" href="#L1816">1816</a><span class="code-text"><a-p>**PARAMETERS**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1817" href="#L1817">1817</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1818" href="#L1818">1818</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1819" href="#L1819">1819</a><span class="code-text"><a-p>| Name  | Description | Default Value |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1820" href="#L1820">1820</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1821" href="#L1821">1821</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_wasm_bindgen_register_toolchains-register_toolchains&quot;&gt;&lt;/a&gt;register_toolchains |  Whether or not to register toolchains.   |  &lt;code&gt;True&lt;/code&gt; |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1822" href="#L1822">1822</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1823" href="#L1823">1823</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1824" href="#L1824">1824</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_analyzer_aspect&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1825" href="#L1825">1825</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1826" href="#L1826">1826</a><span class="code-text"><a-p>## </a-p><a-tt>rust_analyzer_aspect</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1827" href="#L1827">1827</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1828" href="#L1828">1828</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1829" href="#L1829">1829</a><span class="code-text"><a-p>rust_analyzer_aspect(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_analyzer_aspect-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1830" href="#L1830">1830</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1831" href="#L1831">1831</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1832" href="#L1832">1832</a><span class="code-text"><a-p>Annotates rust rules with RustAnalyzerInfo later used to build a rust-project.json</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1833" href="#L1833">1833</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1834" href="#L1834">1834</a><span class="code-text"><a-p>**ASPECT ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1835" href="#L1835">1835</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1836" href="#L1836">1836</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1837" href="#L1837">1837</a><span class="code-text"><a-p>| Name | Type |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1838" href="#L1838">1838</a><span class="code-text"><a-p>| :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1839" href="#L1839">1839</a><span class="code-text"><a-p>| deps| String |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1840" href="#L1840">1840</a><span class="code-text"><a-p>| proc_macro_deps| String |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1841" href="#L1841">1841</a><span class="code-text"><a-p>| crate| String |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1842" href="#L1842">1842</a><span class="code-text"><a-p>| actual| String |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1843" href="#L1843">1843</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1844" href="#L1844">1844</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1845" href="#L1845">1845</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1846" href="#L1846">1846</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1847" href="#L1847">1847</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1848" href="#L1848">1848</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1849" href="#L1849">1849</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1850" href="#L1850">1850</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_analyzer_aspect-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |   |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1851" href="#L1851">1851</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1852" href="#L1852">1852</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1853" href="#L1853">1853</a><span class="code-text"><a-p>&lt;a id=&quot;#rust_clippy_aspect&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1854" href="#L1854">1854</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1855" href="#L1855">1855</a><span class="code-text"><a-p>## </a-p><a-tt>rust_clippy_aspect</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1856" href="#L1856">1856</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1857" href="#L1857">1857</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1858" href="#L1858">1858</a><span class="code-text"><a-p>rust_clippy_aspect(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rust_clippy_aspect-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1859" href="#L1859">1859</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1860" href="#L1860">1860</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1861" href="#L1861">1861</a><span class="code-text"><a-p>Executes the clippy checker on specified targets.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1862" href="#L1862">1862</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1863" href="#L1863">1863</a><span class="code-text"><a-p>This aspect applies to existing rust_library, rust_test, and rust_binary rules.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1864" href="#L1864">1864</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1865" href="#L1865">1865</a><span class="code-text"><a-p>As an example, if the following is defined in `examples/hello_lib/BUILD.bazel`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1866" href="#L1866">1866</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1867" href="#L1867">1867</a><span class="code-text"><a-p>```</a-p><a-tl>python</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1868" href="#L1868">1868</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_library&quot;</a-s><a-p>, </a-p><a-s>&quot;rust_test&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1869" href="#L1869">1869</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1870" href="#L1870">1870</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1871" href="#L1871">1871</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_lib&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1872" href="#L1872">1872</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;src/lib.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1873" href="#L1873">1873</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1874" href="#L1874">1874</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1875" href="#L1875">1875</a><span class="code-text"><a-p>rust_test(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1876" href="#L1876">1876</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;greeting_test&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1877" href="#L1877">1877</a><span class="code-text"><a-p>    </a-p><a-v>srcs</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;tests/greeting.rs&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1878" href="#L1878">1878</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;:hello_lib&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1879" href="#L1879">1879</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1880" href="#L1880">1880</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1881" href="#L1881">1881</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1882" href="#L1882">1882</a><span class="code-text"><a-p>Then the targets can be analyzed with clippy using the following command:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1883" href="#L1883">1883</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1884" href="#L1884">1884</a><span class="code-text"><a-p>```</a-p><a-tl>output</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1885" href="#L1885">1885</a><span class="code-text"><a-p>$ bazel build --aspects=@rules_rust//rust:defs.bzl%rust_clippy_aspect               --output_groups=clippy_checks //hello_lib:all</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1886" href="#L1886">1886</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1887" href="#L1887">1887</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1888" href="#L1888">1888</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1889" href="#L1889">1889</a><span class="code-text"><a-p>**ASPECT ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1890" href="#L1890">1890</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1891" href="#L1891">1891</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1892" href="#L1892">1892</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1893" href="#L1893">1893</a><span class="code-text"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1894" href="#L1894">1894</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1895" href="#L1895">1895</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1896" href="#L1896">1896</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1897" href="#L1897">1897</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1898" href="#L1898">1898</a><span class="code-text"><a-p>| &lt;a id=&quot;rust_clippy_aspect-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |   |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1899" href="#L1899">1899</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1900" href="#L1900">1900</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1901" href="#L1901">1901</a><span class="code-text"><a-p>&lt;a id=&quot;#rustfmt_aspect&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1902" href="#L1902">1902</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1903" href="#L1903">1903</a><span class="code-text"><a-p>## </a-p><a-tt>rustfmt_aspect</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1904" href="#L1904">1904</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1905" href="#L1905">1905</a><span class="code-text"><a-p>&lt;</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1906" href="#L1906">1906</a><span class="code-text"><a-p>rustfmt_aspect(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#rustfmt_aspect-name</a-s><a-p>&quot;&gt;name&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1907" href="#L1907">1907</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>pre</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1908" href="#L1908">1908</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1909" href="#L1909">1909</a><span class="code-text"><a-p>This aspect is used to gather information about a crate for use in rustfmt and perform rustfmt checks</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1910" href="#L1910">1910</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1911" href="#L1911">1911</a><span class="code-text"><a-p>Output Groups:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1912" href="#L1912">1912</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1913" href="#L1913">1913</a><span class="code-text"><a-p>- `rustfmt_manifest`: A manifest used by rustfmt binaries to provide crate specific settings.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1914" href="#L1914">1914</a><span class="code-text"><a-p>- `rustfmt_checks`: Executes `rustfmt --check` on the specified target.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1915" href="#L1915">1915</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1916" href="#L1916">1916</a><span class="code-text"><a-p>The build setting `@rules_rust//:rustfmt.toml` is used to control the Rustfmt [configuration settings][cs]</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1917" href="#L1917">1917</a><span class="code-text"><a-p>used at runtime.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1918" href="#L1918">1918</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1919" href="#L1919">1919</a><span class="code-text"><a-tu>[cs]</a-tu><a-p>: </a-p><a-tu>https://rust-lang.github.io/rustfmt/</a-tu></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1920" href="#L1920">1920</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1921" href="#L1921">1921</a><span class="code-text">This aspect is executed on any target which provides the `CrateInfo` provider. However</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1922" href="#L1922">1922</a><span class="code-text">users may tag a target with `no-rustfmt` or `no-format` to have it skipped. Additionally,</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1923" href="#L1923">1923</a><span class="code-text">generated source files are also ignored by this aspect.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1924" href="#L1924">1924</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1925" href="#L1925">1925</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1926" href="#L1926">1926</a><span class="code-text">**ASPECT ATTRIBUTES**</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1927" href="#L1927">1927</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1928" href="#L1928">1928</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1929" href="#L1929">1929</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1930" href="#L1930">1930</a><span class="code-text">**ATTRIBUTES**</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1931" href="#L1931">1931</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1932" href="#L1932">1932</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1933" href="#L1933">1933</a><span class="code-text">| Name  | Description | Type | Mandatory | Default |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1934" href="#L1934">1934</a><span class="code-text">| :------------- | :------------- | :------------- | :------------- | :------------- |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1935" href="#L1935">1935</a><span class="code-text">| &lt;a id=&quot;rustfmt_aspect-name&quot;&gt;&lt;/a&gt;name |  A unique name for this target.   | &lt;a href=&quot;https://bazel.build/docs/build-ref.html#name&quot;&gt;Name&lt;/a&gt; | required |   |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1936" href="#L1936">1936</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L1937" href="#L1937">1937</a><span class="code-text"></span></span></pre></div></div>
</main>
</body>
</html>
