<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>docs/src/crate_universe_bzlmod.md - fork/rules_rust @ main</title>
<meta name="description" content="docs/src/crate_universe_bzlmod.md in fork/rules_rust at main.">
<meta property="og:title" content="docs/src/crate_universe_bzlmod.md - fork/rules_rust @ main">
<meta property="og:description" content="docs/src/crate_universe_bzlmod.md in fork/rules_rust at main.">
<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="main" data-tip="c07cb1b5e1bec3184239c28bdddd6c5a0a97d634">
<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">UebelAndre</span><span class="commit-message" data-commit="69ddb09d7093d1595b67c0e2e4450270b1b31866">Added bzlmod support to core rules_rust (#3034)</span><span class="snapshot-sha sha" data-commit="69ddb09d7093d1595b67c0e2e4450270b1b31866">69ddb09d</span><time datetime="2024-12-04T12:27:16-08:00" title="2024-12-04 12:27:16 -0800">2024-12-04</time></p>
<header class="topbar"><details class="switcher"><summary>main</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 class="current" 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 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/main/tree/docs/">docs</a> / <a href="/fork/rules_rust/ref/main/tree/docs/src/">src</a> / <span class="cur">crate_universe_bzlmod.md</span></nav>
<span class="view-stats"><span>30.6 KiB</span><span>456 lines</span></span><span class="actions"><a class="raw" href="/fork/rules_rust/raw/bbaea9476d141ee9c967817f2b132c0622f99070/docs/src/crate_universe_bzlmod.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>Crate Universe</h1>
<p>Crate Universe is a set of Bazel rule for generating Rust targets using Cargo.</p>
<p>This doc describes using crate_universe with bzlmod.</p>
<p>If you're using a WORKSPACE file, please see <a href="crate_universe.html">the WORKSPACE equivalent of this doc</a>.</p>
<p>There are some examples of using crate_universe with bzlmod in the <a href="../examples/bzlmod">example folder</a>.</p>
<h1>Table of Contents</h1>
<ol>
<li><a href="#Setup">Setup</a></li>
<li><a href="#dependencies">Dependencies</a>
<ul>
<li><a href="#cargo-workspaces">Cargo Workspace</a></li>
<li><a href="#direct-dependencies">Direct Packages</a></li>
<li><a href="#vendored-dependencies">Vendored Dependencies</a></li>
</ul>
</li>
<li><a href="#crate">Crate reference</a>
<ul>
<li><a href="#from_cargo">from_cargo</a></li>
<li><a href="#from_specs">from_specs</a></li>
</ul>
</li>
</ol>
<h2>Setup</h2>
<p>To use rules_rust in a project using bzlmod, add the following to your MODULE.bazel file:</p>
<pre class="language-starlark"><a-v>bazel_dep</a-v><a-p>(</a-p><a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;rules_rust&quot;</a-s><a-p>,</a-p> <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;0.49.3&quot;</a-s><a-p>)</a-p></pre>
<p>You find the latest version on the <a href="https://github.com/bazelbuild/rules_rust/releases">release page</a>.</p>
<p>After adding <code>rules_rust</code> in your MODULE.bazel, set the following to begin using <code>crate_universe</code>:</p>
<pre class="language-starlark"><a-v>crate</a-v> <a-o>=</a-o> <a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//crate_universe:extensions.bzl&quot;</a-s><a-p>,</a-p> <a-s>&quot;crate&quot;</a-s><a-p>)</a-p><a-v>
</a-v><a-o>//</a-o><a-v>  # </a-v><a-p>...</a-p><a-v> </a-v><a-v>Dependencies</a-v><a-v>
</a-v><a-v>use_repo</a-v><a-p>(</a-p><a-v>crate</a-v><a-p>,</a-p><a-v> </a-v><a-s>&quot;crates&quot;</a-s><a-p>)</a-p></pre>
<h2>Dependencies</h2>
<p>There are three different ways to declare dependencies in your MODULE.</p>
<ol>
<li>Cargo workspace</li>
<li>Direct Dependencies</li>
<li>Vendored Dependencies</li>
</ol>
<h3>Cargo Workspaces</h3>
<p>One of the simpler ways to wire up dependencies would be to first structure your project into a Cargo workspace.
The crates_repository rule can ingest a root Cargo.toml file and generate Bazel dependencies from there.
You find a complete example in the in the <a href="../examples/bzlmod/all_crate_deps">example folder</a>.</p>
<pre class="language-starlark"><a-v>crate</a-v> <a-o>=</a-o> <a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//crate_universe:extensions.bzl&quot;</a-s><a-p>,</a-p> <a-s>&quot;crate&quot;</a-s><a-p>)</a-p>

<a-v>crate</a-v><a-p>.</a-p><a-v>from_cargo</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;crates&quot;</a-s><a-p>,</a-p>
    <a-v>cargo_lockfile</a-v> <a-o>=</a-o> <a-s>&quot;//:Cargo.lock&quot;</a-s><a-p>,</a-p>
    <a-v>manifests</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;//:Cargo.toml&quot;</a-s><a-p>],</a-p>
<a-p>)</a-p>
<a-v>use_repo</a-v><a-p>(</a-p><a-v>crate</a-v><a-p>,</a-p> <a-s>&quot;crates&quot;</a-s><a-p>)</a-p></pre>
<p>The generated crates_repository contains helper macros which make collecting dependencies for Bazel targets simpler.
Notably, the all_crate_deps and aliases macros (
see <a href="https://bazelbuild.github.io/rules_rust/crate_universe.html#dependencies-api">Dependencies API</a>) commonly allow the
Cargo.toml files to be the single source of truth for dependencies.
Since these macros come from the generated repository, the dependencies and alias definitions
they return will automatically update BUILD targets. In your BUILD files,
you use these macros for a Rust library as shown below:</p>
<pre class="language-starlark"><a-k>load</a-k><a-p>(</a-p><a-s>&quot;@crate_index//:defs.bzl&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;aliases&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;all_crate_deps&quot;</a-s><a-p>)</a-p>
<a-k>load</a-k><a-p>(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;rust_library&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;rust_test&quot;</a-s><a-p>)</a-p>

<a-v>rust_library</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;lib&quot;</a-s><a-p>,</a-p>
    <a-v>aliases</a-v> <a-o>=</a-o> <a-v>aliases</a-v><a-p>(),</a-p>
    <a-v>deps</a-v> <a-o>=</a-o> <a-v>all_crate_deps</a-v><a-p>(</a-p>
        <a-v>normal</a-v> <a-o>=</a-o> <a-co>True</a-co><a-p>,</a-p>
    <a-p>),</a-p>
    <a-v>proc_macro_deps</a-v> <a-o>=</a-o> <a-v>all_crate_deps</a-v><a-p>(</a-p>
        <a-v>proc_macro</a-v> <a-o>=</a-o> <a-co>True</a-co><a-p>,</a-p>
    <a-p>),</a-p>
<a-p>)</a-p>

<a-v>rust_test</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;unit_test&quot;</a-s><a-p>,</a-p>
    <a-v>crate</a-v> <a-o>=</a-o> <a-s>&quot;:lib&quot;</a-s><a-p>,</a-p>
    <a-v>aliases</a-v> <a-o>=</a-o> <a-v>aliases</a-v><a-p>(</a-p>
        <a-v>normal_dev</a-v> <a-o>=</a-o> <a-co>True</a-co><a-p>,</a-p>
        <a-v>proc_macro_dev</a-v> <a-o>=</a-o> <a-co>True</a-co><a-p>,</a-p>
    <a-p>),</a-p>
    <a-v>deps</a-v> <a-o>=</a-o> <a-v>all_crate_deps</a-v><a-p>(</a-p>
        <a-v>normal_dev</a-v> <a-o>=</a-o> <a-co>True</a-co><a-p>,</a-p>
    <a-p>),</a-p>
    <a-v>proc_macro_deps</a-v> <a-o>=</a-o> <a-v>all_crate_deps</a-v><a-p>(</a-p>
        <a-v>proc_macro_dev</a-v> <a-o>=</a-o> <a-co>True</a-co><a-p>,</a-p>
    <a-p>),</a-p>
<a-p>)</a-p></pre>
<p>For a Rust binary that does not depend on any macro, use the following configuration
in your build file:</p>
<pre class="language-starlark"><a-v>rust_binary</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;bin&quot;</a-s><a-p>,</a-p>
    <a-v>srcs</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;src/main.rs&quot;</a-s><a-p>],</a-p>
    <a-v>deps</a-v> <a-o>=</a-o> <a-v>all_crate_deps</a-v><a-p>(</a-p><a-v>normal</a-v> <a-o>=</a-o> <a-co>True</a-co><a-p>),</a-p>
<a-p>)</a-p></pre>
<p>You have to repin before your first build to ensure all Bazel targets for the macros
are generated.</p>
<p>Dependency syncing and updating is done in the repository rule which means it's done during the
analysis phase of builds. As mentioned in the environments variable table above, the <code>CARGO_BAZEL_REPIN</code>
(or <code>REPIN</code>) environment variables can be used to force the rule to update dependencies and potentially
render a new lockfile. Given an instance of this repository rule named <code>crates</code>, the easiest way to
repin dependencies is to run:</p>
<pre class="language-bash"><a-pr>CARGO_BAZEL_REPIN</a-pr>=1 <a-f>bazel</a-f> sync <a-co>--only=crates</a-co></pre>
<p>This will result in all dependencies being updated for a project. The <code>CARGO_BAZEL_REPIN</code>
environment variable can also be used to customize how dependencies are updated.
For more details about repin, <a href="https://bazelbuild.github.io/rules_rust/crate_universe.html#crates_vendor">please refer to the documentation</a>.</p>
<h3>Direct Dependencies</h3>
<p>In cases where Rust targets have heavy interactions with other Bazel targets (<a href="https://docs.bazel.build/versions/main/be/c-cpp.html">Cc</a>, <a href="https://rules-proto-grpc.com/en/4.5.0/lang/rust.html">Proto</a>,
etc.), maintaining Cargo.toml files may have diminishing returns as things like rust-analyzer
begin to be confused about missing targets or environment variables defined only in Bazel.
In situations like this, it may be desirable to have a âCargo freeâ setup. You find an example in the in the <a href="../examples/bzlmod/hello_world_no_cargo">example folder</a>.</p>
<p>crates_repository supports this through the packages attribute,
as shown below.</p>
<pre class="language-starlark"><a-v>crate</a-v> <a-o>=</a-o> <a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//crate_universe:extensions.bzl&quot;</a-s><a-p>,</a-p> <a-s>&quot;crate&quot;</a-s><a-p>)</a-p>

<a-v>crate</a-v><a-p>.</a-p><a-v>spec</a-v><a-p>(</a-p><a-v>package</a-v> <a-o>=</a-o> <a-s>&quot;serde&quot;</a-s><a-p>,</a-p> <a-v>features</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;derive&quot;</a-s><a-p>],</a-p> <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;1.0&quot;</a-s><a-p>)</a-p>
<a-v>crate</a-v><a-p>.</a-p><a-v>spec</a-v><a-p>(</a-p><a-v>package</a-v> <a-o>=</a-o> <a-s>&quot;serde_json&quot;</a-s><a-p>,</a-p> <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;1.0&quot;</a-s><a-p>)</a-p>
<a-v>crate</a-v><a-p>.</a-p><a-v>spec</a-v><a-p>(</a-p><a-v>package</a-v> <a-o>=</a-o> <a-s>&quot;tokio&quot;</a-s><a-p>,</a-p> <a-v>default_features</a-v><a-o>=</a-o><a-co>False</a-co><a-p>,</a-p> <a-v>features</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;macros&quot;</a-s><a-p>,</a-p> <a-s>&quot;net&quot;</a-s><a-p>,</a-p> <a-s>&quot;rt-multi-thread&quot;</a-s><a-p>],</a-p> <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;1.38&quot;</a-s><a-p>)</a-p>

