fork/rules_rust
git clone https://git.julia.blue/fork/rules_rust
ba7abedc
gh-pages
1<!DOCTYPE HTML > 2< html lang ="en "class ="light sidebar-visible "dir ="ltr "> 3< head > 4<!-- Book generated using mdBook --> 5< meta charset ="UTF-8 "> 6< title > crate_universe (bzlmod) - rules_rust</ title > 7 8 9<!-- Custom HTML head --> 10 11< meta name ="description "content =""> 12< meta name ="viewport "content ="width=device-width, initial-scale=1 "> 13< meta name ="theme-color "content ="#ffffff "> 14 15< link rel ="icon "href ="favicon.svg "> 16< link rel ="shortcut icon "href ="favicon.png "> 17< link rel ="stylesheet "href ="css/variables.css "> 18< link rel ="stylesheet "href ="css/general.css "> 19< link rel ="stylesheet "href ="css/chrome.css "> 20< link rel ="stylesheet "href ="css/print.css "media ="> 21 22<!-- Fonts --> 23< link rel ="stylesheet "href ="FontAwesome/css/font-awesome.css "> 24< link rel ="stylesheet "href ="fonts/fonts.css "> 25 26<!-- Highlight.js Stylesheets --> 27< link rel ="stylesheet "href ="highlight.css "> 28< link rel ="stylesheet "href ="tomorrow-night.css "> 29< link rel ="stylesheet "href ="ayu-highlight.css "> 30 31<!-- Custom theme stylesheets --> 32 33 34<!-- Provide site root to javascript --> 35< script > 36var path_to_root = "" ; 37var default_theme = window . matchMedia ( "(prefers-color-scheme: dark)" ). matches ?"navy" :"light" ; 38</ script > 39<!-- Start loading toc.js asap --> 40< script src ="toc.js "></ script > 41</ head > 42< body > 43< div id ="body-container "> 44<!-- Work around some values being stored in localStorage wrapped in quotes --> 45< script > 46try { 47var theme = localStorage . getItem ( 'mdbook-theme' ); 48var sidebar = localStorage . getItem ( 'mdbook-sidebar' ); 49 50if ( theme . startsWith ( '"' ) && theme . endsWith ( '"' )) { 51localStorage . setItem ( 'mdbook-theme' , theme . slice ( 1 , theme . length - 1 )); 52} 53 54if ( sidebar . startsWith ( '"' ) && sidebar . endsWith ( '"' )) { 55localStorage . setItem ( 'mdbook-sidebar' , sidebar . slice ( 1 , sidebar . length - 1 )); 56} 57} catch ( e ) { } 58</ script > 59 60<!-- Set the theme before any content is loaded, prevents flash --> 61< script > 62var theme ; 63try { theme = localStorage . getItem ( 'mdbook-theme' ); } catch ( e ) { } 64if ( theme === null || theme === undefined ) { theme = default_theme ; } 65const html = document . documentElement ; 66html . classList . remove ( 'light' ) 67html . classList . add ( theme ); 68html . classList . add ( "js" ); 69</ script > 70 71< input type ="checkbox "id ="sidebar-toggle-anchor "class ="hidden "> 72 73<!-- Hide / unhide sidebar before it is displayed --> 74< script > 75var sidebar = null ; 76var sidebar_toggle = document . getElementById ( "sidebar-toggle-anchor" ); 77if ( document . body . clientWidth >= 1080 ) { 78try { sidebar = localStorage . getItem ( 'mdbook-sidebar' ); } catch ( e ) { } 79sidebar = sidebar || 'visible' ; 80} else { 81sidebar = 'hidden' ; 82} 83sidebar_toggle . checked = sidebar === 'visible' ; 84html . classList . remove ( 'sidebar-visible' ); 85html . classList . add ( "sidebar-" + sidebar ); 86</ script > 87 88< nav id ="sidebar "class ="sidebar "aria-label ="Table of contents "> 89<!-- populated by js --> 90< mdbook-sidebar-scrollbox class ="sidebar-scrollbox "></ mdbook-sidebar-scrollbox > 91< noscript > 92< iframe class ="sidebar-iframe-outer "src ="toc.html "></ iframe > 93</ noscript > 94< div id ="sidebar-resize-handle "class ="sidebar-resize-handle "> 95< div class ="sidebar-resize-indicator "></ div > 96</ div > 97</ nav > 98 99< div id ="page-wrapper "class ="page-wrapper "> 100 101< div class ="page "> 102< div id ="menu-bar-hover-placeholder "></ div > 103< div id ="menu-bar "class ="menu-bar sticky "> 104< div class ="left-buttons "> 105< label id ="sidebar-toggle "class ="icon-button "for ="sidebar-toggle-anchor "title ="Toggle Table of Contents "aria-label ="Toggle Table of Contents "aria-controls ="sidebar "> 106< i class ="fa fa-bars "></ i > 107</ label > 108< button id ="theme-toggle "class ="icon-button "type ="button "title ="Change theme "aria-label ="Change theme "aria-haspopup ="true "aria-expanded ="false "aria-controls ="theme-list "> 109< i class ="fa fa-paint-brush "></ i > 110</ button > 111< ul id ="theme-list "class ="theme-popup "aria-label ="Themes "role ="menu "> 112< li role ="none ">< button role ="menuitem "class ="theme "id ="light "> Light</ button ></ li > 113< li role ="none ">< button role ="menuitem "class ="theme "id ="rust "> Rust</ button ></ li > 114< li role ="none ">< button role ="menuitem "class ="theme "id ="coal "> Coal</ button ></ li > 115< li role ="none ">< button role ="menuitem "class ="theme "id ="navy "> Navy</ button ></ li > 116< li role ="none ">< button role ="menuitem "class ="theme "id ="ayu "> Ayu</ button ></ li > 117</ ul > 118< button id ="search-toggle "class ="icon-button "type ="button "title ="Search. (Shortkey: s) "aria-label ="Toggle Searchbar "aria-expanded ="false "aria-keyshortcuts ="S "aria-controls ="searchbar "> 119< i class ="fa fa-search "></ i > 120</ button > 121</ div > 122 123< h1 class ="menu-title "> rules_rust</ h1 > 124 125< div class ="right-buttons "> 126< a href ="print.html "title ="Print this book "aria-label ="Print this book "> 127< i id ="print-button "class ="fa fa-print "></ i > 128</ a > 129< a href ="https://github.com/bazelbuild/rules_rust "title ="Git repository "aria-label ="Git repository "> 130< i id ="git-repository-button "class ="fa fa-github "></ i > 131</ a > 132 133</ div > 134</ div > 135 136< div id ="search-wrapper "class ="hidden "> 137< form id ="searchbar-outer "class ="searchbar-outer "> 138< input type ="search "id ="searchbar "name ="searchbar "placeholder ="Search this book ... "aria-controls ="searchresults-outer "aria-describedby ="searchresults-header "> 139</ form > 140< div id ="searchresults-outer "class ="searchresults-outer hidden "> 141< div id ="searchresults-header "class ="searchresults-header "></ div > 142< ul id ="searchresults "> 143</ ul > 144</ div > 145</ div > 146 147<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> 148< script > 149document . getElementById ( 'sidebar-toggle' ). setAttribute ( 'aria-expanded' , sidebar === 'visible' ); 150document . getElementById ( 'sidebar' ). setAttribute ( 'aria-hidden' , sidebar !== 'visible' ); 151Array . from ( document . querySelectorAll ( '#sidebar a' )). forEach ( function ( link ) { 152link . setAttribute ( 'tabIndex' , sidebar === 'visible' ?0 :- 1 ); 153}); 154</ script > 155 156< div id ="content "class ="content "> 157< main > 158<!-- Generated with Stardoc: http://skydoc.bazel.build --> 159< h1 id ="crate-universe ">< a class ="header "href ="#crate-universe "> Crate Universe</ a ></ h1 > 160< p > Crate Universe is a set of Bazel rule for generating Rust targets using Cargo.</ p > 161< p > This doc describes using crate_universe with bzlmod.</ p > 162< p > If you're using a WORKSPACE file, please see< a href ="crate_universe.html "> the WORKSPACE equivalent of this doc</ a > .</ p > 163< p > There are some examples of using crate_universe with bzlmod in the< a href ="../examples/bzlmod "> example folder</ a > .</ p > 164< h1 id ="table-of-contents ">< a class ="header "href ="#table-of-contents "> Table of Contents</ a ></ h1 > 165< ol > 166< li >< a href ="#Setup "> Setup</ a ></ li > 167< li >< a href ="#dependencies "> Dependencies</ a > 168< ul > 169< li >< a href ="#cargo-workspaces "> Cargo Workspace</ a ></ li > 170< li >< a href ="#direct-dependencies "> Direct Packages</ a ></ li > 171< li >< a href ="#vendored-dependencies "> Vendored Dependencies</ a ></ li > 172</ ul > 173</ li > 174< li >< a href ="#crate "> Crate reference</ a > 175< ul > 176< li >< a href ="#from_cargo "> from_cargo</ a ></ li > 177< li >< a href ="#from_specs "> from_specs</ a ></ li > 178</ ul > 179</ li > 180</ ol > 181< h2 id ="setup ">< a class ="header "href ="#setup "> Setup</ a ></ h2 > 182< p > To use rules_rust in a project using bzlmod, add the following to your MODULE.bazel file:</ p > 183< pre >< code class ="language-starlark "> bazel_dep(name = "rules_rust", version = "0.49.3") 184</ code ></ pre > 185< p > You find the latest version on the< a href ="https://github.com/bazelbuild/rules_rust/releases "> release page</ a > .</ p > 186< p > After adding< code > rules_rust</ code > in your MODULE.bazel, set the following to begin using< code > crate_universe</ code > :</ p > 187< pre >< code class ="language-starlark "> crate = use_extension("@rules_rust//crate_universe:extensions.bzl", "crate") 188// # ... Dependencies 189use_repo(crate, "crates") 190</ code ></ pre > 191< h2 id ="dependencies ">< a class ="header "href ="#dependencies "> Dependencies</ a ></ h2 > 192< p > There are three different ways to declare dependencies in your MODULE.</ p > 193< ol > 194< li > Cargo workspace</ li > 195< li > Direct Dependencies</ li > 196< li > Vendored Dependencies</ li > 197</ ol > 198< h3 id ="cargo-workspaces ">< a class ="header "href ="#cargo-workspaces "> Cargo Workspaces</ a ></ h3 > 199< p > One of the simpler ways to wire up dependencies would be to first structure your project into a Cargo workspace. 200The crates_repository rule can ingest a root Cargo.toml file and generate Bazel dependencies from there. 201You find a complete example in the in the< a href ="../examples/bzlmod/all_crate_deps "> example folder</ a > .</ p > 202< pre >< code class ="language-starlark "> crate = use_extension("@rules_rust//crate_universe:extensions.bzl", "crate") 203 204crate.from_cargo( 205 name = "crates", 206 cargo_lockfile = "//:Cargo.lock", 207 manifests = ["//:Cargo.toml"], 208) 209use_repo(crate, "crates") 210</ code ></ pre > 211< p > The generated crates_repository contains helper macros which make collecting dependencies for Bazel targets simpler. 212Notably, the all_crate_deps and aliases macros ( 213see< a href ="https://bazelbuild.github.io/rules_rust/crate_universe.html#dependencies-api "> Dependencies API</ a > ) commonly allow the 214Cargo.toml files to be the single source of truth for dependencies. 215Since these macros come from the generated repository, the dependencies and alias definitions 216they return will automatically update BUILD targets. In your BUILD files, 217you use these macros for a Rust library as shown below:</ p > 218< pre >< code class ="language-starlark "> load("@crate_index//:defs.bzl", "aliases", "all_crate_deps") 219load("@rules_rust//rust:defs.bzl", "rust_library", "rust_test") 220 221rust_library( 222 name = "lib", 223 aliases = aliases(), 224 deps = all_crate_deps( 225 normal = True, 226 ), 227 proc_macro_deps = all_crate_deps( 228 proc_macro = True, 229 ), 230) 231 232rust_test( 233 name = "unit_test", 234 crate = ":lib", 235 aliases = aliases( 236 normal_dev = True, 237 proc_macro_dev = True, 238 ), 239 deps = all_crate_deps( 240 normal_dev = True, 241 ), 242 proc_macro_deps = all_crate_deps( 243 proc_macro_dev = True, 244 ), 245) 246</ code ></ pre > 247< p > For a Rust binary that does not depend on any macro, use the following configuration 248in your build file:</ p > 249< pre >< code class ="language-starlark "> rust_binary( 250 name = "bin", 251 srcs = ["src/main.rs"], 252 deps = all_crate_deps(normal = True), 253) 254</ code ></ pre > 255< p > You have to repin before your first build to ensure all Bazel targets for the macros 256are generated.</ p > 257< p > Dependency syncing and updating is done in the repository rule which means it's done during the 258analysis phase of builds. As mentioned in the environments variable table above, the< code > CARGO_BAZEL_REPIN</ code > 259(or< code > REPIN</ code > ) environment variables can be used to force the rule to update dependencies and potentially 260render a new lockfile. Given an instance of this repository rule named< code > crates</ code > , the easiest way to 261repin dependencies is to run:</ p > 262< pre >< code class ="language-shell "> CARGO_BAZEL_REPIN=1 bazel sync --only=crates 263</ code ></ pre > 264< p > This will result in all dependencies being updated for a project. The< code > CARGO_BAZEL_REPIN</ code > 265environment variable can also be used to customize how dependencies are updated. 266For more details about repin,< a href ="https://bazelbuild.github.io/rules_rust/crate_universe.html#crates_vendor "> please refer to the documentation</ a > .</ p > 267< h3 id ="direct-dependencies ">< a class ="header "href ="#direct-dependencies "> Direct Dependencies</ a ></ h3 > 268< 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 > , 269etc.), maintaining Cargo.toml files may have diminishing returns as things like rust-analyzer 270begin to be confused about missing targets or environment variables defined only in Bazel. 271In 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 > 272< p > crates_repository supports this through the packages attribute, 273as shown below.</ p > 274< pre >< code class ="language-starlark "> crate = use_extension("@rules_rust//crate_universe:extensions.bzl", "crate") 275 276crate.spec(package = "serde", features = ["derive"], version = "1.0") 277crate.spec(package = "serde_json", version = "1.0") 278crate.spec(package = "tokio", default_features=False, features = ["macros", "net", "rt-multi-thread"], version = "1.38") 279 280crate.from_specs() 281use_repo(crate, "crates") 282</ code ></ pre > 283< p > Consuming dependencies may be more ergonomic in this case through the aliases defined in the new repository. 284In your BUILD files, you use direct dependencies as shown below:</ p > 285< pre >< code class ="language-starlark "> rust_binary( 286 name = "bin", 287 crate_root = "src/main.rs", 288 srcs = glob([ 289 "src/*.rs", 290 ]), 291 deps = [ 292 # External crates 293 "@crates//:serde", 294 "@crates//:serde_json", 295 "@crates//:tokio", 296 ], 297 visibility = ["//visibility:public"], 298) 299</ code ></ pre > 300< p > Notice, direct dependencies do not need repining. 301Only a cargo workspace needs updating whenever the underlying Cargo.toml file changed.</ p > 302< h3 id ="vendored-dependencies ">< a class ="header "href ="#vendored-dependencies "> Vendored Dependencies</ a ></ h3 > 303< p > In some cases, it is require that all external dependencies are vendored, meaning downloaded 304and stored in the workspace. This helps, for example, to conduct licence scans, apply custom patches, 305or to ensure full build reproducibility since no download error could possibly occur. 306You find a complete example in the in the< a href ="../examples/bzlmod/all_deps_vendor "> example folder</ a > .</ p > 307< p > For the setup, you need to add the skylib in addition to the rust rules to your MODUE.bazel.</ p > 308< pre >< code class ="language-starlark "> module( 309 name = "deps_vendored", 310 version = "0.0.0" 311) 312############################################################################### 313# B A Z E L C E N T R A L R E G I S T R Y # https://registry.bazel.build/ 314############################################################################### 315# https://github.com/bazelbuild/bazel-skylib/releases/ 316bazel_dep(name = "bazel_skylib", version = "1.7.1") 317 318# https://github.com/bazelbuild/rules_rust/releases 319bazel_dep(name = "rules_rust", version = "0.49.3") 320 321############################################################################### 322# T O O L C H A I N S 323############################################################################### 324 325# Rust toolchain 326RUST_EDITION = "2021" 327RUST_VERSION = "1.80.1" 328 329rust = use_extension("@rules_rust//rust:extensions.bzl", "rust") 330rust.toolchain( 331 edition = RUST_EDITION, 332 versions = [RUST_VERSION], 333) 334use_repo(rust, "rust_toolchains") 335register_toolchains("@rust_toolchains//:all") 336 337############################################################################### 338# R U S T C R A T E S 339############################################################################### 340crate = use_extension("@rules_rust//crate_universe:extensions.bzl", "crate") 341</ code ></ pre > 342< p > Note, it is important to load the crate_universe rules otherwise you will get an error 343as the rule set is needed in the vendored target.</ p > 344< p > Assuming you have a package called< code > basic</ code > in which you want to vendor dependencies, 345then you create a folder< code > basic/3rdparty</ code > . The folder name can be arbitrary, 346but by convention, its either thirdparty or 3rdparty to indicate vendored dependencies. 347In the 3rdparty folder, you add a target crates_vendor to declare your dependencies to vendor. 348In the example, we vendor a specific version of bzip2.</ p > 349< pre >< code class ="language-starlark "> load("@rules_rust//crate_universe:defs.bzl", "crate", "crates_vendor") 350 351crates_vendor( 352 name = "crates_vendor", 353 annotations = { 354 "bzip2-sys": [crate.annotation( 355 gen_build_script = True, 356 )], 357 }, 358 cargo_lockfile = "Cargo.Bazel.lock", 359 generate_build_scripts = False, 360 mode = "remote", 361 packages = { 362 "bzip2": crate.spec( 363 version = "=0.3.3", 364 ), 365 }, 366 repository_name = "basic", 367 tags = ["manual"], 368) 369</ code ></ pre > 370< p > Next, you have to run< code > Cargo build</ code > to generate a Cargo.lock file with all resolved dependencies. 371Then, you rename Cargo.lock to Cargo.Bazel.lock and place it inside the< code > basic/3rdparty</ code > folder.</ p > 372< p > At this point, you have the following folder and files:</ p > 373< pre >< code > basic 374 âââ 3rdparty 375 â âââ BUILD.bazel 376 â âââ Cargo.Bazel.lock 377</ code ></ pre > 378< p > Now you can run the< code > crates_vendor</ code > target:</ p > 379< p >< code > bazel run //basic/3rdparty:crates_vendor</ code ></ p > 380< p > This generates a crate folders with all configurations for the vendored dependencies.</ p > 381< pre >< code > basic 382 âââ 3rdparty 383 â âââ cratea 384 â âââ BUILD.bazel 385 â âââ Cargo.Bazel.lock 386</ code ></ pre > 387< p > Suppose you have an application in< code > basic/src</ code > that is defined in< code > basic/BUILD.bazel</ code > and 388that depends on a vendored dependency. You find a list of all available vendored dependencies 389in the BUILD file of the generated folder:< code > basic/3rdparty/crates/BUILD.bazel</ code > 390You declare a vendored dependency in you target as following:</ p > 391< pre >< code class ="language-starlark "> load("@rules_rust//rust:defs.bzl", "rust_binary") 392 393rust_binary( 394 name = "hello_sys", 395 srcs = ["src/main.rs"], 396 deps = ["//basic/3rdparty/crates:bzip2"], 397 visibility = ["//visibility:public"], 398) 399</ code ></ pre > 400< p > Note, the vendored dependency is not yet accessible because you have to define first 401how to load the vendored dependencies. For that, you first create a file< code > sys_deps.bzl</ code > 402and add the following content:</ p > 403< pre >< code class ="language-starlark "> # rename the default name "crate_repositories" in case you import multiple vendored folders. 404load("//basic/3rdparty/crates:defs.bzl", basic_crate_repositories = "crate_repositories") 405 406def sys_deps(): 407 # Load the vendored dependencies 408 basic_crate_repositories() 409</ code ></ pre > 410< p > This is straightforward, you import the generated crate_repositories from the crates folder, 411rename it to avoid name clashes in case you import from multiple vendored folders, and then 412just load the vendored dependencies.</ p > 413< p > In a WORKSPACE configuration, you would just load and call sys_deps(), but in a MODULE configuration, you cannot do that. 414Instead, you create a new file< code > WORKSPACE.bzlmod</ code > and add the following content.</ p > 415< pre >< code class ="language-starlark "> load("//:sys_deps.bzl", "sys_deps") 416sys_deps() 417</ code ></ pre > 418< p > Now, you can build the project as usual.</ p > 419< 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 > 420< p >< a id ="crate "></ a ></ p > 421< h2 id ="crate ">< a class ="header "href ="#crate "> crate</ a ></ h2 > 422< pre > 423crate = use_extension("@rules_rust//crate_universe:docs_bzlmod.bzl", "crate") 424crate.annotation(< a href ="#crate.annotation-deps "> deps</ a > ,< a href ="#crate.annotation-data "> data</ a > ,< a href ="#crate.annotation-additive_build_file "> additive_build_file</ a > ,< a href ="#crate.annotation-additive_build_file_content "> additive_build_file_content</ a > ,< a href ="#crate.annotation-alias_rule "> alias_rule</ a > , 425< a href ="#crate.annotation-build_script_data "> build_script_data</ a > ,< a href ="#crate.annotation-build_script_data_glob "> build_script_data_glob</ a > ,< a href ="#crate.annotation-build_script_deps "> build_script_deps</ a > ,< a href ="#crate.annotation-build_script_env "> build_script_env</ a > , 426< a href ="#crate.annotation-build_script_proc_macro_deps "> build_script_proc_macro_deps</ a > ,< a href ="#crate.annotation-build_script_rundir "> build_script_rundir</ a > ,< a href ="#crate.annotation-build_script_rustc_env "> build_script_rustc_env</ a > , 427< a href ="#crate.annotation-build_script_toolchains "> build_script_toolchains</ a > ,< a href ="#crate.annotation-build_script_tools "> build_script_tools</ a > ,< a href ="#crate.annotation-compile_data "> compile_data</ a > ,< a href ="#crate.annotation-compile_data_glob "> compile_data_glob</ a > ,< a href ="#crate.annotation-crate "> crate</ a > , 428< a href ="#crate.annotation-crate_features "> crate_features</ a > ,< a href ="#crate.annotation-data_glob "> data_glob</ a > ,< a href ="#crate.annotation-disable_pipelining "> disable_pipelining</ a > ,< a href ="#crate.annotation-extra_aliased_targets "> extra_aliased_targets</ a > , 429< a href ="#crate.annotation-gen_all_binaries "> gen_all_binaries</ a > ,< a href ="#crate.annotation-gen_binaries "> gen_binaries</ a > ,< a href ="#crate.annotation-gen_build_script "> gen_build_script</ a > ,< a href ="#crate.annotation-override_target_bin "> override_target_bin</ a > , 430< a href ="#crate.annotation-override_target_build_script "> override_target_build_script</ a > ,< a href ="#crate.annotation-override_target_lib "> override_target_lib</ a > ,< a href ="#crate.annotation-override_target_proc_macro "> override_target_proc_macro</ a > , 431< a href ="#crate.annotation-patch_args "> patch_args</ a > ,< a href ="#crate.annotation-patch_tool "> patch_tool</ a > ,< a href ="#crate.annotation-patches "> patches</ a > ,< a href ="#crate.annotation-proc_macro_deps "> proc_macro_deps</ a > ,< a href ="#crate.annotation-repositories "> repositories</ a > ,< a href ="#crate.annotation-rustc_env "> rustc_env</ a > , 432< a href ="#crate.annotation-rustc_env_files "> rustc_env_files</ a > ,< a href ="#crate.annotation-rustc_flags "> rustc_flags</ a > ,< a href ="#crate.annotation-shallow_since "> shallow_since</ a > ,< a href ="#crate.annotation-version "> version</ a > ) 433crate.from_cargo(< a href ="#crate.from_cargo-name "> name</ a > ,< a href ="#crate.from_cargo-cargo_config "> cargo_config</ a > ,< a href ="#crate.from_cargo-cargo_lockfile "> cargo_lockfile</ a > ,< a href ="#crate.from_cargo-generate_binaries "> generate_binaries</ a > ,< a href ="#crate.from_cargo-generate_build_scripts "> generate_build_scripts</ a > , 434< a href ="#crate.from_cargo-manifests "> manifests</ a > ,< a href ="#crate.from_cargo-splicing_config "> splicing_config</ a > ,< a href ="#crate.from_cargo-supported_platform_triples "> supported_platform_triples</ a > ) 435crate.from_specs(< a href ="#crate.from_specs-name "> name</ a > ,< a href ="#crate.from_specs-cargo_config "> cargo_config</ a > ,< a href ="#crate.from_specs-generate_binaries "> generate_binaries</ a > ,< a href ="#crate.from_specs-generate_build_scripts "> generate_build_scripts</ a > ,< a href ="#crate.from_specs-splicing_config "> splicing_config</ a > , 436< a href ="#crate.from_specs-supported_platform_triples "> supported_platform_triples</ a > ) 437crate.spec(< a href ="#crate.spec-artifact "> artifact</ a > ,< a href ="#crate.spec-branch "> branch</ a > ,< a href ="#crate.spec-default_features "> default_features</ a > ,< a href ="#crate.spec-features "> features</ a > ,< a href ="#crate.spec-git "> git</ a > ,< a href ="#crate.spec-lib "> lib</ a > ,< a href ="#crate.spec-package "> package</ a > ,< a href ="#crate.spec-rev "> rev</ a > ,< a href ="#crate.spec-tag "> tag</ a > ,< a href ="#crate.spec-version "> version</ a > ) 438</ pre > 439< p > Crate universe module extensions.</ p > 440< p >< strong > TAG CLASSES</ strong ></ p > 441< p >< a id ="crate.annotation "></ a ></ p > 442< h3 id ="annotation ">< a class ="header "href ="#annotation "> annotation</ a ></ h3 > 443< p >< strong > Attributes</ strong ></ p > 444< div class ="table-wrapper ">< 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 > 445< tr >< td style ="text-align: left ">< a id ="crate.annotation-deps "></ a > 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 > 446< tr >< td style ="text-align: left ">< a id ="crate.annotation-data "></ a > 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 > 447< tr >< td style ="text-align: left ">< a id ="crate.annotation-additive_build_file "></ a > 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 ">< a href ="https://bazel.build/concepts/labels "> Label</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > None</ code ></ td ></ tr > 448< tr >< td style ="text-align: left ">< a id ="crate.annotation-additive_build_file_content "></ a > 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 > 449< tr >< td style ="text-align: left ">< a id ="crate.annotation-alias_rule "></ a > 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 > 450< tr >< td style ="text-align: left ">< a id ="crate.annotation-build_script_data "></ a > 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 > 451< tr >< td style ="text-align: left ">< a id ="crate.annotation-build_script_data_glob "></ a > 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 > 452< tr >< td style ="text-align: left ">< a id ="crate.annotation-build_script_deps "></ a > 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 > 453< tr >< td style ="text-align: left ">< a id ="crate.annotation-build_script_env "></ a > 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 ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: String -> String</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > {}</ code ></ td ></ tr > 454< tr >< td style ="text-align: left ">< a id ="crate.annotation-build_script_proc_macro_deps "></ a > 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 > 455< tr >< td style ="text-align: left ">< a id ="crate.annotation-build_script_rundir "></ a > 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 > 456< tr >< td style ="text-align: left ">< a id ="crate.annotation-build_script_rustc_env "></ a > 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 ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: String -> String</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > {}</ code ></ td ></ tr > 457< tr >< td style ="text-align: left ">< a id ="crate.annotation-build_script_toolchains "></ a > 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 ">< a href ="https://bazel.build/concepts/labels "> List of labels</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > []</ code ></ td ></ tr > 458< tr >< td style ="text-align: left ">< a id ="crate.annotation-build_script_tools "></ a > 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 > 459< tr >< td style ="text-align: left ">< a id ="crate.annotation-compile_data "></ a > 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 > 460< tr >< td style ="text-align: left ">< a id ="crate.annotation-compile_data_glob "></ a > 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 > 461< tr >< td style ="text-align: left ">< a id ="crate.annotation-crate "></ a > 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 > 462< tr >< td style ="text-align: left ">< a id ="crate.annotation-crate_features "></ a > 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 > 463< tr >< td style ="text-align: left ">< a id ="crate.annotation-data_glob "></ a > 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 > 464< tr >< td style ="text-align: left ">< a id ="crate.annotation-disable_pipelining "></ a > 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 > 465< tr >< td style ="text-align: left ">< a id ="crate.annotation-extra_aliased_targets "></ a > 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 ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: String -> String</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > {}</ code ></ td ></ tr > 466< tr >< td style ="text-align: left ">< a id ="crate.annotation-gen_all_binaries "></ a > 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 > 467< tr >< td style ="text-align: left ">< a id ="crate.annotation-gen_binaries "></ a > 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 > 468< tr >< td style ="text-align: left ">< a id ="crate.annotation-gen_build_script "></ a > 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 > 469< tr >< td style ="text-align: left ">< a id ="crate.annotation-override_target_bin "></ a > 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 ">< a href ="https://bazel.build/concepts/labels "> Label</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > None</ code ></ td ></ tr > 470< tr >< td style ="text-align: left ">< a id ="crate.annotation-override_target_build_script "></ a > 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 ">< a href ="https://bazel.build/concepts/labels "> Label</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > None</ code ></ td ></ tr > 471< tr >< td style ="text-align: left ">< a id ="crate.annotation-override_target_lib "></ a > 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 ">< a href ="https://bazel.build/concepts/labels "> Label</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > None</ code ></ td ></ tr > 472< tr >< td style ="text-align: left ">< a id ="crate.annotation-override_target_proc_macro "></ a > 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 ">< a href ="https://bazel.build/concepts/labels "> Label</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > None</ code ></ td ></ tr > 473< tr >< td style ="text-align: left ">< a id ="crate.annotation-patch_args "></ a > 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 > 474< tr >< td style ="text-align: left ">< a id ="crate.annotation-patch_tool "></ a > 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 > 475< tr >< td style ="text-align: left ">< a id ="crate.annotation-patches "></ a > 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 ">< a href ="https://bazel.build/concepts/labels "> List of labels</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > []</ code ></ td ></ tr > 476< tr >< td style ="text-align: left ">< a id ="crate.annotation-proc_macro_deps "></ a > 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 > 477< tr >< td style ="text-align: left ">< a id ="crate.annotation-repositories "></ a > 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 > 478< tr >< td style ="text-align: left ">< a id ="crate.annotation-rustc_env "></ a > 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 ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: String -> String</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > {}</ code ></ td ></ tr > 479< tr >< td style ="text-align: left ">< a id ="crate.annotation-rustc_env_files "></ a > 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 > 480< tr >< td style ="text-align: left ">< a id ="crate.annotation-rustc_flags "></ a > 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 > 481< tr >< td style ="text-align: left ">< a id ="crate.annotation-shallow_since "></ a > 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 > 482< tr >< td style ="text-align: left ">< a id ="crate.annotation-version "></ a > 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 > 483</ tbody ></ table > 484</ div > 485< p >< a id ="crate.from_cargo "></ a ></ p > 486< h3 id ="from_cargo ">< a class ="header "href ="#from_cargo "> from_cargo</ a ></ h3 > 487< p > Generates a repo @crates from a Cargo.toml / Cargo.lock pair.</ p > 488< p >< strong > Attributes</ strong ></ p > 489< div class ="table-wrapper ">< 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 > 490< tr >< td style ="text-align: left ">< a id ="crate.from_cargo-name "></ a > name</ td >< td style ="text-align: left "> The name of the repo to generate</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > "crates"</ code ></ td ></ tr > 491< tr >< td style ="text-align: left ">< a id ="crate.from_cargo-cargo_config "></ a > 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 ">< a href ="https://bazel.build/concepts/labels "> Label</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > None</ code ></ td ></ tr > 492< tr >< td style ="text-align: left ">< a id ="crate.from_cargo-cargo_lockfile "></ a > cargo_lockfile</ td >< td style ="text-align: left "> The path to an existing< code > Cargo.lock</ code > file</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels "> Label</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > None</ code ></ td ></ tr > 493< tr >< td style ="text-align: left ">< a id ="crate.from_cargo-generate_binaries "></ a > 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 > 494< tr >< td style ="text-align: left ">< a id ="crate.from_cargo-generate_build_scripts "></ a > 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 > 495< tr >< td style ="text-align: left ">< a id ="crate.from_cargo-manifests "></ a > manifests</ td >< td style ="text-align: left "> A list of Cargo manifests (< code > Cargo.toml</ code > files).</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels "> List of labels</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > []</ code ></ td ></ tr > 496< tr >< td style ="text-align: left ">< a id ="crate.from_cargo-splicing_config "></ a > 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 > 497< tr >< td style ="text-align: left ">< a id ="crate.from_cargo-supported_platform_triples "></ a > 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 > 498</ tbody ></ table > 499</ div > 500< p >< a id ="crate.from_specs "></ a ></ p > 501< h3 id ="from_specs ">< a class ="header "href ="#from_specs "> from_specs</ a ></ h3 > 502< p > Generates a repo @crates from the defined< code > spec</ code > tags.</ p > 503< p >< strong > Attributes</ strong ></ p > 504< div class ="table-wrapper ">< 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 > 505< tr >< td style ="text-align: left ">< a id ="crate.from_specs-name "></ a > name</ td >< td style ="text-align: left "> The name of the repo to generate.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > "crates"</ code ></ td ></ tr > 506< tr >< td style ="text-align: left ">< a id ="crate.from_specs-cargo_config "></ a > 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 ">< a href ="https://bazel.build/concepts/labels "> Label</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > None</ code ></ td ></ tr > 507< tr >< td style ="text-align: left ">< a id ="crate.from_specs-generate_binaries "></ a > 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 > 508< tr >< td style ="text-align: left ">< a id ="crate.from_specs-generate_build_scripts "></ a > 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 > 509< tr >< td style ="text-align: left ">< a id ="crate.from_specs-splicing_config "></ a > 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 > 510< tr >< td style ="text-align: left ">< a id ="crate.from_specs-supported_platform_triples "></ a > 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 > 511</ tbody ></ table > 512</ div > 513< p >< a id ="crate.spec "></ a ></ p > 514< h3 id ="spec ">< a class ="header "href ="#spec "> spec</ a ></ h3 > 515< p >< strong > Attributes</ strong ></ p > 516< div class ="table-wrapper ">< 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 > 517< tr >< td style ="text-align: left ">< a id ="crate.spec-artifact "></ a > 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 > 518< tr >< td style ="text-align: left ">< a id ="crate.spec-branch "></ a > 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 > 519< tr >< td style ="text-align: left ">< a id ="crate.spec-default_features "></ a > 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 > 520< tr >< td style ="text-align: left ">< a id ="crate.spec-features "></ a > 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 > 521< tr >< td style ="text-align: left ">< a id ="crate.spec-git "></ a > 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 > 522< tr >< td style ="text-align: left ">< a id ="crate.spec-lib "></ a > 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 > 523< tr >< td style ="text-align: left ">< a id ="crate.spec-package "></ a > 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 > 524< tr >< td style ="text-align: left ">< a id ="crate.spec-rev "></ a > 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 > 525< tr >< td style ="text-align: left ">< a id ="crate.spec-tag "></ a > 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 > 526< tr >< td style ="text-align: left ">< a id ="crate.spec-version "></ a > 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 > 527</ tbody ></ table > 528</ div > 529</ main > 530 531< nav class ="nav-wrapper "aria-label ="Page navigation "> 532<!-- Mobile navigation buttons --> 533< a rel ="prev "href ="external_crates.html "class ="mobile-nav-chapters previous "title ="Previous chapter "aria-label ="Previous chapter "aria-keyshortcuts ="Left "> 534< i class ="fa fa-angle-left "></ i > 535</ a > 536 537< a rel ="next prefetch "href ="crate_universe.html "class ="mobile-nav-chapters next "title ="Next chapter "aria-label ="Next chapter "aria-keyshortcuts ="Right "> 538< i class ="fa fa-angle-right "></ i > 539</ a > 540 541< div style ="clear: both "></ div > 542</ nav > 543</ div > 544</ div > 545 546< nav class ="nav-wide-wrapper "aria-label ="Page navigation "> 547< a rel ="prev "href ="external_crates.html "class ="nav-chapters previous "title ="Previous chapter "aria-label ="Previous chapter "aria-keyshortcuts ="Left "> 548< i class ="fa fa-angle-left "></ i > 549</ a > 550 551< a rel ="next prefetch "href ="crate_universe.html "class ="nav-chapters next "title ="Next chapter "aria-label ="Next chapter "aria-keyshortcuts ="Right "> 552< i class ="fa fa-angle-right "></ i > 553</ a > 554</ nav > 555 556</ div > 557 558 559 560 561< script > 562window . playground_copyable = true ; 563</ script > 564 565 566< script src ="elasticlunr.min.js "></ script > 567< script src ="mark.min.js "></ script > 568< script src ="searcher.js "></ script > 569 570< script src ="clipboard.min.js "></ script > 571< script src ="highlight.js "></ script > 572< script src ="book.js "></ script > 573 574<!-- Custom JS scripts --> 575 576 577</ div > 578</ body > 579</ html >