<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>docs/defs.md - fork/rules_rust @ 0.8.1</title>
<meta name="description" content="docs/defs.md in fork/rules_rust at 0.8.1.">
<meta property="og:title" content="docs/defs.md - fork/rules_rust @ 0.8.1">
<meta property="og:description" content="docs/defs.md in fork/rules_rust at 0.8.1.">
<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.8.1" data-tip="228ebfa6eb4fb82639882f51d0a84768230f0823">
<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">scentini</span><span class="commit-message" data-commit="daff327ea7923cf4032a52f6b63a44856dbeb0b8">Stamp only binaries by default (#1452)</span><span class="snapshot-sha sha" data-commit="daff327ea7923cf4032a52f6b63a44856dbeb0b8">daff327e</span><time datetime="2022-07-15T13:12:14+00:00" title="2022-07-15 13:12:14 +0000">2022-07-15</time></p>
<header class="topbar"><details class="switcher"><summary>0.8.1</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 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 class="current" 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.8.1/tree/docs/">docs</a> / <span class="cur">defs.md</span></nav>
<span class="view-stats"><span>61.2 KiB</span><span>648 lines</span></span><span class="actions"><a class="raw" href="/fork/rules_rust/raw/7228d32f66bb17efb921611887ec57631e56574e/docs/defs.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">&lt;!-- Generated with Stardoc: http://skydoc.bazel.build --&gt;
<h1>Defs</h1>
<ul>
<li><a href="#rust_binary">rust_binary</a></li>
<li><a href="#rust_library">rust_library</a></li>
<li><a href="#rust_static_library">rust_static_library</a></li>
<li><a href="#rust_shared_library">rust_shared_library</a></li>
<li><a href="#rust_proc_macro">rust_proc_macro</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="#error_format">error_format</a></li>
<li><a href="#extra_rustc_flag">extra_rustc_flag</a></li>
<li><a href="#extra_rustc_flags">extra_rustc_flags</a></li>
<li><a href="#capture_clippy_output">capture_clippy_output</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="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_flag"&gt;&lt;/a&gt;</p>
<h2>extra_rustc_flag</h2>
&lt;pre&gt;
extra_rustc_flag(&lt;a href="#extra_rustc_flag-name"&gt;name&lt;/a&gt;)
&lt;/pre&gt;
<p>Add additional rustc_flag from the command line with <code>--@rules_rust//:extra_rustc_flag</code>. Multiple uses are accumulated and appended after the extra_rustc_flags.</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_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>
</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="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_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">0</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">0</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_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">0</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">0</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_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">0</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_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>
</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-c>&lt;!-- Generated with Stardoc: http://skydoc.bazel.build --&gt;</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"><a-p>#</a-p> <a-tt>Defs</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"></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>[rust_binary](#rust_binary)</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>[rust_library](#rust_library)</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>[rust_static_library](#rust_static_library)</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>[rust_shared_library](#rust_shared_library)</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>[rust_proc_macro](#rust_proc_macro)</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>[rust_test](#rust_test)</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>[rust_test_suite](#rust_test_suite)</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>[error_format](#error_format)</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>[extra_rustc_flag](#extra_rustc_flag)</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>[extra_rustc_flags](#extra_rustc_flags)</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>[capture_clippy_output](#capture_clippy_output)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"></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>&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="L17" href="#L17">17</a><span class="code-text"></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><a-tt>capture_clippy_output</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"></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>&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="L21" href="#L21">21</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="L22" href="#L22">22</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="L23" href="#L23">23</a><span class="code-text"></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>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="L25" href="#L25">25</a><span class="code-text"></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>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"></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>| Name  | Description | Type | Mandatory | Default |</a-p></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></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>| &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="L32" href="#L32">32</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"></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>&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="L35" href="#L35">35</a><span class="code-text"></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><a-tt>error_format</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"></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>&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="L39" href="#L39">39</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="L40" href="#L40">40</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="L41" href="#L41">41</a><span class="code-text"></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>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="L43" href="#L43">43</a><span class="code-text"></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>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"></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>| Name  | Description | Type | Mandatory | Default |</a-p></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></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>| &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="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;extra_rustc_flag&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>extra_rustc_flag</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>extra_rustc_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>#extra_rustc_flag-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>Add additional rustc_flag from the command line with `--@rules_rust//:extra_rustc_flag`. Multiple uses are accumulated and appended after the extra_rustc_flags.</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;extra_rustc_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="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;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="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>extra_rustc_flags</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>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="L76" href="#L76">76</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="L77" href="#L77">77</a><span class="code-text"></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>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="L79" href="#L79">79</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</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="L81" href="#L81">81</a><span class="code-text"></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>| Name  | Description | Type | Mandatory | Default |</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"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</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="L86" href="#L86">86</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"></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;rust_binary&quot;&gt;&lt;/a&gt;</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"></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>## </a-p><a-tt>rust_binary</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"></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-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="L93" href="#L93">93</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="L94" href="#L94">94</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="L95" href="#L95">95</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="L96" href="#L96">96</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="L97" href="#L97">97</a><span class="code-text"></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>Builds a Rust binary crate.</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"></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>Example:</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"></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>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="L103" href="#L103">103</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="L104" href="#L104">104</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="L105" href="#L105">105</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</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="L107" href="#L107">107</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="L108" href="#L108">108</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="L109" href="#L109">109</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="L110" href="#L110">110</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="L111" href="#L111">111</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="L112" href="#L112">112</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="L113" href="#L113">113</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="L114" href="#L114">114</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="L115" href="#L115">115</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="L116" href="#L116">116</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="L117" href="#L117">117</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text"></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>`hello_lib/src/lib.rs`:</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>```</a-p><a-tl>rust</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</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="L122" href="#L122">122</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="L123" href="#L123">123</a><span class="code-text"><a-p>}</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>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="L126" href="#L126">126</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="L127" href="#L127">127</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="L128" href="#L128">128</a><span class="code-text"><a-p>    }</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</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="L131" href="#L131">131</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="L132" href="#L132">132</a><span class="code-text"><a-p>    }</a-p></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>}</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"><a-p>```</a-p></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>`hello_lib/BUILD`:</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><a-tl>python</a-tl></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>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="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"><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="L141" href="#L141">141</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</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="L143" href="#L143">143</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="L144" href="#L144">144</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="L145" href="#L145">145</a><span class="code-text"><a-p>)</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>```</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L148" href="#L148">148</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="L149" href="#L149">149</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="L150" href="#L150">150</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="L151" href="#L151">151</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L152" href="#L152">152</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="L153" href="#L153">153</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="L154" href="#L154">154</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="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>```</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L158" href="#L158">158</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="L159" href="#L159">159</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="L160" href="#L160">160</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="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>rust_binary(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L163" href="#L163">163</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="L164" href="#L164">164</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="L165" href="#L165">165</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="L166" href="#L166">166</a><span class="code-text"><a-p>)</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>```</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L169" href="#L169">169</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="L170" href="#L170">170</a><span class="code-text"><a-p>```</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"><a-p>$ bazel run //hello_world</a-p></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>INFO: Found 1 target...</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"><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="L174" href="#L174">174</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="L175" href="#L175">175</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="L176" href="#L176">176</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L177" href="#L177">177</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="L178" href="#L178">178</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="L179" href="#L179">179</a><span class="code-text"><a-p>```</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"></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>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="L182" href="#L182">182</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="L183" href="#L183">183</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="L184" href="#L184">184</a><span class="code-text"></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>**ATTRIBUTES**</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L187" href="#L187">187</a><span class="code-text"></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>| Name  | Description | Type | Mandatory | Default |</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"><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="L191" href="#L191">191</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="L192" href="#L192">192</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="L193" href="#L193">193</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="L194" href="#L194">194</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="L195" href="#L195">195</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="L196" href="#L196">196</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="L197" href="#L197">197</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="L198" href="#L198">198</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="L199" href="#L199">199</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="L200" href="#L200">200</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="L201" href="#L201">201</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="L202" href="#L202">202</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="L203" href="#L203">203</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="L204" href="#L204">204</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="L205" href="#L205">205</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="L206" href="#L206">206</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="L207" href="#L207">207</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="L208" href="#L208">208</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="L209" href="#L209">209</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L210" href="#L210">210</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L211" href="#L211">211</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="L212" href="#L212">212</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L213" href="#L213">213</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="L214" href="#L214">214</a><span class="code-text"></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>&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="L216" href="#L216">216</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="L217" href="#L217">217</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="L218" href="#L218">218</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="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>Builds a Rust library crate.</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"></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>Example:</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>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="L225" href="#L225">225</a><span class="code-text"></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>```</a-p><a-tl>output</a-tl></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>[workspace]/</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>    WORKSPACE</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"><a-p>    hello_lib/</a-p></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>        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>        src/</a-p></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>            greeter.rs</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"><a-p>            lib.rs</a-p></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>```</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"></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>`hello_lib/src/greeter.rs`:</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-tl>rust</a-tl></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>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="L239" href="#L239">239</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="L240" href="#L240">240</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L241" href="#L241">241</a><span class="code-text"></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>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="L243" href="#L243">243</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="L244" href="#L244">244</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="L245" href="#L245">245</a><span class="code-text"><a-p>    }</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"></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>    </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="L248" href="#L248">248</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="L249" href="#L249">249</a><span class="code-text"><a-p>    }</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>}</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>`hello_lib/src/lib.rs`:</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"></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>```</a-p><a-tl>rust</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L256" href="#L256">256</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="L257" href="#L257">257</a><span class="code-text"><a-p>```</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"><a-p>`hello_lib/BUILD`:</a-p></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>```</a-p><a-tl>python</a-tl></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>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="L262" href="#L262">262</a><span class="code-text"></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>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="L264" href="#L264">264</a><span class="code-text"></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>rust_library(</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>    </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="L267" href="#L267">267</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="L268" href="#L268">268</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="L269" href="#L269">269</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="L270" href="#L270">270</a><span class="code-text"><a-p>    ],</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>)</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>```</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"></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>Build the library:</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>```</a-p><a-tl>output</a-tl></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>$ bazel build //hello_lib</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>INFO: Found 1 target...</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>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="L279" href="#L279">279</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="L280" href="#L280">280</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="L281" href="#L281">281</a><span class="code-text"><a-p>```</a-p></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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L284" href="#L284">284</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="L285" href="#L285">285</a><span class="code-text"></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>| Name  | Description | Type | Mandatory | Default |</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>| :------------- | :------------- | :------------- | :------------- | :------------- |</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 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="L290" href="#L290">290</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="L291" href="#L291">291</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="L292" href="#L292">292</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="L293" href="#L293">293</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="L294" href="#L294">294</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="L295" href="#L295">295</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="L296" href="#L296">296</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="L297" href="#L297">297</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="L298" href="#L298">298</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="L299" href="#L299">299</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="L300" href="#L300">300</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="L301" href="#L301">301</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="L302" href="#L302">302</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="L303" href="#L303">303</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 | 0 |</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"><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="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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L307" href="#L307">307</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="L308" href="#L308">308</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L309" href="#L309">309</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="L310" href="#L310">310</a><span class="code-text"></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>&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="L312" href="#L312">312</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="L313" href="#L313">313</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="L314" href="#L314">314</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="L315" href="#L315">315</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="L316" href="#L316">316</a><span class="code-text"></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>Builds a Rust proc-macro crate.</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"></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>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L321" href="#L321">321</a><span class="code-text"></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>| Name  | Description | Type | Mandatory | Default |</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></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>| &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="L326" href="#L326">326</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="L327" href="#L327">327</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="L328" href="#L328">328</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="L329" href="#L329">329</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="L330" href="#L330">330</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="L331" href="#L331">331</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="L332" href="#L332">332</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="L333" href="#L333">333</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="L334" href="#L334">334</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="L335" href="#L335">335</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="L336" href="#L336">336</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="L337" href="#L337">337</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="L338" href="#L338">338</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="L339" href="#L339">339</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 | 0 |</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"><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="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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L343" href="#L343">343</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="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>## </a-p><a-tt>rust_shared_library</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L346" href="#L346">346</a><span class="code-text"></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-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="L348" href="#L348">348</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="L349" href="#L349">349</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="L350" href="#L350">350</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="L351" href="#L351">351</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="L352" href="#L352">352</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L353" href="#L353">353</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="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>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="L356" href="#L356">356</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="L357" href="#L357">357</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="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>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="L360" href="#L360">360</a><span class="code-text"></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>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="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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L364" href="#L364">364</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="L365" href="#L365">365</a><span class="code-text"></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>| Name  | Description | Type | Mandatory | Default |</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"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></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>| &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="L370" href="#L370">370</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="L371" href="#L371">371</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="L372" href="#L372">372</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="L373" href="#L373">373</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="L374" href="#L374">374</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="L375" href="#L375">375</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="L376" href="#L376">376</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="L377" href="#L377">377</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="L378" href="#L378">378</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="L379" href="#L379">379</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="L380" href="#L380">380</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="L381" href="#L381">381</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="L382" href="#L382">382</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="L383" href="#L383">383</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 | 0 |</a-p></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>| &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="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"></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>&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="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>## </a-p><a-tt>rust_static_library</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L390" href="#L390">390</a><span class="code-text"></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>&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="L392" href="#L392">392</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="L393" href="#L393">393</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="L394" href="#L394">394</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="L395" href="#L395">395</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="L396" href="#L396">396</a><span class="code-text"></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>Builds a Rust static library.</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"><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="L400" href="#L400">400</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="L401" href="#L401">401</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="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>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="L404" href="#L404">404</a><span class="code-text"></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>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="L406" href="#L406">406</a><span class="code-text"></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"><a-p>**ATTRIBUTES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L409" href="#L409">409</a><span class="code-text"></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>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L412" href="#L412">412</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></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 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="L414" href="#L414">414</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="L415" href="#L415">415</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="L416" href="#L416">416</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="L417" href="#L417">417</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="L418" href="#L418">418</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="L419" href="#L419">419</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="L420" href="#L420">420</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="L421" href="#L421">421</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="L422" href="#L422">422</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="L423" href="#L423">423</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="L424" href="#L424">424</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="L425" href="#L425">425</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="L426" href="#L426">426</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="L427" href="#L427">427</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 | 0 |</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>| &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="L429" href="#L429">429</a><span class="code-text"></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>&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="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-p>## </a-p><a-tt>rust_test</a-tt></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>&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="L436" href="#L436">436</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="L437" href="#L437">437</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="L438" href="#L438">438</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="L439" href="#L439">439</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="L440" href="#L440">440</a><span class="code-text"></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>Builds a Rust test crate.</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"></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>Examples:</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>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="L446" href="#L446">446</a><span class="code-text"></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-tl>output</a-tl></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>[workspace]/</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>    WORKSPACE</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"><a-p>    hello_lib/</a-p></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>        BUILD</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"><a-p>        src/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L453" href="#L453">453</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="L454" href="#L454">454</a><span class="code-text"><a-p>```</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"><a-p>`hello_lib/src/lib.rs`:</a-p></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>```</a-p><a-tl>rust</a-tl></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>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="L459" href="#L459">459</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="L460" href="#L460">460</a><span class="code-text"><a-p>}</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"></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>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="L463" href="#L463">463</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="L464" href="#L464">464</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="L465" href="#L465">465</a><span class="code-text"><a-p>    }</a-p></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>    </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="L468" href="#L468">468</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="L469" href="#L469">469</a><span class="code-text"><a-p>    }</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L470" href="#L470">470</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L471" href="#L471">471</a><span class="code-text"></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>#[cfg(test)]</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>mod test {</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"><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="L475" href="#L475">475</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L476" href="#L476">476</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="L477" href="#L477">477</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="L478" href="#L478">478</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="L479" href="#L479">479</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="L480" href="#L480">480</a><span class="code-text"><a-p>    }</a-p></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></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>```</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"></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>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="L485" href="#L485">485</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="L486" href="#L486">486</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="L487" href="#L487">487</a><span class="code-text"></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>`hello_lib/BUILD`:</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"><a-p>```</a-p><a-tl>python</a-tl></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>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="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-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L493" href="#L493">493</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="L494" href="#L494">494</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="L495" href="#L495">495</a><span class="code-text"><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>rust_test(</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"><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="L499" href="#L499">499</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="L500" href="#L500">500</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="L501" href="#L501">501</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="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>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="L505" href="#L505">505</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="L506" href="#L506">506</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="L507" href="#L507">507</a><span class="code-text"></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><a-tt>Example: `test` directory</a-tt></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>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="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"><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="L513" href="#L513">513</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L514" href="#L514">514</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="L515" href="#L515">515</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="L516" href="#L516">516</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="L517" href="#L517">517</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="L518" href="#L518">518</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="L519" href="#L519">519</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="L520" href="#L520">520</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="L521" href="#L521">521</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="L522" href="#L522">522</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="L523" href="#L523">523</a><span class="code-text"><a-p>```</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>`hello_lib/tests/greeting.rs`:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L526" href="#L526">526</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="L527" href="#L527">527</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="L528" href="#L528">528</a><span class="code-text"></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>use hello_lib;</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>#[test]</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"><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="L533" href="#L533">533</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="L534" href="#L534">534</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="L535" href="#L535">535</a><span class="code-text"><a-p>}</a-p></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>```</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>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="L539" href="#L539">539</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="L540" href="#L540">540</a><span class="code-text"></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>`hello_lib/BUILD`:</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"><a-p>```</a-p><a-tl>python</a-tl></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>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="L544" href="#L544">544</a><span class="code-text"></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>rust_library(</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><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="L547" href="#L547">547</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="L548" href="#L548">548</a><span class="code-text"><a-p>)</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"></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>rust_test(</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>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="L552" href="#L552">552</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="L553" href="#L553">553</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="L554" href="#L554">554</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L555" href="#L555">555</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L556" href="#L556">556</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L557" href="#L557">557</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="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>**ATTRIBUTES**</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L561" href="#L561">561</a><span class="code-text"></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>| Name  | Description | Type | Mandatory | Default |</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>| :------------- | :------------- | :------------- | :------------- | :------------- |</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"><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="L565" href="#L565">565</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="L566" href="#L566">566</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="L567" href="#L567">567</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="L568" href="#L568">568</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="L569" href="#L569">569</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="L570" href="#L570">570</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="L571" href="#L571">571</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="L572" href="#L572">572</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="L573" href="#L573">573</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="L574" href="#L574">574</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="L575" href="#L575">575</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="L576" href="#L576">576</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="L577" href="#L577">577</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="L578" href="#L578">578</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="L579" href="#L579">579</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="L580" href="#L580">580</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 | 0 |</a-p></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>| &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="L582" href="#L582">582</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="L583" href="#L583">583</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L584" href="#L584">584</a><span class="code-text"></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>&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="L586" href="#L586">586</a><span class="code-text"></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>## </a-p><a-tt>rust_test_suite</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L588" href="#L588">588</a><span class="code-text"></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>&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="L590" href="#L590">590</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="L591" href="#L591">591</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="L592" href="#L592">592</a><span class="code-text"></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>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="L594" href="#L594">594</a><span class="code-text"></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>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="L596" href="#L596">596</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="L597" href="#L597">597</a><span class="code-text"></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-tl>text</a-tl></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>[crate]/</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>    BUILD.bazel</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"><a-p>    src/</a-p></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>        lib.rs</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>        main.rs</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>    tests/</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>        integrated_test_a.rs</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>        integrated_test_b.rs</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"><a-p>        integrated_test_c.rs</a-p></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>        patterns/</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"><a-p>            fibonacci_test.rs</a-p></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></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L611" href="#L611">611</a><span class="code-text"></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>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="L613" href="#L613">613</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="L614" href="#L614">614</a><span class="code-text"></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>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="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>rust_library(</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"><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="L620" href="#L620">620</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="L621" href="#L621">621</a><span class="code-text"><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"></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>rust_binary(</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-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="L625" href="#L625">625</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="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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L628" href="#L628">628</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="L629" href="#L629">629</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="L630" href="#L630">630</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="L631" href="#L631">631</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="L632" href="#L632">632</a><span class="code-text"><a-p>)</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>```</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"></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-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="L636" href="#L636">636</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="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">**PARAMETERS**</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">| Name  | Description | Default Value |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L643" href="#L643">643</a><span class="code-text">| :------------- | :------------- | :------------- |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L644" href="#L644">644</a><span class="code-text">| &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 |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L645" href="#L645">645</a><span class="code-text">| &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 |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L646" href="#L646">646</a><span class="code-text">| &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 |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L647" href="#L647">647</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L648" href="#L648">648</a><span class="code-text"></span></span></pre></div></div>
</main>
</body>
</html>