<a-v>crate</a-v><a-p>.</a-p><a-v>from_specs</a-v><a-p>()</a-p>
<a-v>use_repo</a-v><a-p>(</a-p><a-v>crate</a-v><a-p>,</a-p> <a-s>&quot;crates&quot;</a-s><a-p>)</a-p></pre>
<p>Consuming dependencies may be more ergonomic in this case through the aliases defined in the new repository.
In your BUILD files, you use direct dependencies as shown below:</p>
<pre class="language-starlark"><a-v>rust_binary</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;bin&quot;</a-s><a-p>,</a-p>
    <a-v>crate_root</a-v> <a-o>=</a-o> <a-s>&quot;src/main.rs&quot;</a-s><a-p>,</a-p>
    <a-v>srcs</a-v> <a-o>=</a-o> <a-v>glob</a-v><a-p>([</a-p>
        <a-s>&quot;src/*.rs&quot;</a-s><a-p>,</a-p>
    <a-p>]),</a-p>
    <a-v>deps</a-v> <a-o>=</a-o> <a-p>[</a-p>
        <a-c># External crates</a-c>
        <a-s>&quot;@crates//:serde&quot;</a-s><a-p>,</a-p>
        <a-s>&quot;@crates//:serde_json&quot;</a-s><a-p>,</a-p>
        <a-s>&quot;@crates//:tokio&quot;</a-s><a-p>,</a-p>
    <a-p>],</a-p>
    <a-v>visibility</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;//visibility:public&quot;</a-s><a-p>],</a-p>
<a-p>)</a-p></pre>
<p>Notice, direct dependencies do not need repining.
Only a cargo workspace needs updating whenever the underlying Cargo.toml file changed.</p>
<h3>Vendored Dependencies</h3>
<p>In some cases, it is require that all external dependencies are vendored, meaning downloaded
and stored in the workspace. This helps, for example, to conduct licence scans, apply custom patches,
or to ensure full build reproducibility since no download error could possibly occur.
You find a complete example in the in the <a href="../examples/bzlmod/all_deps_vendor">example folder</a>.</p>
<p>For the setup, you need to add the skylib in addition to the rust rules to your MODUE.bazel.</p>
<pre class="language-starlark"><a-v>module</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;deps_vendored&quot;</a-s><a-p>,</a-p>
    <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;0.0.0&quot;</a-s>
<a-p>)</a-p>
<a-c>###############################################################################</a-c>
<a-c># B A Z E L  C E N T R A L  R E G I S T R Y # https://registry.bazel.build/</a-c>
<a-c>###############################################################################</a-c>
<a-c># https://github.com/bazelbuild/bazel-skylib/releases/</a-c>
<a-v>bazel_dep</a-v><a-p>(</a-p><a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;bazel_skylib&quot;</a-s><a-p>,</a-p> <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;1.7.1&quot;</a-s><a-p>)</a-p>

<a-c># https://github.com/bazelbuild/rules_rust/releases</a-c>
<a-v>bazel_dep</a-v><a-p>(</a-p><a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;rules_rust&quot;</a-s><a-p>,</a-p> <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;0.49.3&quot;</a-s><a-p>)</a-p>

<a-c>###############################################################################</a-c>
<a-c># T O O L C H A I N S</a-c>
<a-c>###############################################################################</a-c>

<a-c># Rust toolchain</a-c>
<a-v>RUST_EDITION</a-v> <a-o>=</a-o> <a-s>&quot;2021&quot;</a-s>
<a-v>RUST_VERSION</a-v> <a-o>=</a-o> <a-s>&quot;1.80.1&quot;</a-s>

<a-v>rust</a-v> <a-o>=</a-o> <a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//rust:extensions.bzl&quot;</a-s><a-p>,</a-p> <a-s>&quot;rust&quot;</a-s><a-p>)</a-p>
<a-v>rust</a-v><a-p>.</a-p><a-v>toolchain</a-v><a-p>(</a-p>
    <a-v>edition</a-v> <a-o>=</a-o> <a-v>RUST_EDITION</a-v><a-p>,</a-p>
    <a-v>versions</a-v> <a-o>=</a-o> <a-p>[</a-p><a-v>RUST_VERSION</a-v><a-p>],</a-p>
<a-p>)</a-p>
<a-v>use_repo</a-v><a-p>(</a-p><a-v>rust</a-v><a-p>,</a-p> <a-s>&quot;rust_toolchains&quot;</a-s><a-p>)</a-p>
<a-v>register_toolchains</a-v><a-p>(</a-p><a-s>&quot;@rust_toolchains//:all&quot;</a-s><a-p>)</a-p>

<a-c>###############################################################################</a-c>
<a-c># R U S T  C R A T E S</a-c>
<a-c>###############################################################################</a-c>
<a-v>crate</a-v> <a-o>=</a-o> <a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//crate_universe:extensions.bzl&quot;</a-s><a-p>,</a-p> <a-s>&quot;crate&quot;</a-s><a-p>)</a-p></pre>
<p>Note, it is important to load the crate_universe rules otherwise you will get an error
as the rule set is needed in the vendored target.</p>
<p>Assuming you have a package called <code>basic</code> in which you want to vendor dependencies,
then you create a folder <code>basic/3rdparty</code>. The folder name can be arbitrary,
but by convention, its either thirdparty or 3rdparty to indicate vendored dependencies.
In the 3rdparty folder, you add a target crates_vendor to declare your dependencies to vendor.
In the example, we vendor a specific version of bzip2.</p>
<pre class="language-starlark"><a-k>load</a-k><a-p>(</a-p><a-s>&quot;@rules_rust//crate_universe:defs.bzl&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;crate&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;crates_vendor&quot;</a-s><a-p>)</a-p>

<a-v>crates_vendor</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;crates_vendor&quot;</a-s><a-p>,</a-p>
    <a-v>annotations</a-v> <a-o>=</a-o> <a-p>{</a-p>
        <a-s>&quot;bzip2-sys&quot;</a-s><a-p>:</a-p> <a-p>[</a-p><a-v>crate</a-v><a-p>.</a-p><a-v>annotation</a-v><a-p>(</a-p>
            <a-v>gen_build_script</a-v> <a-o>=</a-o> <a-co>True</a-co><a-p>,</a-p>
        <a-p>)],</a-p>
    <a-p>},</a-p>
    <a-v>cargo_lockfile</a-v> <a-o>=</a-o> <a-s>&quot;Cargo.Bazel.lock&quot;</a-s><a-p>,</a-p>
    <a-v>generate_build_scripts</a-v> <a-o>=</a-o> <a-co>False</a-co><a-p>,</a-p>
    <a-v>mode</a-v> <a-o>=</a-o> <a-s>&quot;remote&quot;</a-s><a-p>,</a-p>
    <a-v>packages</a-v> <a-o>=</a-o> <a-p>{</a-p>
        <a-s>&quot;bzip2&quot;</a-s><a-p>:</a-p> <a-v>crate</a-v><a-p>.</a-p><a-v>spec</a-v><a-p>(</a-p>
            <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;=0.3.3&quot;</a-s><a-p>,</a-p>
        <a-p>),</a-p>
    <a-p>},</a-p>
    <a-v>repository_name</a-v> <a-o>=</a-o> <a-s>&quot;basic&quot;</a-s><a-p>,</a-p>
    <a-v>tags</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;manual&quot;</a-s><a-p>],</a-p>
<a-p>)</a-p></pre>
<p>Next, you have to run <code>Cargo build</code> to generate a Cargo.lock file with all resolved dependencies.
Then, you rename Cargo.lock to Cargo.Bazel.lock and place it inside the <code>basic/3rdparty</code> folder.</p>
<p>At this point, you have the following folder and files:</p>
<pre>basic
    âââ 3rdparty
    â   âââ BUILD.bazel
    â   âââ Cargo.Bazel.lock
</pre>
<p>Now you can run the <code>crates_vendor</code> target:</p>
<p><code>bazel run //basic/3rdparty:crates_vendor</code></p>
<p>This generates a crate folders with all configurations for the vendored dependencies.</p>
<pre>basic
    âââ 3rdparty
    â   âââ cratea
    â   âââ BUILD.bazel
    â   âââ Cargo.Bazel.lock
</pre>
<p>Suppose you have an application in <code>basic/src</code> that is defined in <code>basic/BUILD.bazel</code> and
that depends on a vendored dependency. You find a list of all available vendored dependencies
in the BUILD file of the generated folder: <code>basic/3rdparty/crates/BUILD.bazel</code>
You declare a vendored dependency in you target as following:</p>
<pre class="language-starlark"><a-k>load</a-k><a-p>(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;rust_binary&quot;</a-s><a-p>)</a-p>

<a-v>rust_binary</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_sys&quot;</a-s><a-p>,</a-p>
    <a-v>srcs</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;src/main.rs&quot;</a-s><a-p>],</a-p>
    <a-v>deps</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;//basic/3rdparty/crates:bzip2&quot;</a-s><a-p>],</a-p>
    <a-v>visibility</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;//visibility:public&quot;</a-s><a-p>],</a-p>
<a-p>)</a-p></pre>
<p>Note, the vendored dependency is not yet accessible because you have to define first
how to load the vendored dependencies. For that, you first create a file <code>sys_deps.bzl</code>
and add the following content:</p>
<pre class="language-starlark"><a-c># rename the default name &quot;crate_repositories&quot; in case you import multiple vendored folders.</a-c>
<a-k>load</a-k><a-p>(</a-p><a-s>&quot;//basic/3rdparty/crates:defs.bzl&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-v>basic_crate_repositories</a-v><a-k> </a-k><a-o>=</a-o><a-k> </a-k><a-s>&quot;crate_repositories&quot;</a-s><a-p>)</a-p>

<a-k>def</a-k> <a-v>sys_deps</a-v><a-p>():</a-p>
    <a-c># Load the vendored dependencies</a-c>
    <a-v>basic_crate_repositories</a-v><a-p>()</a-p></pre>
<p>This is straightforward, you import the generated crate_repositories from the crates folder,
rename it to avoid name clashes in case you import from multiple vendored folders, and then
just load the vendored dependencies.</p>
<p>In a WORKSPACE configuration, you would just load and call sys_deps(), but in a MODULE configuration, you cannot do that.
Instead, you create a new file <code>WORKSPACE.bzlmod</code> and add the following content.</p>
<pre class="language-starlark"><a-k>load</a-k><a-p>(</a-p><a-s>&quot;//:sys_deps.bzl&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;sys_deps&quot;</a-s><a-p>)</a-p>
<a-v>sys_deps</a-v><a-p>()</a-p></pre>
<p>Now, you can build the project as usual.</p>
<p>There are some more examples of using crate_universe with bzlmod in the <a href="https://github.com/bazelbuild/rules_rust/blob/main/examples/bzlmod/">example folder</a>.</p>
<p>&lt;a id="crate"&gt;&lt;/a&gt;</p>
<h2>crate</h2>
&lt;pre&gt;
crate = use_extension("@rules_rust//crate_universe:docs_bzlmod.bzl", "crate")
crate.annotation(&lt;a href="#crate.annotation-deps"&gt;deps&lt;/a&gt;, &lt;a href="#crate.annotation-data"&gt;data&lt;/a&gt;, &lt;a href="#crate.annotation-additive_build_file"&gt;additive_build_file&lt;/a&gt;, &lt;a href="#crate.annotation-additive_build_file_content"&gt;additive_build_file_content&lt;/a&gt;, &lt;a href="#crate.annotation-alias_rule"&gt;alias_rule&lt;/a&gt;,
                 &lt;a href="#crate.annotation-build_script_data"&gt;build_script_data&lt;/a&gt;, &lt;a href="#crate.annotation-build_script_data_glob"&gt;build_script_data_glob&lt;/a&gt;, &lt;a href="#crate.annotation-build_script_deps"&gt;build_script_deps&lt;/a&gt;, &lt;a href="#crate.annotation-build_script_env"&gt;build_script_env&lt;/a&gt;,
                 &lt;a href="#crate.annotation-build_script_proc_macro_deps"&gt;build_script_proc_macro_deps&lt;/a&gt;, &lt;a href="#crate.annotation-build_script_rundir"&gt;build_script_rundir&lt;/a&gt;, &lt;a href="#crate.annotation-build_script_rustc_env"&gt;build_script_rustc_env&lt;/a&gt;,
                 &lt;a href="#crate.annotation-build_script_toolchains"&gt;build_script_toolchains&lt;/a&gt;, &lt;a href="#crate.annotation-build_script_tools"&gt;build_script_tools&lt;/a&gt;, &lt;a href="#crate.annotation-compile_data"&gt;compile_data&lt;/a&gt;, &lt;a href="#crate.annotation-compile_data_glob"&gt;compile_data_glob&lt;/a&gt;, &lt;a href="#crate.annotation-crate"&gt;crate&lt;/a&gt;,
                 &lt;a href="#crate.annotation-crate_features"&gt;crate_features&lt;/a&gt;, &lt;a href="#crate.annotation-data_glob"&gt;data_glob&lt;/a&gt;, &lt;a href="#crate.annotation-disable_pipelining"&gt;disable_pipelining&lt;/a&gt;, &lt;a href="#crate.annotation-extra_aliased_targets"&gt;extra_aliased_targets&lt;/a&gt;,
                 &lt;a href="#crate.annotation-gen_all_binaries"&gt;gen_all_binaries&lt;/a&gt;, &lt;a href="#crate.annotation-gen_binaries"&gt;gen_binaries&lt;/a&gt;, &lt;a href="#crate.annotation-gen_build_script"&gt;gen_build_script&lt;/a&gt;, &lt;a href="#crate.annotation-override_target_bin"&gt;override_target_bin&lt;/a&gt;,
                 &lt;a href="#crate.annotation-override_target_build_script"&gt;override_target_build_script&lt;/a&gt;, &lt;a href="#crate.annotation-override_target_lib"&gt;override_target_lib&lt;/a&gt;, &lt;a href="#crate.annotation-override_target_proc_macro"&gt;override_target_proc_macro&lt;/a&gt;,
                 &lt;a href="#crate.annotation-patch_args"&gt;patch_args&lt;/a&gt;, &lt;a href="#crate.annotation-patch_tool"&gt;patch_tool&lt;/a&gt;, &lt;a href="#crate.annotation-patches"&gt;patches&lt;/a&gt;, &lt;a href="#crate.annotation-proc_macro_deps"&gt;proc_macro_deps&lt;/a&gt;, &lt;a href="#crate.annotation-repositories"&gt;repositories&lt;/a&gt;, &lt;a href="#crate.annotation-rustc_env"&gt;rustc_env&lt;/a&gt;,
                 &lt;a href="#crate.annotation-rustc_env_files"&gt;rustc_env_files&lt;/a&gt;, &lt;a href="#crate.annotation-rustc_flags"&gt;rustc_flags&lt;/a&gt;, &lt;a href="#crate.annotation-shallow_since"&gt;shallow_since&lt;/a&gt;, &lt;a href="#crate.annotation-version"&gt;version&lt;/a&gt;)
crate.from_cargo(&lt;a href="#crate.from_cargo-name"&gt;name&lt;/a&gt;, &lt;a href="#crate.from_cargo-cargo_config"&gt;cargo_config&lt;/a&gt;, &lt;a href="#crate.from_cargo-cargo_lockfile"&gt;cargo_lockfile&lt;/a&gt;, &lt;a href="#crate.from_cargo-generate_binaries"&gt;generate_binaries&lt;/a&gt;, &lt;a href="#crate.from_cargo-generate_build_scripts"&gt;generate_build_scripts&lt;/a&gt;,
                 &lt;a href="#crate.from_cargo-manifests"&gt;manifests&lt;/a&gt;, &lt;a href="#crate.from_cargo-splicing_config"&gt;splicing_config&lt;/a&gt;, &lt;a href="#crate.from_cargo-supported_platform_triples"&gt;supported_platform_triples&lt;/a&gt;)
crate.from_specs(&lt;a href="#crate.from_specs-name"&gt;name&lt;/a&gt;, &lt;a href="#crate.from_specs-cargo_config"&gt;cargo_config&lt;/a&gt;, &lt;a href="#crate.from_specs-generate_binaries"&gt;generate_binaries&lt;/a&gt;, &lt;a href="#crate.from_specs-generate_build_scripts"&gt;generate_build_scripts&lt;/a&gt;, &lt;a href="#crate.from_specs-splicing_config"&gt;splicing_config&lt;/a&gt;,
                 &lt;a href="#crate.from_specs-supported_platform_triples"&gt;supported_platform_triples&lt;/a&gt;)
crate.spec(&lt;a href="#crate.spec-artifact"&gt;artifact&lt;/a&gt;, &lt;a href="#crate.spec-branch"&gt;branch&lt;/a&gt;, &lt;a href="#crate.spec-default_features"&gt;default_features&lt;/a&gt;, &lt;a href="#crate.spec-features"&gt;features&lt;/a&gt;, &lt;a href="#crate.spec-git"&gt;git&lt;/a&gt;, &lt;a href="#crate.spec-lib"&gt;lib&lt;/a&gt;, &lt;a href="#crate.spec-package"&gt;package&lt;/a&gt;, &lt;a href="#crate.spec-rev"&gt;rev&lt;/a&gt;, &lt;a href="#crate.spec-tag"&gt;tag&lt;/a&gt;, &lt;a href="#crate.spec-version"&gt;version&lt;/a&gt;)
&lt;/pre&gt;
<p>Crate universe module extensions.</p>
<p><strong>TAG CLASSES</strong></p>
<p>&lt;a id="crate.annotation"&gt;&lt;/a&gt;</p>
<h3>annotation</h3>
<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="crate.annotation-deps"&gt;&lt;/a&gt;deps</td><td style="text-align: left">A list of labels to add to a crate's <code>rust_library::deps</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-data"&gt;&lt;/a&gt;data</td><td style="text-align: left">A list of labels to add to a crate's <code>rust_library::data</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-additive_build_file"&gt;&lt;/a&gt;additive_build_file</td><td style="text-align: left">A file containing extra contents to write to the bottom of generated BUILD files.</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>None</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-additive_build_file_content"&gt;&lt;/a&gt;additive_build_file_content</td><td style="text-align: left">Extra contents to write to the bottom of generated BUILD files.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-alias_rule"&gt;&lt;/a&gt;alias_rule</td><td style="text-align: left">Alias rule to use instead of <code>native.alias()</code>.  Overrides <a href="#render_config">render_config</a>'s 'default_alias_rule'.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-build_script_data"&gt;&lt;/a&gt;build_script_data</td><td style="text-align: left">A list of labels to add to a crate's <code>cargo_build_script::data</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-build_script_data_glob"&gt;&lt;/a&gt;build_script_data_glob</td><td style="text-align: left">A list of glob patterns to add to a crate's <code>cargo_build_script::data</code> attribute</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-build_script_deps"&gt;&lt;/a&gt;build_script_deps</td><td style="text-align: left">A list of labels to add to a crate's <code>cargo_build_script::deps</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-build_script_env"&gt;&lt;/a&gt;build_script_env</td><td style="text-align: left">Additional environment variables to set on a crate's <code>cargo_build_script::env</code> attribute.</td><td style="text-align: left">&lt;a href="https://bazel.build/rules/lib/dict"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>{}</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-build_script_proc_macro_deps"&gt;&lt;/a&gt;build_script_proc_macro_deps</td><td style="text-align: left">A list of labels to add to a crate's <code>cargo_build_script::proc_macro_deps</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-build_script_rundir"&gt;&lt;/a&gt;build_script_rundir</td><td style="text-align: left">An override for the build script's rundir attribute.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-build_script_rustc_env"&gt;&lt;/a&gt;build_script_rustc_env</td><td style="text-align: left">Additional environment variables to set on a crate's <code>cargo_build_script::env</code> attribute.</td><td style="text-align: left">&lt;a href="https://bazel.build/rules/lib/dict"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>{}</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-build_script_toolchains"&gt;&lt;/a&gt;build_script_toolchains</td><td style="text-align: left">A list of labels to set on a crates's <code>cargo_build_script::toolchains</code> attribute.</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-build_script_tools"&gt;&lt;/a&gt;build_script_tools</td><td style="text-align: left">A list of labels to add to a crate's <code>cargo_build_script::tools</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-compile_data"&gt;&lt;/a&gt;compile_data</td><td style="text-align: left">A list of labels to add to a crate's <code>rust_library::compile_data</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-compile_data_glob"&gt;&lt;/a&gt;compile_data_glob</td><td style="text-align: left">A list of glob patterns to add to a crate's <code>rust_library::compile_data</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-crate"&gt;&lt;/a&gt;crate</td><td style="text-align: left">The name of the crate the annotation is applied to</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-crate_features"&gt;&lt;/a&gt;crate_features</td><td style="text-align: left">A list of strings to add to a crate's <code>rust_library::crate_features</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-data_glob"&gt;&lt;/a&gt;data_glob</td><td style="text-align: left">A list of glob patterns to add to a crate's <code>rust_library::data</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-disable_pipelining"&gt;&lt;/a&gt;disable_pipelining</td><td style="text-align: left">If True, disables pipelining for library targets for this crate.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left"><code>False</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-extra_aliased_targets"&gt;&lt;/a&gt;extra_aliased_targets</td><td style="text-align: left">A list of targets to add to the generated aliases in the root crate_universe repository.</td><td style="text-align: left">&lt;a href="https://bazel.build/rules/lib/dict"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>{}</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-gen_all_binaries"&gt;&lt;/a&gt;gen_all_binaries</td><td style="text-align: left">If true, generates <code>rust_binary</code> targets for all of the crates bins</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left"><code>False</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-gen_binaries"&gt;&lt;/a&gt;gen_binaries</td><td style="text-align: left">As a list, the subset of the crate's bins that should get <code>rust_binary</code> targets produced.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-gen_build_script"&gt;&lt;/a&gt;gen_build_script</td><td style="text-align: left">An authorative flag to determine whether or not to produce <code>cargo_build_script</code> targets for the current crate. Supported values are 'on', 'off', and 'auto'.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>"auto"</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-override_target_bin"&gt;&lt;/a&gt;override_target_bin</td><td style="text-align: left">An optional alternate taget to use when something depends on this crate to allow the parent repo to provide its own version of this dependency.</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>None</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-override_target_build_script"&gt;&lt;/a&gt;override_target_build_script</td><td style="text-align: left">An optional alternate taget to use when something depends on this crate to allow the parent repo to provide its own version of this dependency.</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>None</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-override_target_lib"&gt;&lt;/a&gt;override_target_lib</td><td style="text-align: left">An optional alternate taget to use when something depends on this crate to allow the parent repo to provide its own version of this dependency.</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>None</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-override_target_proc_macro"&gt;&lt;/a&gt;override_target_proc_macro</td><td style="text-align: left">An optional alternate taget to use when something depends on this crate to allow the parent repo to provide its own version of this dependency.</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>None</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-patch_args"&gt;&lt;/a&gt;patch_args</td><td style="text-align: left">The <code>patch_args</code> attribute of a Bazel repository rule. See <a href="https://docs.bazel.build/versions/main/repo/http.html#http_archive-patch_args">http_archive.patch_args</a></td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-patch_tool"&gt;&lt;/a&gt;patch_tool</td><td style="text-align: left">The <code>patch_tool</code> attribute of a Bazel repository rule. See <a href="https://docs.bazel.build/versions/main/repo/http.html#http_archive-patch_tool">http_archive.patch_tool</a></td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-patches"&gt;&lt;/a&gt;patches</td><td style="text-align: left">The <code>patches</code> attribute of a Bazel repository rule. See <a href="https://docs.bazel.build/versions/main/repo/http.html#http_archive-patches">http_archive.patches</a></td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-proc_macro_deps"&gt;&lt;/a&gt;proc_macro_deps</td><td style="text-align: left">A list of labels to add to a crate's <code>rust_library::proc_macro_deps</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-repositories"&gt;&lt;/a&gt;repositories</td><td style="text-align: left">A list of repository names specified from <code>crate.from_cargo(name=...)</code> that this annotation is applied to. Defaults to all repositories.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-rustc_env"&gt;&lt;/a&gt;rustc_env</td><td style="text-align: left">Additional variables to set on a crate's <code>rust_library::rustc_env</code> attribute.</td><td style="text-align: left">&lt;a href="https://bazel.build/rules/lib/dict"&gt;Dictionary: String -&gt; String&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>{}</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-rustc_env_files"&gt;&lt;/a&gt;rustc_env_files</td><td style="text-align: left">A list of labels to set on a crate's <code>rust_library::rustc_env_files</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-rustc_flags"&gt;&lt;/a&gt;rustc_flags</td><td style="text-align: left">A list of strings to set on a crate's <code>rust_library::rustc_flags</code> attribute.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-shallow_since"&gt;&lt;/a&gt;shallow_since</td><td style="text-align: left">An optional timestamp used for crates originating from a git repository instead of a crate registry. This flag optimizes fetching the source code.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.annotation-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">The versions of the crate the annotation is applied to. Defaults to all versions.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>"*"</code></td></tr>
</tbody></table>
<p>&lt;a id="crate.from_cargo"&gt;&lt;/a&gt;</p>
<h3>from_cargo</h3>
<p>Generates a repo @crates from a Cargo.toml / Cargo.lock pair.</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="crate.from_cargo-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">The name of the repo to generate</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels#target-names"&gt;Name&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>"crates"</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_cargo-cargo_config"&gt;&lt;/a&gt;cargo_config</td><td style="text-align: left">A <a href="https://doc.rust-lang.org/cargo/reference/config.html">Cargo configuration</a> file.</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>None</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_cargo-cargo_lockfile"&gt;&lt;/a&gt;cargo_lockfile</td><td style="text-align: left">The path to an existing <code>Cargo.lock</code> file</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>None</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_cargo-generate_binaries"&gt;&lt;/a&gt;generate_binaries</td><td style="text-align: left">Whether to generate <code>rust_binary</code> targets for all the binary crates in every package. By default only the <code>rust_library</code> targets are generated.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left"><code>False</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_cargo-generate_build_scripts"&gt;&lt;/a&gt;generate_build_scripts</td><td style="text-align: left">Whether or not to generate <a href="https://doc.rust-lang.org/cargo/reference/build-scripts.html">cargo build scripts</a> by default.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left"><code>True</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_cargo-manifests"&gt;&lt;/a&gt;manifests</td><td style="text-align: left">A list of Cargo manifests (<code>Cargo.toml</code> files).</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;List of labels&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_cargo-splicing_config"&gt;&lt;/a&gt;splicing_config</td><td style="text-align: left">The configuration flags to use for splicing Cargo maniests. Use <code>//crate_universe:defs.bzl\%rsplicing_config</code> to generate the value for this field. If unset, the defaults defined there will be used.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_cargo-supported_platform_triples"&gt;&lt;/a&gt;supported_platform_triples</td><td style="text-align: left">A set of all platform triples to consider when generating dependencies.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>["aarch64-apple-darwin", "aarch64-apple-ios", "aarch64-apple-ios-sim", "aarch64-linux-android", "aarch64-pc-windows-msvc", "aarch64-unknown-fuchsia", "aarch64-unknown-linux-gnu", "aarch64-unknown-nixos-gnu", "aarch64-unknown-nto-qnx710", "arm-unknown-linux-gnueabi", "armv7-linux-androideabi", "armv7-unknown-linux-gnueabi", "i686-apple-darwin", "i686-linux-android", "i686-pc-windows-msvc", "i686-unknown-freebsd", "i686-unknown-linux-gnu", "powerpc-unknown-linux-gnu", "riscv32imc-unknown-none-elf", "riscv64gc-unknown-none-elf", "s390x-unknown-linux-gnu", "thumbv7em-none-eabi", "thumbv8m.main-none-eabi", "wasm32-unknown-unknown", "wasm32-wasip1", "x86_64-apple-darwin", "x86_64-apple-ios", "x86_64-linux-android", "x86_64-pc-windows-msvc", "x86_64-unknown-freebsd", "x86_64-unknown-fuchsia", "x86_64-unknown-linux-gnu", "x86_64-unknown-nixos-gnu", "x86_64-unknown-none"]</code></td></tr>
</tbody></table>
<p>&lt;a id="crate.from_specs"&gt;&lt;/a&gt;</p>
<h3>from_specs</h3>
<p>Generates a repo @crates from the defined <code>spec</code> tags.</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="crate.from_specs-name"&gt;&lt;/a&gt;name</td><td style="text-align: left">The name of the repo to generate.</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels#target-names"&gt;Name&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>"crates"</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_specs-cargo_config"&gt;&lt;/a&gt;cargo_config</td><td style="text-align: left">A <a href="https://doc.rust-lang.org/cargo/reference/config.html">Cargo configuration</a> file.</td><td style="text-align: left">&lt;a href="https://bazel.build/concepts/labels"&gt;Label&lt;/a&gt;</td><td style="text-align: left">optional</td><td style="text-align: left"><code>None</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_specs-generate_binaries"&gt;&lt;/a&gt;generate_binaries</td><td style="text-align: left">Whether to generate <code>rust_binary</code> targets for all the binary crates in every package. By default only the <code>rust_library</code> targets are generated.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left"><code>False</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_specs-generate_build_scripts"&gt;&lt;/a&gt;generate_build_scripts</td><td style="text-align: left">Whether or not to generate <a href="https://doc.rust-lang.org/cargo/reference/build-scripts.html">cargo build scripts</a> by default.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left"><code>True</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_specs-splicing_config"&gt;&lt;/a&gt;splicing_config</td><td style="text-align: left">The configuration flags to use for splicing Cargo maniests. Use <code>//crate_universe:defs.bzl\%rsplicing_config</code> to generate the value for this field. If unset, the defaults defined there will be used.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.from_specs-supported_platform_triples"&gt;&lt;/a&gt;supported_platform_triples</td><td style="text-align: left">A set of all platform triples to consider when generating dependencies.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>["aarch64-apple-darwin", "aarch64-apple-ios", "aarch64-apple-ios-sim", "aarch64-linux-android", "aarch64-pc-windows-msvc", "aarch64-unknown-fuchsia", "aarch64-unknown-linux-gnu", "aarch64-unknown-nixos-gnu", "aarch64-unknown-nto-qnx710", "arm-unknown-linux-gnueabi", "armv7-linux-androideabi", "armv7-unknown-linux-gnueabi", "i686-apple-darwin", "i686-linux-android", "i686-pc-windows-msvc", "i686-unknown-freebsd", "i686-unknown-linux-gnu", "powerpc-unknown-linux-gnu", "riscv32imc-unknown-none-elf", "riscv64gc-unknown-none-elf", "s390x-unknown-linux-gnu", "thumbv7em-none-eabi", "thumbv8m.main-none-eabi", "wasm32-unknown-unknown", "wasm32-wasip1", "x86_64-apple-darwin", "x86_64-apple-ios", "x86_64-linux-android", "x86_64-pc-windows-msvc", "x86_64-unknown-freebsd", "x86_64-unknown-fuchsia", "x86_64-unknown-linux-gnu", "x86_64-unknown-nixos-gnu", "x86_64-unknown-none"]</code></td></tr>
</tbody></table>
<p>&lt;a id="crate.spec"&gt;&lt;/a&gt;</p>
<h3>spec</h3>
<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="crate.spec-artifact"&gt;&lt;/a&gt;artifact</td><td style="text-align: left">Set to 'bin' to pull in a binary crate as an artifact dependency. Requires a nightly Cargo.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.spec-branch"&gt;&lt;/a&gt;branch</td><td style="text-align: left">The git branch of the remote crate. Tied with the <code>git</code> param. Only one of branch, tag or rev may be specified. Specifying <code>rev</code> is recommended for fully-reproducible builds.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.spec-default_features"&gt;&lt;/a&gt;default_features</td><td style="text-align: left">Maps to the <code>default-features</code> flag.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left"><code>True</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.spec-features"&gt;&lt;/a&gt;features</td><td style="text-align: left">A list of features to use for the crate.</td><td style="text-align: left">List of strings</td><td style="text-align: left">optional</td><td style="text-align: left"><code>[]</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.spec-git"&gt;&lt;/a&gt;git</td><td style="text-align: left">The Git url to use for the crate. Cannot be used with <code>version</code>.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.spec-lib"&gt;&lt;/a&gt;lib</td><td style="text-align: left">If using <code>artifact = 'bin'</code>, additionally setting <code>lib = True</code> declares a dependency on both the package's library and binary, as opposed to just the binary.</td><td style="text-align: left">Boolean</td><td style="text-align: left">optional</td><td style="text-align: left"><code>False</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.spec-package"&gt;&lt;/a&gt;package</td><td style="text-align: left">The explicit name of the package.</td><td style="text-align: left">String</td><td style="text-align: left">required</td><td style="text-align: left"></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.spec-rev"&gt;&lt;/a&gt;rev</td><td style="text-align: left">The git revision of the remote crate. Tied with the <code>git</code> param. Only one of branch, tag or rev may be specified.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.spec-tag"&gt;&lt;/a&gt;tag</td><td style="text-align: left">The git tag of the remote crate. Tied with the <code>git</code> param. Only one of branch, tag or rev may be specified. Specifying <code>rev</code> is recommended for fully-reproducible builds.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></td></tr>
<tr><td style="text-align: left">&lt;a id="crate.spec-version"&gt;&lt;/a&gt;version</td><td style="text-align: left">The exact version of the crate. Cannot be used with <code>git</code>.</td><td style="text-align: left">String</td><td style="text-align: left">optional</td><td style="text-align: left"><code>""</code></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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"><a-p>#</a-p> <a-tt>Crate Universe</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">Crate Universe is a set of Bazel rule for generating Rust targets using Cargo.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text">This doc describes using crate_universe with bzlmod.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text">If you&#39;re using a WORKSPACE file, please see [the WORKSPACE equivalent of this doc](crate_universe.html).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text">There are some examples of using crate_universe with bzlmod in the [example folder](../examples/bzlmod).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"></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> <a-tt>Table of Contents</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>1. </a-p>[Setup](#Setup)</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>2. </a-p>[Dependencies](#dependencies)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>    * </a-p>[Cargo Workspace](#cargo-workspaces)</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>[Direct Packages](#direct-dependencies)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>    * </a-p>[Vendored Dependencies](#vendored-dependencies)</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>3. </a-p>[Crate reference](#crate)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>   * </a-p>[from_cargo](#from_cargo)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>   * </a-p>[from_specs](#from_specs)</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>## </a-p><a-tt>Setup</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-p>To use rules_rust in a project using bzlmod, add the following to your MODULE.bazel file:</a-p></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>```</a-p><a-tl>starlark</a-tl></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>bazel_dep(</a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;rules_rust&quot;</a-s><a-p>, </a-p><a-v>version</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;0.49.3&quot;</a-s><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>```</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"><a-p>You find the latest version on the [release page](https://github.com/bazelbuild/rules_rust/releases).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"></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>After adding `rules_rust` in your MODULE.bazel, set the following to begin using `crate_universe`:</a-p></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>```</a-p><a-tl>starlark</a-tl></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>crate </a-p><a-o>=</a-o><a-p> </a-p><a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//crate_universe:extensions.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;crate&quot;</a-s><a-p>)</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>//  # ... </a-p><a-v>Dependencies</a-v></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>use_repo(</a-p><a-v>crate</a-v><a-p>, </a-p><a-s>&quot;crates&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>```</a-p></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>## </a-p><a-tt>Dependencies</a-tt></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"><a-p>There are three different ways to declare dependencies in your MODULE.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"></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>1) Cargo workspace</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>2) Direct Dependencies</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"><a-p>3) Vendored Dependencies</a-p></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>### </a-p><a-tt>Cargo Workspaces</a-tt></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>One of the simpler ways to wire up dependencies would be to first structure your project into a Cargo workspace.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>The crates_repository rule can ingest a root Cargo.toml file and generate Bazel dependencies from there.</a-p></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>You find a complete example in the in the [example folder](../examples/bzlmod/all_crate_deps).</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"></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>```</a-p><a-tl>starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>crate </a-p><a-o>=</a-o><a-p> </a-p><a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//crate_universe:extensions.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;crate&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>crate.</a-p><a-v>from_cargo</a-v><a-p>(</a-p></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>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;crates&quot;</a-s><a-p>,</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"><a-p>    </a-p><a-v>cargo_lockfile</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;//:Cargo.lock&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>    </a-p><a-v>manifests</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;//:Cargo.toml&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>)</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>use_repo(</a-p><a-v>crate</a-v><a-p>, </a-p><a-s>&quot;crates&quot;</a-s><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>```</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"><a-p>The generated crates_repository contains helper macros which make collecting dependencies for Bazel targets simpler.</a-p></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>Notably, the all_crate_deps and aliases macros (</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"><a-p>see [Dependencies API](https://bazelbuild.github.io/rules_rust/crate_universe.html#dependencies-api)) commonly allow the</a-p></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>Cargo.toml files to be the single source of truth for dependencies.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"><a-p>Since these macros come from the generated repository, the dependencies and alias definitions</a-p></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>they return will automatically update BUILD targets. In your BUILD files,</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>you use these macros for a Rust library as shown below:</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"><a-p>```</a-p><a-tl>starlark</a-tl></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>load(</a-p><a-s>&quot;@crate_index//:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;aliases&quot;</a-s><a-p>, </a-p><a-s>&quot;all_crate_deps&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"><a-p>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="L80" href="#L80">80</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"><a-p>rust_library(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;lib&quot;</a-s><a-p>,</a-p></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>    </a-p><a-v>aliases</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-v>aliases</a-v><a-p>(),</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><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-v>all_crate_deps</a-v><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>        </a-p><a-v>normal</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>True</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>    ),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"><a-p>    </a-p><a-v>proc_macro_deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-v>all_crate_deps</a-v><a-p>(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"><a-p>        </a-p><a-v>proc_macro</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>True</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"><a-p>    ),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"></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>rust_test(</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>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;unit_test&quot;</a-s><a-p>,</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>    </a-p><a-v>crate</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;:lib&quot;</a-s><a-p>,</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>    </a-p><a-v>aliases</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-v>aliases</a-v><a-p>(</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>        </a-p><a-v>normal_dev</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>True</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"><a-p>        </a-p><a-v>proc_macro_dev</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>True</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"><a-p>    ),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"><a-p>    </a-p><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-v>all_crate_deps</a-v><a-p>(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"><a-p>        </a-p><a-v>normal_dev</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>True</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"><a-p>    ),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"><a-p>    </a-p><a-v>proc_macro_deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-v>all_crate_deps</a-v><a-p>(</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>        </a-p><a-v>proc_macro_dev</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>True</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"><a-p>    ),</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"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"></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>For a Rust binary that does not depend on any macro, use the following configuration</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>in your build file:</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"></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>```</a-p><a-tl>starlark</a-tl></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>rust_binary(</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>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;bin&quot;</a-s><a-p>,</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>    </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="L115" href="#L115">115</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-v>all_crate_deps</a-v><a-p>(</a-p><a-v>normal</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>True</a-co><a-p>),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text"><a-p>)</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>You have to repin before your first build to ensure all Bazel targets for the macros</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>are generated.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text"><a-p>Dependency syncing and updating is done in the repository rule which means it&#39;s done during the</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>analysis phase of builds. As mentioned in the environments variable table above, the `CARGO_BAZEL_REPIN`</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"><a-p>(or `REPIN`) environment variables can be used to force the rule to update dependencies and potentially</a-p></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>render a new lockfile. Given an instance of this repository rule named `crates`, the easiest way to</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>repin dependencies is to run:</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"></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><a-tl>shell</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text"><a-p>CARGO_BAZEL_REPIN=1 bazel sync --only=crates</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text"><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"></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>This will result in all dependencies being updated for a project. The `CARGO_BAZEL_REPIN`</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>environment variable can also be used to customize how dependencies are updated.</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>For more details about repin, [please refer to the documentation](https://bazelbuild.github.io/rules_rust/crate_universe.html#crates_vendor).</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>### </a-p><a-tt>Direct Dependencies</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L137" href="#L137">137</a><span class="code-text"></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>In cases where Rust targets have heavy interactions with other Bazel targets ([Cc](https://docs.bazel.build/versions/main/be/c-cpp.html), [Proto](https://rules-proto-grpc.com/en/4.5.0/lang/rust.html),</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"><a-p>etc.), maintaining Cargo.toml files may have diminishing returns as things like rust-analyzer</a-p></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>begin to be confused about missing targets or environment variables defined only in Bazel.</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"><a-p>In situations like this, it may be desirable to have a âCargo freeâ setup. You find an example in the in the [example folder](../examples/bzlmod/hello_world_no_cargo).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text"><a-p>crates_repository supports this through the packages attribute,</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>as shown below.</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"></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><a-tl>starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text"><a-p>crate </a-p><a-o>=</a-o><a-p> </a-p><a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//crate_universe:extensions.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;crate&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L148" href="#L148">148</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L149" href="#L149">149</a><span class="code-text"><a-p>crate.</a-p><a-v>spec</a-v><a-p>(</a-p><a-v>package</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;serde&quot;</a-s><a-p>, </a-p><a-v>features</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;derive&quot;</a-s><a-p>], </a-p><a-v>version</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;1.0&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L150" href="#L150">150</a><span class="code-text"><a-p>crate.</a-p><a-v>spec</a-v><a-p>(</a-p><a-v>package</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;serde_json&quot;</a-s><a-p>, </a-p><a-v>version</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;1.0&quot;</a-s><a-p>)</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"><a-p>crate.</a-p><a-v>spec</a-v><a-p>(</a-p><a-v>package</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;tokio&quot;</a-s><a-p>, </a-p><a-v>default_features</a-v><a-o>=</a-o><a-co>False</a-co><a-p>, </a-p><a-v>features</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;macros&quot;</a-s><a-p>, </a-p><a-s>&quot;net&quot;</a-s><a-p>, </a-p><a-s>&quot;rt-multi-thread&quot;</a-s><a-p>], </a-p><a-v>version</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;1.38&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L152" href="#L152">152</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L153" href="#L153">153</a><span class="code-text"><a-p>crate.</a-p><a-v>from_specs</a-v><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>use_repo(</a-p><a-v>crate</a-v><a-p>, </a-p><a-s>&quot;crates&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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L157" href="#L157">157</a><span class="code-text"><a-p>Consuming dependencies may be more ergonomic in this case through the aliases defined in the new repository.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L158" href="#L158">158</a><span class="code-text"><a-p>In your BUILD files, you use direct dependencies as shown below:</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"></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>```</a-p><a-tl>starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L161" href="#L161">161</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="L162" href="#L162">162</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;bin&quot;</a-s><a-p>,</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>crate_root</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="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-v>glob</a-v><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-s>&quot;src/*.rs&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><a-v>deps</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L168" href="#L168">168</a><span class="code-text"><a-p>        </a-p><a-c># External crates</a-c></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>        </a-p><a-s>&quot;@crates//:serde&quot;</a-s><a-p>,</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><a-s>&quot;@crates//:serde_json&quot;</a-s><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>        </a-p><a-s>&quot;@crates//:tokio&quot;</a-s><a-p>,</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>    ],</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>    </a-p><a-v>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="L174" href="#L174">174</a><span class="code-text"><a-p>)</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>```</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>Notice, direct dependencies do not need repining.</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>Only a cargo workspace needs updating whenever the underlying Cargo.toml file changed.</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L180" href="#L180">180</a><span class="code-text"><a-p>### </a-p><a-tt>Vendored Dependencies</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L181" href="#L181">181</a><span class="code-text"></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>In some cases, it is require that all external dependencies are vendored, meaning downloaded</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>and stored in the workspace. This helps, for example, to conduct licence scans, apply custom patches,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L184" href="#L184">184</a><span class="code-text"><a-p>or to ensure full build reproducibility since no download error could possibly occur.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L185" href="#L185">185</a><span class="code-text"><a-p>You find a complete example in the in the [example folder](../examples/bzlmod/all_deps_vendor).</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"><a-p>For the setup, you need to add the skylib in addition to the rust rules to your MODUE.bazel.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L188" href="#L188">188</a><span class="code-text"></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><a-tl>starlark</a-tl></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>module(</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>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;deps_vendored&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L192" href="#L192">192</a><span class="code-text"><a-p>    </a-p><a-v>version</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;0.0.0&quot;</a-s></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>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L194" href="#L194">194</a><span class="code-text"><a-p>###############################################################################</a-p></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># B A Z E L  C E N T R A L  R E G I S T R Y # https://registry.bazel.build/</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>###############################################################################</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># https://github.com/bazelbuild/bazel-skylib/releases/</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>bazel_dep(</a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;bazel_skylib&quot;</a-s><a-p>, </a-p><a-v>version</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;1.7.1&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L199" href="#L199">199</a><span class="code-text"></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># https://github.com/bazelbuild/rules_rust/releases</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>bazel_dep(</a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;rules_rust&quot;</a-s><a-p>, </a-p><a-v>version</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;0.49.3&quot;</a-s><a-p>)</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L203" href="#L203">203</a><span class="code-text"><a-p>###############################################################################</a-p></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># T O O L C H A I N S</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L205" href="#L205">205</a><span class="code-text"><a-p>###############################################################################</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L206" href="#L206">206</a><span class="code-text"></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># Rust toolchain</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>RUST_EDITION </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;2021&quot;</a-s></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L209" href="#L209">209</a><span class="code-text"><a-p>RUST_VERSION </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;1.80.1&quot;</a-s></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>rust </a-p><a-o>=</a-o><a-p> </a-p><a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//rust:extensions.bzl&quot;</a-s><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="L212" href="#L212">212</a><span class="code-text"><a-p>rust.</a-p><a-v>toolchain</a-v><a-p>(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L213" href="#L213">213</a><span class="code-text"><a-p>    </a-p><a-v>edition</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-v>RUST_EDITION</a-v><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L214" href="#L214">214</a><span class="code-text"><a-p>    </a-p><a-v>versions</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-v>RUST_VERSION</a-v><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L215" href="#L215">215</a><span class="code-text"><a-p>)</a-p></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>use_repo(</a-p><a-v>rust</a-v><a-p>, </a-p><a-s>&quot;rust_toolchains&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L217" href="#L217">217</a><span class="code-text"><a-p>register_toolchains(</a-p><a-s>&quot;@rust_toolchains//:all&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L218" href="#L218">218</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L219" href="#L219">219</a><span class="code-text"><a-p>###############################################################################</a-p></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># R U S T  C R A T E S</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L221" href="#L221">221</a><span class="code-text"><a-p>###############################################################################</a-p></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>crate </a-p><a-o>=</a-o><a-p> </a-p><a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//crate_universe:extensions.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;crate&quot;</a-s><a-p>)</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"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L224" href="#L224">224</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L225" href="#L225">225</a><span class="code-text"><a-p>Note, it is important to load the crate_universe rules otherwise you will get an error</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L226" href="#L226">226</a><span class="code-text"><a-p>as the rule set is needed in the vendored target.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L227" href="#L227">227</a><span class="code-text"></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>Assuming you have a package called `basic` in which you want to vendor dependencies,</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>then you create a folder `basic/3rdparty`. The folder name can be arbitrary,</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>but by convention, its either thirdparty or 3rdparty to indicate vendored dependencies.</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>In the 3rdparty folder, you add a target crates_vendor to declare your dependencies to vendor.</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>In the example, we vendor a specific version of bzip2.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L233" href="#L233">233</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L234" href="#L234">234</a><span class="code-text"><a-p>```</a-p><a-tl>starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L235" href="#L235">235</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;@rules_rust//crate_universe:defs.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;crate&quot;</a-s><a-p>, </a-p><a-s>&quot;crates_vendor&quot;</a-s><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L236" href="#L236">236</a><span class="code-text"></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>crates_vendor(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L238" href="#L238">238</a><span class="code-text"><a-p>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;crates_vendor&quot;</a-s><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-v>annotations</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="L240" href="#L240">240</a><span class="code-text"><a-p>        </a-p><a-s>&quot;bzip2-sys&quot;</a-s><a-p>: [</a-p><a-v>crate</a-v><a-p>.</a-p><a-v>annotation</a-v><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"><a-p>            </a-p><a-v>gen_build_script</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>True</a-co><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L242" href="#L242">242</a><span class="code-text"><a-p>        )],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L243" href="#L243">243</a><span class="code-text"><a-p>    },</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-v>cargo_lockfile</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;Cargo.Bazel.lock&quot;</a-s><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><a-v>generate_build_scripts</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-co>False</a-co><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"><a-p>    </a-p><a-v>mode</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;remote&quot;</a-s><a-p>,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L247" href="#L247">247</a><span class="code-text"><a-p>    </a-p><a-v>packages</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="L248" href="#L248">248</a><span class="code-text"><a-p>        </a-p><a-s>&quot;bzip2&quot;</a-s><a-p>: </a-p><a-v>crate</a-v><a-p>.</a-p><a-v>spec</a-v><a-p>(</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><a-v>version</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;=0.3.3&quot;</a-s><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"><a-p>    </a-p><a-v>repository_name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;basic&quot;</a-s><a-p>,</a-p></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>    </a-p><a-v>tags</a-v><a-p> </a-p><a-o>=</a-o><a-p> [</a-p><a-s>&quot;manual&quot;</a-s><a-p>],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L254" href="#L254">254</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L255" href="#L255">255</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L256" href="#L256">256</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L257" href="#L257">257</a><span class="code-text"><a-p>Next, you have to run `Cargo build` to generate a Cargo.lock file with all resolved dependencies.</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"><a-p>Then, you rename Cargo.lock to Cargo.Bazel.lock and place it inside the `basic/3rdparty` folder.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L259" href="#L259">259</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L260" href="#L260">260</a><span class="code-text"><a-p>At this point, you have the following folder and files:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L261" href="#L261">261</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L262" href="#L262">262</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L263" href="#L263">263</a><span class="code-text"><a-p>basic</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L264" href="#L264">264</a><span class="code-text"><a-p>    âââ 3rdparty</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L265" href="#L265">265</a><span class="code-text"><a-p>    â   âââ BUILD.bazel</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>    â   âââ Cargo.Bazel.lock</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></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L268" href="#L268">268</a><span class="code-text"></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>Now you can run the `crates_vendor` target:</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"></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>`bazel run //basic/3rdparty:crates_vendor`</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L273" href="#L273">273</a><span class="code-text"><a-p>This generates a crate folders with all configurations for the vendored dependencies.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L274" href="#L274">274</a><span class="code-text"></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></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>basic</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>    âââ 3rdparty</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>    â   âââ cratea</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>    â   âââ BUILD.bazel</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>    â   âââ Cargo.Bazel.lock</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"><a-p>Suppose you have an application in `basic/src` that is defined in `basic/BUILD.bazel` and</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L284" href="#L284">284</a><span class="code-text"><a-p>that depends on a vendored dependency. You find a list of all available vendored dependencies</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"><a-p>in the BUILD file of the generated folder: `basic/3rdparty/crates/BUILD.bazel`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L286" href="#L286">286</a><span class="code-text"><a-p>You declare a vendored dependency in you target as following:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L287" href="#L287">287</a><span class="code-text"></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><a-tl>starlark</a-tl></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>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="L290" href="#L290">290</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L291" href="#L291">291</a><span class="code-text"><a-p>rust_binary(</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>    </a-p><a-v>name</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;hello_sys&quot;</a-s><a-p>,</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>    </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="L294" href="#L294">294</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;//basic/3rdparty/crates:bzip2&quot;</a-s><a-p>],</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>    </a-p><a-v>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="L296" href="#L296">296</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L297" href="#L297">297</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L298" href="#L298">298</a><span class="code-text"><a-p>Note, the vendored dependency is not yet accessible because you have to define first</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>how to load the vendored dependencies. For that, you first create a file `sys_deps.bzl`</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>and add the following content:</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"></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>```</a-p><a-tl>starlark</a-tl></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># rename the default name &quot;crate_repositories&quot; in case you import multiple vendored folders.</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>load(</a-p><a-s>&quot;//basic/3rdparty/crates:defs.bzl&quot;</a-s><a-p>, </a-p><a-v>basic_crate_repositories</a-v><a-p> </a-p><a-o>=</a-o><a-p> </a-p><a-s>&quot;crate_repositories&quot;</a-s><a-p>)</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"><a-p>def </a-p><a-v>sys_deps</a-v><a-p>():</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L307" href="#L307">307</a><span class="code-text"><a-p>    </a-p><a-c># Load the vendored dependencies</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L308" href="#L308">308</a><span class="code-text"><a-p>    </a-p><a-v>basic_crate_repositories</a-v><a-p>()</a-p></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></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>This is straightforward, you import the generated crate_repositories from the crates folder,</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>rename it to avoid name clashes in case you import from multiple vendored folders, and then</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>just load the vendored dependencies.</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"></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>In a WORKSPACE configuration, you would just load and call sys_deps(), but in a MODULE configuration, you cannot do that.</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"><a-p>Instead, you create a new file `WORKSPACE.bzlmod` and add the following content.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L317" href="#L317">317</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L318" href="#L318">318</a><span class="code-text"><a-p>```</a-p><a-tl>starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L319" href="#L319">319</a><span class="code-text"><a-p>load(</a-p><a-s>&quot;//:sys_deps.bzl&quot;</a-s><a-p>, </a-p><a-s>&quot;sys_deps&quot;</a-s><a-p>)</a-p></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>sys_deps()</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"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L322" href="#L322">322</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L323" href="#L323">323</a><span class="code-text"><a-p>Now, you can build the project as usual.</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"></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>There are some more examples of using crate_universe with bzlmod in the [example folder](https://github.com/bazelbuild/rules_rust/blob/main/examples/bzlmod/).</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"></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;crate&quot;&gt;&lt;/a&gt;</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L329" href="#L329">329</a><span class="code-text"><a-p>## </a-p><a-tt>crate</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L330" href="#L330">330</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L331" href="#L331">331</a><span class="code-text"><a-p>&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="L332" href="#L332">332</a><span class="code-text"><a-p>crate = use_extension(&quot;@rules_rust//crate_universe:docs_bzlmod.bzl&quot;, &quot;crate&quot;)</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>crate.annotation(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-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>#crate.annotation-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>#crate.annotation-additive_build_file</a-s><a-p>&quot;&gt;additive_build_file&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-additive_build_file_content</a-s><a-p>&quot;&gt;additive_build_file_content&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-alias_rule</a-s><a-p>&quot;&gt;alias_rule&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="L334" href="#L334">334</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>#crate.annotation-build_script_data</a-s><a-p>&quot;&gt;build_script_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>#crate.annotation-build_script_data_glob</a-s><a-p>&quot;&gt;build_script_data_glob&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-build_script_deps</a-s><a-p>&quot;&gt;build_script_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>#crate.annotation-build_script_env</a-s><a-p>&quot;&gt;build_script_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L335" href="#L335">335</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>#crate.annotation-build_script_proc_macro_deps</a-s><a-p>&quot;&gt;build_script_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>#crate.annotation-build_script_rundir</a-s><a-p>&quot;&gt;build_script_rundir&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-build_script_rustc_env</a-s><a-p>&quot;&gt;build_script_rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L336" href="#L336">336</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>#crate.annotation-build_script_toolchains</a-s><a-p>&quot;&gt;build_script_toolchains&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-build_script_tools</a-s><a-p>&quot;&gt;build_script_tools&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-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>#crate.annotation-compile_data_glob</a-s><a-p>&quot;&gt;compile_data_glob&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-crate</a-s><a-p>&quot;&gt;crate&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="L337" href="#L337">337</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>#crate.annotation-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>#crate.annotation-data_glob</a-s><a-p>&quot;&gt;data_glob&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-disable_pipelining</a-s><a-p>&quot;&gt;disable_pipelining&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-extra_aliased_targets</a-s><a-p>&quot;&gt;extra_aliased_targets&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L338" href="#L338">338</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>#crate.annotation-gen_all_binaries</a-s><a-p>&quot;&gt;gen_all_binaries&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-gen_binaries</a-s><a-p>&quot;&gt;gen_binaries&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-gen_build_script</a-s><a-p>&quot;&gt;gen_build_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>#crate.annotation-override_target_bin</a-s><a-p>&quot;&gt;override_target_bin&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="L339" href="#L339">339</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>#crate.annotation-override_target_build_script</a-s><a-p>&quot;&gt;override_target_build_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>#crate.annotation-override_target_lib</a-s><a-p>&quot;&gt;override_target_lib&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-override_target_proc_macro</a-s><a-p>&quot;&gt;override_target_proc_macro&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="L340" href="#L340">340</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>#crate.annotation-patch_args</a-s><a-p>&quot;&gt;patch_args&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-patch_tool</a-s><a-p>&quot;&gt;patch_tool&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-patches</a-s><a-p>&quot;&gt;patches&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-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>#crate.annotation-repositories</a-s><a-p>&quot;&gt;repositories&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-rustc_env</a-s><a-p>&quot;&gt;rustc_env&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L341" href="#L341">341</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>#crate.annotation-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>#crate.annotation-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>#crate.annotation-shallow_since</a-s><a-p>&quot;&gt;shallow_since&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.annotation-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="L342" href="#L342">342</a><span class="code-text"><a-p>crate.from_cargo(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_cargo-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>#crate.from_cargo-cargo_config</a-s><a-p>&quot;&gt;cargo_config&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_cargo-cargo_lockfile</a-s><a-p>&quot;&gt;cargo_lockfile&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_cargo-generate_binaries</a-s><a-p>&quot;&gt;generate_binaries&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_cargo-generate_build_scripts</a-s><a-p>&quot;&gt;generate_build_scripts&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="L343" href="#L343">343</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>#crate.from_cargo-manifests</a-s><a-p>&quot;&gt;manifests&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_cargo-splicing_config</a-s><a-p>&quot;&gt;splicing_config&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_cargo-supported_platform_triples</a-s><a-p>&quot;&gt;supported_platform_triples&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L344" href="#L344">344</a><span class="code-text"><a-p>crate.from_specs(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_specs-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>#crate.from_specs-cargo_config</a-s><a-p>&quot;&gt;cargo_config&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_specs-generate_binaries</a-s><a-p>&quot;&gt;generate_binaries&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_specs-generate_build_scripts</a-s><a-p>&quot;&gt;generate_build_scripts&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.from_specs-splicing_config</a-s><a-p>&quot;&gt;splicing_config&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="L345" href="#L345">345</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>#crate.from_specs-supported_platform_triples</a-s><a-p>&quot;&gt;supported_platform_triples&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L346" href="#L346">346</a><span class="code-text"><a-p>crate.spec(&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.spec-artifact</a-s><a-p>&quot;&gt;artifact&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.spec-branch</a-s><a-p>&quot;&gt;branch&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.spec-default_features</a-s><a-p>&quot;&gt;default_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>#crate.spec-features</a-s><a-p>&quot;&gt;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>#crate.spec-git</a-s><a-p>&quot;&gt;git&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.spec-lib</a-s><a-p>&quot;&gt;lib&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.spec-package</a-s><a-p>&quot;&gt;package&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.spec-rev</a-s><a-p>&quot;&gt;rev&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.spec-tag</a-s><a-p>&quot;&gt;tag&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;, &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>#crate.spec-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="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"></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>Crate universe module extensions.</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"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L351" href="#L351">351</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L352" href="#L352">352</a><span class="code-text"><a-p>**TAG CLASSES**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L353" href="#L353">353</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L354" href="#L354">354</a><span class="code-text"><a-p>&lt;a id=&quot;crate.annotation&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L355" href="#L355">355</a><span class="code-text"></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>### </a-p><a-tt>annotation</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L357" href="#L357">357</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L358" href="#L358">358</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="L359" href="#L359">359</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L360" href="#L360">360</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L361" href="#L361">361</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</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"><a-p>| &lt;a id=&quot;crate.annotation-deps&quot;&gt;&lt;/a&gt;deps |  A list of labels to add to a crate&#39;s `rust_library::deps` attribute.   | List of strings | optional |  `[]`  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L363" href="#L363">363</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-data&quot;&gt;&lt;/a&gt;data |  A list of labels to add to a crate&#39;s `rust_library::data` attribute.   | List of strings | optional |  `[]`  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L364" href="#L364">364</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-additive_build_file&quot;&gt;&lt;/a&gt;additive_build_file |  A file containing extra contents to write to the bottom of generated BUILD files.   | &lt;a href=&quot;https://bazel.build/concepts/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="L365" href="#L365">365</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-additive_build_file_content&quot;&gt;&lt;/a&gt;additive_build_file_content |  Extra contents to write to the bottom of generated BUILD files.   | String | optional |  `&quot;&quot;`  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L366" href="#L366">366</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-alias_rule&quot;&gt;&lt;/a&gt;alias_rule |  Alias rule to use instead of `native.alias()`.  Overrides [render_config](#render_config)&#39;s &#39;default_alias_rule&#39;.   | String | optional |  `&quot;&quot;`  |</a-p></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>| &lt;a id=&quot;crate.annotation-build_script_data&quot;&gt;&lt;/a&gt;build_script_data |  A list of labels to add to a crate&#39;s `cargo_build_script::data` attribute.   | List of strings | optional |  `[]`  |</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>| &lt;a id=&quot;crate.annotation-build_script_data_glob&quot;&gt;&lt;/a&gt;build_script_data_glob |  A list of glob patterns to add to a crate&#39;s `cargo_build_script::data` attribute   | List of strings | optional |  `[]`  |</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;crate.annotation-build_script_deps&quot;&gt;&lt;/a&gt;build_script_deps |  A list of labels to add to a crate&#39;s `cargo_build_script::deps` attribute.   | List of strings | optional |  `[]`  |</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;crate.annotation-build_script_env&quot;&gt;&lt;/a&gt;build_script_env |  Additional environment variables to set on a crate&#39;s `cargo_build_script::env` attribute.   | &lt;a href=&quot;https://bazel.build/rules/lib/dict&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="L371" href="#L371">371</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-build_script_proc_macro_deps&quot;&gt;&lt;/a&gt;build_script_proc_macro_deps |  A list of labels to add to a crate&#39;s `cargo_build_script::proc_macro_deps` attribute.   | List of strings | 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;crate.annotation-build_script_rundir&quot;&gt;&lt;/a&gt;build_script_rundir |  An override for the build script&#39;s rundir attribute.   | String | optional |  `&quot;&quot;`  |</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;crate.annotation-build_script_rustc_env&quot;&gt;&lt;/a&gt;build_script_rustc_env |  Additional environment variables to set on a crate&#39;s `cargo_build_script::env` attribute.   | &lt;a href=&quot;https://bazel.build/rules/lib/dict&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="L374" href="#L374">374</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-build_script_toolchains&quot;&gt;&lt;/a&gt;build_script_toolchains |  A list of labels to set on a crates&#39;s `cargo_build_script::toolchains` attribute.   | &lt;a href=&quot;https://bazel.build/concepts/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="L375" href="#L375">375</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-build_script_tools&quot;&gt;&lt;/a&gt;build_script_tools |  A list of labels to add to a crate&#39;s `cargo_build_script::tools` attribute.   | List of strings | 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;crate.annotation-compile_data&quot;&gt;&lt;/a&gt;compile_data |  A list of labels to add to a crate&#39;s `rust_library::compile_data` attribute.   | List of strings | 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;crate.annotation-compile_data_glob&quot;&gt;&lt;/a&gt;compile_data_glob |  A list of glob patterns to add to a crate&#39;s `rust_library::compile_data` attribute.   | List of strings | optional |  `[]`  |</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;crate.annotation-crate&quot;&gt;&lt;/a&gt;crate |  The name of the crate the annotation is applied to   | String | required |  |</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;crate.annotation-crate_features&quot;&gt;&lt;/a&gt;crate_features |  A list of strings to add to a crate&#39;s `rust_library::crate_features` attribute.   | List of strings | 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;crate.annotation-data_glob&quot;&gt;&lt;/a&gt;data_glob |  A list of glob patterns to add to a crate&#39;s `rust_library::data` attribute.   | List of strings | 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;crate.annotation-disable_pipelining&quot;&gt;&lt;/a&gt;disable_pipelining |  If True, disables pipelining for library targets for this crate.   | Boolean | optional |  `False`  |</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;crate.annotation-extra_aliased_targets&quot;&gt;&lt;/a&gt;extra_aliased_targets |  A list of targets to add to the generated aliases in the root crate_universe repository.   | &lt;a href=&quot;https://bazel.build/rules/lib/dict&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="L383" href="#L383">383</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-gen_all_binaries&quot;&gt;&lt;/a&gt;gen_all_binaries |  If true, generates `rust_binary` targets for all of the crates bins   | Boolean | optional |  `False`  |</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;crate.annotation-gen_binaries&quot;&gt;&lt;/a&gt;gen_binaries |  As a list, the subset of the crate&#39;s bins that should get `rust_binary` targets produced.   | List of strings | optional |  `[]`  |</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"><a-p>| &lt;a id=&quot;crate.annotation-gen_build_script&quot;&gt;&lt;/a&gt;gen_build_script |  An authorative flag to determine whether or not to produce `cargo_build_script` targets for the current crate. Supported values are &#39;on&#39;, &#39;off&#39;, and &#39;auto&#39;.   | String | optional |  `&quot;auto&quot;`  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L386" href="#L386">386</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-override_target_bin&quot;&gt;&lt;/a&gt;override_target_bin |  An optional alternate taget to use when something depends on this crate to allow the parent repo to provide its own version of this dependency.   | &lt;a href=&quot;https://bazel.build/concepts/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="L387" href="#L387">387</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-override_target_build_script&quot;&gt;&lt;/a&gt;override_target_build_script |  An optional alternate taget to use when something depends on this crate to allow the parent repo to provide its own version of this dependency.   | &lt;a href=&quot;https://bazel.build/concepts/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="L388" href="#L388">388</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-override_target_lib&quot;&gt;&lt;/a&gt;override_target_lib |  An optional alternate taget to use when something depends on this crate to allow the parent repo to provide its own version of this dependency.   | &lt;a href=&quot;https://bazel.build/concepts/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="L389" href="#L389">389</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-override_target_proc_macro&quot;&gt;&lt;/a&gt;override_target_proc_macro |  An optional alternate taget to use when something depends on this crate to allow the parent repo to provide its own version of this dependency.   | &lt;a href=&quot;https://bazel.build/concepts/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="L390" href="#L390">390</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-patch_args&quot;&gt;&lt;/a&gt;patch_args |  The `patch_args` attribute of a Bazel repository rule. See [http_archive.patch_args](https://docs.bazel.build/versions/main/repo/http.html#http_archive-patch_args)   | List of strings | optional |  `[]`  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L391" href="#L391">391</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-patch_tool&quot;&gt;&lt;/a&gt;patch_tool |  The `patch_tool` attribute of a Bazel repository rule. See [http_archive.patch_tool](https://docs.bazel.build/versions/main/repo/http.html#http_archive-patch_tool)   | String | optional |  `&quot;&quot;`  |</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>| &lt;a id=&quot;crate.annotation-patches&quot;&gt;&lt;/a&gt;patches |  The `patches` attribute of a Bazel repository rule. See [http_archive.patches](https://docs.bazel.build/versions/main/repo/http.html#http_archive-patches)   | &lt;a href=&quot;https://bazel.build/concepts/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="L393" href="#L393">393</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-proc_macro_deps&quot;&gt;&lt;/a&gt;proc_macro_deps |  A list of labels to add to a crate&#39;s `rust_library::proc_macro_deps` attribute.   | List of strings | optional |  `[]`  |</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 id=&quot;crate.annotation-repositories&quot;&gt;&lt;/a&gt;repositories |  A list of repository names specified from `crate.from_cargo(name=...)` that this annotation is applied to. Defaults to all repositories.   | List of strings | optional |  `[]`  |</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 id=&quot;crate.annotation-rustc_env&quot;&gt;&lt;/a&gt;rustc_env |  Additional variables to set on a crate&#39;s `rust_library::rustc_env` attribute.   | &lt;a href=&quot;https://bazel.build/rules/lib/dict&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="L396" href="#L396">396</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-rustc_env_files&quot;&gt;&lt;/a&gt;rustc_env_files |  A list of labels to set on a crate&#39;s `rust_library::rustc_env_files` attribute.   | List of strings | optional |  `[]`  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L397" href="#L397">397</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.annotation-rustc_flags&quot;&gt;&lt;/a&gt;rustc_flags |  A list of strings to set on a crate&#39;s `rust_library::rustc_flags` attribute.   | List of strings | optional |  `[]`  |</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"><a-p>| &lt;a id=&quot;crate.annotation-shallow_since&quot;&gt;&lt;/a&gt;shallow_since |  An optional timestamp used for crates originating from a git repository instead of a crate registry. This flag optimizes fetching the source code.   | String | optional |  `&quot;&quot;`  |</a-p></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>| &lt;a id=&quot;crate.annotation-version&quot;&gt;&lt;/a&gt;version |  The versions of the crate the annotation is applied to. Defaults to all versions.   | String | optional |  `&quot;*&quot;`  |</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"></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>&lt;a id=&quot;crate.from_cargo&quot;&gt;&lt;/a&gt;</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>### </a-p><a-tt>from_cargo</a-tt></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>Generates a repo @crates from a Cargo.toml / Cargo.lock pair.</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"><a-p>**Attributes**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L408" href="#L408">408</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L409" href="#L409">409</a><span class="code-text"><a-p>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L410" href="#L410">410</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></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>| &lt;a id=&quot;crate.from_cargo-name&quot;&gt;&lt;/a&gt;name |  The name of the repo to generate   | &lt;a href=&quot;https://bazel.build/concepts/labels#target-names&quot;&gt;Name&lt;/a&gt; | optional |  `&quot;crates&quot;`  |</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>| &lt;a id=&quot;crate.from_cargo-cargo_config&quot;&gt;&lt;/a&gt;cargo_config |  A [Cargo configuration](https://doc.rust-lang.org/cargo/reference/config.html) file.   | &lt;a href=&quot;https://bazel.build/concepts/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="L413" href="#L413">413</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.from_cargo-cargo_lockfile&quot;&gt;&lt;/a&gt;cargo_lockfile |  The path to an existing `Cargo.lock` file   | &lt;a href=&quot;https://bazel.build/concepts/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="L414" href="#L414">414</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.from_cargo-generate_binaries&quot;&gt;&lt;/a&gt;generate_binaries |  Whether to generate `rust_binary` targets for all the binary crates in every package. By default only the `rust_library` targets are generated.   | Boolean | optional |  `False`  |</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;crate.from_cargo-generate_build_scripts&quot;&gt;&lt;/a&gt;generate_build_scripts |  Whether or not to generate [cargo build scripts](https://doc.rust-lang.org/cargo/reference/build-scripts.html) by default.   | Boolean | optional |  `True`  |</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;crate.from_cargo-manifests&quot;&gt;&lt;/a&gt;manifests |  A list of Cargo manifests (`Cargo.toml` files).   | &lt;a href=&quot;https://bazel.build/concepts/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="L417" href="#L417">417</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.from_cargo-splicing_config&quot;&gt;&lt;/a&gt;splicing_config |  The configuration flags to use for splicing Cargo maniests. Use `//crate_universe:defs.bzl\%rsplicing_config` to generate the value for this field. If unset, the defaults defined there will be used.   | 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;crate.from_cargo-supported_platform_triples&quot;&gt;&lt;/a&gt;supported_platform_triples |  A set of all platform triples to consider when generating dependencies.   | List of strings | optional |  `[&quot;aarch64-apple-darwin&quot;, &quot;aarch64-apple-ios&quot;, &quot;aarch64-apple-ios-sim&quot;, &quot;aarch64-linux-android&quot;, &quot;aarch64-pc-windows-msvc&quot;, &quot;aarch64-unknown-fuchsia&quot;, &quot;aarch64-unknown-linux-gnu&quot;, &quot;aarch64-unknown-nixos-gnu&quot;, &quot;aarch64-unknown-nto-qnx710&quot;, &quot;arm-unknown-linux-gnueabi&quot;, &quot;armv7-linux-androideabi&quot;, &quot;armv7-unknown-linux-gnueabi&quot;, &quot;i686-apple-darwin&quot;, &quot;i686-linux-android&quot;, &quot;i686-pc-windows-msvc&quot;, &quot;i686-unknown-freebsd&quot;, &quot;i686-unknown-linux-gnu&quot;, &quot;powerpc-unknown-linux-gnu&quot;, &quot;riscv32imc-unknown-none-elf&quot;, &quot;riscv64gc-unknown-none-elf&quot;, &quot;s390x-unknown-linux-gnu&quot;, &quot;thumbv7em-none-eabi&quot;, &quot;thumbv8m.main-none-eabi&quot;, &quot;wasm32-unknown-unknown&quot;, &quot;wasm32-wasip1&quot;, &quot;x86_64-apple-darwin&quot;, &quot;x86_64-apple-ios&quot;, &quot;x86_64-linux-android&quot;, &quot;x86_64-pc-windows-msvc&quot;, &quot;x86_64-unknown-freebsd&quot;, &quot;x86_64-unknown-fuchsia&quot;, &quot;x86_64-unknown-linux-gnu&quot;, &quot;x86_64-unknown-nixos-gnu&quot;, &quot;x86_64-unknown-none&quot;]`  |</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"></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;crate.from_specs&quot;&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L421" href="#L421">421</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L422" href="#L422">422</a><span class="code-text"><a-p>### </a-p><a-tt>from_specs</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L423" href="#L423">423</a><span class="code-text"></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>Generates a repo @crates from the defined `spec` tags.</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"></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>**Attributes**</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"></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>| Name  | Description | Type | Mandatory | Default |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L429" href="#L429">429</a><span class="code-text"><a-p>| :------------- | :------------- | :------------- | :------------- | :------------- |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L430" href="#L430">430</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.from_specs-name&quot;&gt;&lt;/a&gt;name |  The name of the repo to generate.   | &lt;a href=&quot;https://bazel.build/concepts/labels#target-names&quot;&gt;Name&lt;/a&gt; | optional |  `&quot;crates&quot;`  |</a-p></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;crate.from_specs-cargo_config&quot;&gt;&lt;/a&gt;cargo_config |  A [Cargo configuration](https://doc.rust-lang.org/cargo/reference/config.html) file.   | &lt;a href=&quot;https://bazel.build/concepts/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="L432" href="#L432">432</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.from_specs-generate_binaries&quot;&gt;&lt;/a&gt;generate_binaries |  Whether to generate `rust_binary` targets for all the binary crates in every package. By default only the `rust_library` targets are generated.   | Boolean | optional |  `False`  |</a-p></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>| &lt;a id=&quot;crate.from_specs-generate_build_scripts&quot;&gt;&lt;/a&gt;generate_build_scripts |  Whether or not to generate [cargo build scripts](https://doc.rust-lang.org/cargo/reference/build-scripts.html) by default.   | Boolean | optional |  `True`  |</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L434" href="#L434">434</a><span class="code-text"><a-p>| &lt;a id=&quot;crate.from_specs-splicing_config&quot;&gt;&lt;/a&gt;splicing_config |  The configuration flags to use for splicing Cargo maniests. Use `//crate_universe:defs.bzl\%rsplicing_config` to generate the value for this field. If unset, the defaults defined there will be used.   | String | optional |  `&quot;&quot;`  |</a-p></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 id=&quot;crate.from_specs-supported_platform_triples&quot;&gt;&lt;/a&gt;supported_platform_triples |  A set of all platform triples to consider when generating dependencies.   | List of strings | optional |  `[&quot;aarch64-apple-darwin&quot;, &quot;aarch64-apple-ios&quot;, &quot;aarch64-apple-ios-sim&quot;, &quot;aarch64-linux-android&quot;, &quot;aarch64-pc-windows-msvc&quot;, &quot;aarch64-unknown-fuchsia&quot;, &quot;aarch64-unknown-linux-gnu&quot;, &quot;aarch64-unknown-nixos-gnu&quot;, &quot;aarch64-unknown-nto-qnx710&quot;, &quot;arm-unknown-linux-gnueabi&quot;, &quot;armv7-linux-androideabi&quot;, &quot;armv7-unknown-linux-gnueabi&quot;, &quot;i686-apple-darwin&quot;, &quot;i686-linux-android&quot;, &quot;i686-pc-windows-msvc&quot;, &quot;i686-unknown-freebsd&quot;, &quot;i686-unknown-linux-gnu&quot;, &quot;powerpc-unknown-linux-gnu&quot;, &quot;riscv32imc-unknown-none-elf&quot;, &quot;riscv64gc-unknown-none-elf&quot;, &quot;s390x-unknown-linux-gnu&quot;, &quot;thumbv7em-none-eabi&quot;, &quot;thumbv8m.main-none-eabi&quot;, &quot;wasm32-unknown-unknown&quot;, &quot;wasm32-wasip1&quot;, &quot;x86_64-apple-darwin&quot;, &quot;x86_64-apple-ios&quot;, &quot;x86_64-linux-android&quot;, &quot;x86_64-pc-windows-msvc&quot;, &quot;x86_64-unknown-freebsd&quot;, &quot;x86_64-unknown-fuchsia&quot;, &quot;x86_64-unknown-linux-gnu&quot;, &quot;x86_64-unknown-nixos-gnu&quot;, &quot;x86_64-unknown-none&quot;]`  |</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"></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 id=&quot;crate.spec&quot;&gt;&lt;/a&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"></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>### </a-p><a-tt>spec</a-tt></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">**Attributes**</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">| Name  | Description | Type | Mandatory | Default |</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">| &lt;a id=&quot;crate.spec-artifact&quot;&gt;&lt;/a&gt;artifact |  Set to &#39;bin&#39; to pull in a binary crate as an artifact dependency. Requires a nightly Cargo.   | String | optional |  `&quot;&quot;`  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L446" href="#L446">446</a><span class="code-text">| &lt;a id=&quot;crate.spec-branch&quot;&gt;&lt;/a&gt;branch |  The git branch of the remote crate. Tied with the `git` param. Only one of branch, tag or rev may be specified. Specifying `rev` is recommended for fully-reproducible builds.   | String | optional |  `&quot;&quot;`  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L447" href="#L447">447</a><span class="code-text">| &lt;a id=&quot;crate.spec-default_features&quot;&gt;&lt;/a&gt;default_features |  Maps to the `default-features` flag.   | Boolean | optional |  `True`  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L448" href="#L448">448</a><span class="code-text">| &lt;a id=&quot;crate.spec-features&quot;&gt;&lt;/a&gt;features |  A list of features to use for the crate.   | List of strings | optional |  `[]`  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L449" href="#L449">449</a><span class="code-text">| &lt;a id=&quot;crate.spec-git&quot;&gt;&lt;/a&gt;git |  The Git url to use for the crate. Cannot be used with `version`.   | String | optional |  `&quot;&quot;`  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L450" href="#L450">450</a><span class="code-text">| &lt;a id=&quot;crate.spec-lib&quot;&gt;&lt;/a&gt;lib |  If using `artifact = &#39;bin&#39;`, additionally setting `lib = True` declares a dependency on both the package&#39;s library and binary, as opposed to just the binary.   | Boolean | optional |  `False`  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L451" href="#L451">451</a><span class="code-text">| &lt;a id=&quot;crate.spec-package&quot;&gt;&lt;/a&gt;package |  The explicit name of the package.   | String | required |  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L452" href="#L452">452</a><span class="code-text">| &lt;a id=&quot;crate.spec-rev&quot;&gt;&lt;/a&gt;rev |  The git revision of the remote crate. Tied with the `git` param. Only one of branch, tag or rev may be specified.   | String | optional |  `&quot;&quot;`  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L453" href="#L453">453</a><span class="code-text">| &lt;a id=&quot;crate.spec-tag&quot;&gt;&lt;/a&gt;tag |  The git tag of the remote crate. Tied with the `git` param. Only one of branch, tag or rev may be specified. Specifying `rev` is recommended for fully-reproducible builds.   | String | optional |  `&quot;&quot;`  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L454" href="#L454">454</a><span class="code-text">| &lt;a id=&quot;crate.spec-version&quot;&gt;&lt;/a&gt;version |  The exact version of the crate. Cannot be used with `git`.   | String | optional |  `&quot;&quot;`  |</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L455" href="#L455">455</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L456" href="#L456">456</a><span class="code-text"></span></span></pre></div></div>
</main>
</body>
</html>
