fork/rules_rust
git clone https://git.julia.blue/fork/rules_rust
482a21cf
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 > rust - 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 ="rust ">< a class ="header "href ="#rust "> Rust</ a ></ h1 > 160< ul > 161< li >< a href ="#rust_binary "> rust_binary</ a ></ li > 162< li >< a href ="#rust_library "> rust_library</ a ></ li > 163< li >< a href ="#rust_library_group "> rust_library_group</ a ></ li > 164< li >< a href ="#rust_static_library "> rust_static_library</ a ></ li > 165< li >< a href ="#rust_shared_library "> rust_shared_library</ a ></ li > 166< li >< a href ="#rust_proc_macro "> rust_proc_macro</ a ></ li > 167< li >< a href ="#rust_test "> rust_test</ a ></ li > 168< li >< a href ="#rust_test_suite "> rust_test_suite</ a ></ li > 169< li >< a href ="#error_format "> error_format</ a ></ li > 170< li >< a href ="#extra_rustc_flag "> extra_rustc_flag</ a ></ li > 171< li >< a href ="#extra_rustc_flags "> extra_rustc_flags</ a ></ li > 172< li >< a href ="#capture_clippy_output "> capture_clippy_output</ a ></ li > 173</ ul > 174< p >< a id ="capture_clippy_output "></ a ></ p > 175< h2 id ="capture_clippy_output ">< a class ="header "href ="#capture_clippy_output "> capture_clippy_output</ a ></ h2 > 176< pre > 177capture_clippy_output(< a href ="#capture_clippy_output-name "> name</ a > ) 178</ pre > 179< p > Control whether to print clippy output or store it to a file, using the configured error_format.</ p > 180< p >< strong > ATTRIBUTES</ strong ></ p > 181< 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 > 182< tr >< td style ="text-align: left ">< a id ="capture_clippy_output-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 183</ tbody ></ table > 184</ div > 185< p >< a id ="error_format "></ a ></ p > 186< h2 id ="error_format ">< a class ="header "href ="#error_format "> error_format</ a ></ h2 > 187< pre > 188error_format(< a href ="#error_format-name "> name</ a > ) 189</ pre > 190< p > Change the< a href ="https://doc.rust-lang.org/rustc/command-line-arguments.html#option-error-format "> --error-format</ a > flag from the command line with< code > --@rules_rust//rust/settings:error_format</ code > . See rustc documentation for valid values.</ p > 191< p >< strong > ATTRIBUTES</ strong ></ p > 192< 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 > 193< tr >< td style ="text-align: left ">< a id ="error_format-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 194</ tbody ></ table > 195</ div > 196< p >< a id ="extra_rustc_flag "></ a ></ p > 197< h2 id ="extra_rustc_flag ">< a class ="header "href ="#extra_rustc_flag "> extra_rustc_flag</ a ></ h2 > 198< pre > 199extra_rustc_flag(< a href ="#extra_rustc_flag-name "> name</ a > ) 200</ pre > 201< p > Add additional rustc_flag from the command line with< code > --@rules_rust//rust/settings:extra_rustc_flag</ code > . Multiple uses are accumulated and appended after the extra_rustc_flags.</ p > 202< p >< strong > ATTRIBUTES</ strong ></ p > 203< 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 > 204< tr >< td style ="text-align: left ">< a id ="extra_rustc_flag-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 205</ tbody ></ table > 206</ div > 207< p >< a id ="extra_rustc_flags "></ a ></ p > 208< h2 id ="extra_rustc_flags ">< a class ="header "href ="#extra_rustc_flags "> extra_rustc_flags</ a ></ h2 > 209< pre > 210extra_rustc_flags(< a href ="#extra_rustc_flags-name "> name</ a > ) 211</ pre > 212< p > Add additional rustc_flags from the command line with< code > --@rules_rust//rust/settings:extra_rustc_flags</ code > . This flag should only be used for flags that need to be applied across the entire build. For options that apply to individual crates, use the rustc_flags attribute on the individual crate's rule instead. NOTE: These flags not applied to the exec configuration (proc-macros, cargo_build_script, etc); use< code > --@rules_rust//rust/settings:extra_exec_rustc_flags</ code > to apply flags to the exec configuration.</ p > 213< p >< strong > ATTRIBUTES</ strong ></ p > 214< 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 > 215< tr >< td style ="text-align: left ">< a id ="extra_rustc_flags-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 216</ tbody ></ table > 217</ div > 218< p >< a id ="rust_binary "></ a ></ p > 219< h2 id ="rust_binary ">< a class ="header "href ="#rust_binary "> rust_binary</ a ></ h2 > 220< pre > 221rust_binary(< a href ="#rust_binary-name "> name</ a > ,< a href ="#rust_binary-deps "> deps</ a > ,< a href ="#rust_binary-srcs "> srcs</ a > ,< a href ="#rust_binary-data "> data</ a > ,< a href ="#rust_binary-aliases "> aliases</ a > ,< a href ="#rust_binary-alwayslink "> alwayslink</ a > ,< a href ="#rust_binary-binary_name "> binary_name</ a > ,< a href ="#rust_binary-compile_data "> compile_data</ a > ,< a href ="#rust_binary-crate_features "> crate_features</ a > , 222< a href ="#rust_binary-crate_name "> crate_name</ a > ,< a href ="#rust_binary-crate_root "> crate_root</ a > ,< a href ="#rust_binary-crate_type "> crate_type</ a > ,< a href ="#rust_binary-edition "> edition</ a > ,< a href ="#rust_binary-env "> env</ a > ,< a href ="#rust_binary-experimental_use_cc_common_link "> experimental_use_cc_common_link</ a > , 223< a href ="#rust_binary-linker_script "> linker_script</ a > ,< a href ="#rust_binary-malloc "> malloc</ a > ,< a href ="#rust_binary-out_binary "> out_binary</ a > ,< a href ="#rust_binary-platform "> platform</ a > ,< a href ="#rust_binary-proc_macro_deps "> proc_macro_deps</ a > ,< a href ="#rust_binary-rustc_env "> rustc_env</ a > ,< a href ="#rust_binary-rustc_env_files "> rustc_env_files</ a > , 224< a href ="#rust_binary-rustc_flags "> rustc_flags</ a > ,< a href ="#rust_binary-stamp "> stamp</ a > ,< a href ="#rust_binary-version "> version</ a > ) 225</ pre > 226< p > Builds a Rust binary crate.</ p > 227< p > Example:</ p > 228< p > Suppose you have the following directory structure for a Rust project with a 229library crate,< code > hello_lib</ code > , and a binary crate,< code > hello_world</ code > that uses the 230< code > hello_lib</ code > library:</ p > 231< pre >< code class ="language-output "> [workspace]/ 232 WORKSPACE 233 hello_lib/ 234 BUILD 235 src/ 236 lib.rs 237 hello_world/ 238 BUILD 239 src/ 240 main.rs 241</ code ></ pre > 242< p >< code > hello_lib/src/lib.rs</ code > :</ p > 243< pre >< pre class ="playground ">< code class ="language-rust ">< span class ="boring "> #![allow(unused)] 244</ span >< span class ="boring "> fn main() { 245</ span > pub struct Greeter { 246 greeting: String, 247} 248 249impl Greeter { 250 pub fn new(greeting: &str) -> Greeter { 251 Greeter { greeting: greeting.to_string(), } 252 } 253 254 pub fn greet(&self, thing: &str) { 255 println!("{} {}", &self.greeting, thing); 256 } 257} 258< span class ="boring "> }</ span ></ code ></ pre ></ pre > 259< p >< code > hello_lib/BUILD</ code > :</ p > 260< pre >< code class ="language-python "> package(default_visibility = ["//visibility:public"]) 261 262load("@rules_rust//rust:defs.bzl", "rust_library") 263 264rust_library( 265 name = "hello_lib", 266 srcs = ["src/lib.rs"], 267) 268</ code ></ pre > 269< p >< code > hello_world/src/main.rs</ code > :</ p > 270< pre >< pre class ="playground ">< code class ="language-rust "> extern crate hello_lib; 271 272fn main() { 273 let hello = hello_lib::Greeter::new("Hello"); 274 hello.greet("world"); 275}</ code ></ pre ></ pre > 276< p >< code > hello_world/BUILD</ code > :</ p > 277< pre >< code class ="language-python "> load("@rules_rust//rust:defs.bzl", "rust_binary") 278 279rust_binary( 280 name = "hello_world", 281 srcs = ["src/main.rs"], 282 deps = ["//hello_lib"], 283) 284</ code ></ pre > 285< p > Build and run< code > hello_world</ code > :</ p > 286< pre >< code > $ bazel run //hello_world 287INFO: Found 1 target... 288Target //examples/rust/hello_world:hello_world up-to-date: 289bazel-bin/examples/rust/hello_world/hello_world 290INFO: Elapsed time: 1.308s, Critical Path: 1.22s 291 292INFO: Running command line: bazel-bin/examples/rust/hello_world/hello_world 293Hello world 294</ code ></ pre > 295< p > On Windows, a PDB file containing debugging information is available under 296the key< code > pdb_file</ code > in< code > OutputGroupInfo</ code > . Similarly on macOS, a dSYM folder 297is available under the key< code > dsym_folder</ code > in< code > OutputGroupInfo</ code > .</ p > 298< p >< strong > ATTRIBUTES</ strong ></ p > 299< 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 > 300< tr >< td style ="text-align: left ">< a id ="rust_binary-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 301< tr >< td style ="text-align: left ">< a id ="rust_binary-deps "></ a > deps</ td >< td style ="text-align: left "> List of other libraries to be linked to this library target.< br >< br > These can be either other< code > rust_library</ code > targets or< code > cc_library</ code > targets if linking a native library.</ 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 > 302< tr >< td style ="text-align: left ">< a id ="rust_binary-srcs "></ a > srcs</ td >< td style ="text-align: left "> List of Rust< code > .rs</ code > source files used to build the library.< br >< br > If< code > srcs</ code > contains more than one file, then there must be a file either named< code > lib.rs</ code > . Otherwise,< code > crate_root</ code > must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</ td >< td style ="text-align: left ">< 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 > 303< tr >< td style ="text-align: left ">< a id ="rust_binary-data "></ a > data</ td >< td style ="text-align: left "> List of files used by this rule at compile time and runtime.< br >< br > If including data at compile time with include_str!() and similar, prefer< code > compile_data</ code > over< code > data</ code > , to prevent the data also being included in the runfiles.</ 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 > 304< tr >< td style ="text-align: left ">< a id ="rust_binary-aliases "></ a > aliases</ td >< td style ="text-align: left "> Remap crates to a new name or moniker for linkage to this target< br >< br > These are other< code > rust_library</ code > targets and will be presented as the new name given.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: Label -> String</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > {}</ code ></ td ></ tr > 305< tr >< td style ="text-align: left ">< a id ="rust_binary-alwayslink "></ a > alwayslink</ td >< td style ="text-align: left "> If 1, any binary that depends (directly or indirectly) on this library will link in all the object files even if some contain no symbols referenced by the binary.< br >< br > This attribute is used by the C++ Starlark API when passing CcInfo providers.</ 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 > 306< tr >< td style ="text-align: left ">< a id ="rust_binary-binary_name "></ a > binary_name</ td >< td style ="text-align: left "> Override the resulting binary file name. By default, the binary file will be named using the< code > name</ code > attribute on this rule, however sometimes that is not deseriable.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 307< tr >< td style ="text-align: left ">< a id ="rust_binary-compile_data "></ a > compile_data</ td >< td style ="text-align: left "> List of files used by this rule at compile time.< br >< br > This attribute can be used to specify any data files that are embedded into the library, such as via the< a href ="https://doc.rust-lang.org/std/macro.include_str!.html ">< code > include_str!</ code ></ a > macro.</ 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 > 308< tr >< td style ="text-align: left ">< a id ="rust_binary-crate_features "></ a > crate_features</ td >< td style ="text-align: left "> List of features to enable for this crate.< br >< br > Features are defined in the code using the< code > #[cfg(feature = "foo")]</ code > configuration option. The features listed here will be passed to< code > rustc</ code > with< code > --cfg feature="${feature_name}"</ code > flags.</ 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 > 309< tr >< td style ="text-align: left ">< a id ="rust_binary-crate_name "></ a > crate_name</ td >< td style ="text-align: left "> Crate name to use for this target.< br >< br > This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 310< tr >< td style ="text-align: left ">< a id ="rust_binary-crate_root "></ a > crate_root</ td >< td style ="text-align: left "> The file that will be passed to< code > rustc</ code > to be used for building this crate.< br >< br > If< code > crate_root</ code > is not set, then this rule will look for a< code > lib.rs</ code > file (or< code > main.rs</ code > for rust_binary) or the single file in< code > srcs</ code > if< code > srcs</ code > contains only one 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 > 311< tr >< td style ="text-align: left ">< a id ="rust_binary-crate_type "></ a > crate_type</ td >< td style ="text-align: left "> Crate type that will be passed to< code > rustc</ code > to be used for building this crate.< br >< br > This option is a temporary workaround and should be used only when building for WebAssembly targets (//rust/platform:wasi and //rust/platform:wasm).</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > "bin"</ code ></ td ></ tr > 312< tr >< td style ="text-align: left ">< a id ="rust_binary-edition "></ a > edition</ td >< td style ="text-align: left "> The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 313< tr >< td style ="text-align: left ">< a id ="rust_binary-env "></ a > env</ td >< td style ="text-align: left "> Specifies additional environment variables to set when the target is executed by bazel run. Values are subject to< code > $(rootpath)</ code > ,< code > $(execpath)</ code > , location, and< a href ="https://docs.bazel.build/versions/master/be/make-variables.html "> "Make variable"</ a > substitution.< br >< br > Execpath returns absolute path, and in order to be able to construct the absolute path we need to wrap the test binary in a launcher. Using a launcher comes with complications, such as more complicated debugger attachment.</ td >< td style ="text-align: left ">< 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 > 314< tr >< td style ="text-align: left ">< a id ="rust_binary-experimental_use_cc_common_link "></ a > experimental_use_cc_common_link</ td >< td style ="text-align: left "> Whether to use cc_common.link to link rust binaries. Possible values: [-1, 0, 1]. -1 means use the value of the toolchain.experimental_use_cc_common_link boolean build setting to determine. 0 means do not use cc_common.link (use rustc instead). 1 means use cc_common.link.</ td >< td style ="text-align: left "> Integer</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > -1</ code ></ td ></ tr > 315< tr >< td style ="text-align: left ">< a id ="rust_binary-linker_script "></ a > linker_script</ td >< td style ="text-align: left "> Link script to forward into linker via rustc options.</ 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 > 316< tr >< td style ="text-align: left ">< a id ="rust_binary-malloc "></ a > malloc</ td >< td style ="text-align: left "> Override the default dependency on< code > malloc</ code > .< br >< br > By default, Rust binaries linked with cc_common.link are linked against< code > @bazel_tools//tools/cpp:malloc"</ code > , which is an empty library and the resulting binary will use libc's< code > malloc</ code > . This label must refer to a< code > cc_library</ code > rule.</ 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 > "@bazel_tools//tools/cpp:malloc"</ code ></ td ></ tr > 317< tr >< td style ="text-align: left ">< a id ="rust_binary-out_binary "></ a > out_binary</ td >< td style ="text-align: left "> Force a target, regardless of it's< code > crate_type</ code > , to always mark the file as executable. This attribute is only used to support wasm targets but is expected to be removed following a resolution to https://github.com/bazelbuild/rules_rust/issues/771.</ td >< td style ="text-align: left "> Boolean</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > False</ code ></ td ></ tr > 318< tr >< td style ="text-align: left ">< a id ="rust_binary-platform "></ a > platform</ td >< td style ="text-align: left "> Optional platform to transition the binary to.</ 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 > 319< tr >< td style ="text-align: left ">< a id ="rust_binary-proc_macro_deps "></ a > proc_macro_deps</ td >< td style ="text-align: left "> List of< code > rust_proc_macro</ code > targets used to help build this library target.</ 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 > 320< tr >< td style ="text-align: left ">< a id ="rust_binary-rustc_env "></ a > rustc_env</ td >< td style ="text-align: left "> Dictionary of additional< code > "key": "value"</ code > environment variables to set for rustc.< br >< br > rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</ td >< td style ="text-align: left ">< 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 > 321< tr >< td style ="text-align: left ">< a id ="rust_binary-rustc_env_files "></ a > rustc_env_files</ td >< td style ="text-align: left "> Files containing additional environment variables to set for rustc.< br >< br > These files should contain a single variable per line, of format< code > NAME=value</ code > , and newlines may be included in a value by ending a line with a trailing back-slash (< code > \\</ code > ).< br >< br > The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.< br >< br > Note that the variables here are subject to< a href ="https://docs.bazel.build/versions/main/user-manual.html#workspace_status "> workspace status</ a > stamping should the< code > stamp</ code > attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g.< code > NAME={WORKSPACE_STATUS_VARIABLE}</ code > .</ 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 > 322< tr >< td style ="text-align: left ">< a id ="rust_binary-rustc_flags "></ a > rustc_flags</ td >< td style ="text-align: left "> List of compiler flags passed to< code > rustc</ code > .< br >< br > These strings are subject to Make variable expansion for predefined source/output path variables like< code > $location</ code > ,< code > $execpath</ code > , and< code > $rootpath</ code > . This expansion is useful if you wish to pass a generated file of arguments to rustc:< code > @$(location //package:target)</ code > .</ 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 > 323< tr >< td style ="text-align: left ">< a id ="rust_binary-stamp "></ a > stamp</ td >< td style ="text-align: left "> Whether to encode build information into the< code > Rustc</ code > action. Possible values:< br >< br > -< code > stamp = 1</ code > : Always stamp the build information into the< code > Rustc</ code > action, even in< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --nostamp</ a > builds. This setting should be avoided, since it potentially kills remote caching for the target and any downstream actions that depend on it.< br >< br > -< code > stamp = 0</ code > : Always replace build information by constant values. This gives good build result caching.< br >< br > -< code > stamp = -1</ code > : Embedding of build information is controlled by the< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --[no]stamp</ a > flag.< br >< br > Stamped targets are not rebuilt unless their dependencies change.< br >< br > For example if a< code > rust_library</ code > is stamped, and a< code > rust_binary</ code > depends on that library, the stamped library won't be rebuilt when we change sources of the< code > rust_binary</ code > . This is different from how< a href ="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp ">< code > cc_library.linkstamps</ code ></ a > behaves.</ td >< td style ="text-align: left "> Integer</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > -1</ code ></ td ></ tr > 324< tr >< td style ="text-align: left ">< a id ="rust_binary-version "></ a > version</ td >< td style ="text-align: left "> A version to inject in the cargo environment variable.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > "0.0.0"</ code ></ td ></ tr > 325</ tbody ></ table > 326</ div > 327< p >< a id ="rust_library "></ a ></ p > 328< h2 id ="rust_library ">< a class ="header "href ="#rust_library "> rust_library</ a ></ h2 > 329< pre > 330rust_library(< a href ="#rust_library-name "> name</ a > ,< a href ="#rust_library-deps "> deps</ a > ,< a href ="#rust_library-srcs "> srcs</ a > ,< a href ="#rust_library-data "> data</ a > ,< a href ="#rust_library-aliases "> aliases</ a > ,< a href ="#rust_library-alwayslink "> alwayslink</ a > ,< a href ="#rust_library-compile_data "> compile_data</ a > ,< a href ="#rust_library-crate_features "> crate_features</ a > ,< a href ="#rust_library-crate_name "> crate_name</ a > , 331< a href ="#rust_library-crate_root "> crate_root</ a > ,< a href ="#rust_library-disable_pipelining "> disable_pipelining</ a > ,< a href ="#rust_library-edition "> edition</ a > ,< a href ="#rust_library-proc_macro_deps "> proc_macro_deps</ a > ,< a href ="#rust_library-rustc_env "> rustc_env</ a > ,< a href ="#rust_library-rustc_env_files "> rustc_env_files</ a > , 332< a href ="#rust_library-rustc_flags "> rustc_flags</ a > ,< a href ="#rust_library-stamp "> stamp</ a > ,< a href ="#rust_library-version "> version</ a > ) 333</ pre > 334< p > Builds a Rust library crate.</ p > 335< p > Example:</ p > 336< p > Suppose you have the following directory structure for a simple Rust library crate:</ p > 337< pre >< code class ="language-output "> [workspace]/ 338 WORKSPACE 339 hello_lib/ 340 BUILD 341 src/ 342 greeter.rs 343 lib.rs 344</ code ></ pre > 345< p >< code > hello_lib/src/greeter.rs</ code > :</ p > 346< pre >< pre class ="playground ">< code class ="language-rust ">< span class ="boring "> #![allow(unused)] 347</ span >< span class ="boring "> fn main() { 348</ span > pub struct Greeter { 349 greeting: String, 350} 351 352impl Greeter { 353 pub fn new(greeting: &str) -> Greeter { 354 Greeter { greeting: greeting.to_string(), } 355 } 356 357 pub fn greet(&self, thing: &str) { 358 println!("{} {}", &self.greeting, thing); 359 } 360} 361< span class ="boring "> }</ span ></ code ></ pre ></ pre > 362< p >< code > hello_lib/src/lib.rs</ code > :</ p > 363< pre >< pre class ="playground ">< code class ="language-rust ">< span class ="boring "> #![allow(unused)] 364</ span >< span class ="boring "> fn main() { 365</ span > pub mod greeter; 366< span class ="boring "> }</ span ></ code ></ pre ></ pre > 367< p >< code > hello_lib/BUILD</ code > :</ p > 368< pre >< code class ="language-python "> package(default_visibility = ["//visibility:public"]) 369 370load("@rules_rust//rust:defs.bzl", "rust_library") 371 372rust_library( 373 name = "hello_lib", 374 srcs = [ 375 "src/greeter.rs", 376 "src/lib.rs", 377 ], 378) 379</ code ></ pre > 380< p > Build the library:</ p > 381< pre >< code class ="language-output "> $ bazel build //hello_lib 382INFO: Found 1 target... 383Target //examples/rust/hello_lib:hello_lib up-to-date: 384bazel-bin/examples/rust/hello_lib/libhello_lib.rlib 385INFO: Elapsed time: 1.245s, Critical Path: 1.01s 386</ code ></ pre > 387< p >< strong > ATTRIBUTES</ strong ></ p > 388< 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 > 389< tr >< td style ="text-align: left ">< a id ="rust_library-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 390< tr >< td style ="text-align: left ">< a id ="rust_library-deps "></ a > deps</ td >< td style ="text-align: left "> List of other libraries to be linked to this library target.< br >< br > These can be either other< code > rust_library</ code > targets or< code > cc_library</ code > targets if linking a native library.</ 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 > 391< tr >< td style ="text-align: left ">< a id ="rust_library-srcs "></ a > srcs</ td >< td style ="text-align: left "> List of Rust< code > .rs</ code > source files used to build the library.< br >< br > If< code > srcs</ code > contains more than one file, then there must be a file either named< code > lib.rs</ code > . Otherwise,< code > crate_root</ code > must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</ td >< td style ="text-align: left ">< 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 > 392< tr >< td style ="text-align: left ">< a id ="rust_library-data "></ a > data</ td >< td style ="text-align: left "> List of files used by this rule at compile time and runtime.< br >< br > If including data at compile time with include_str!() and similar, prefer< code > compile_data</ code > over< code > data</ code > , to prevent the data also being included in the runfiles.</ 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 > 393< tr >< td style ="text-align: left ">< a id ="rust_library-aliases "></ a > aliases</ td >< td style ="text-align: left "> Remap crates to a new name or moniker for linkage to this target< br >< br > These are other< code > rust_library</ code > targets and will be presented as the new name given.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: Label -> String</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > {}</ code ></ td ></ tr > 394< tr >< td style ="text-align: left ">< a id ="rust_library-alwayslink "></ a > alwayslink</ td >< td style ="text-align: left "> If 1, any binary that depends (directly or indirectly) on this library will link in all the object files even if some contain no symbols referenced by the binary.< br >< br > This attribute is used by the C++ Starlark API when passing CcInfo providers.</ 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 > 395< tr >< td style ="text-align: left ">< a id ="rust_library-compile_data "></ a > compile_data</ td >< td style ="text-align: left "> List of files used by this rule at compile time.< br >< br > This attribute can be used to specify any data files that are embedded into the library, such as via the< a href ="https://doc.rust-lang.org/std/macro.include_str!.html ">< code > include_str!</ code ></ a > macro.</ 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 > 396< tr >< td style ="text-align: left ">< a id ="rust_library-crate_features "></ a > crate_features</ td >< td style ="text-align: left "> List of features to enable for this crate.< br >< br > Features are defined in the code using the< code > #[cfg(feature = "foo")]</ code > configuration option. The features listed here will be passed to< code > rustc</ code > with< code > --cfg feature="${feature_name}"</ code > flags.</ 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 > 397< tr >< td style ="text-align: left ">< a id ="rust_library-crate_name "></ a > crate_name</ td >< td style ="text-align: left "> Crate name to use for this target.< br >< br > This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 398< tr >< td style ="text-align: left ">< a id ="rust_library-crate_root "></ a > crate_root</ td >< td style ="text-align: left "> The file that will be passed to< code > rustc</ code > to be used for building this crate.< br >< br > If< code > crate_root</ code > is not set, then this rule will look for a< code > lib.rs</ code > file (or< code > main.rs</ code > for rust_binary) or the single file in< code > srcs</ code > if< code > srcs</ code > contains only one 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 > 399< tr >< td style ="text-align: left ">< a id ="rust_library-disable_pipelining "></ a > disable_pipelining</ td >< td style ="text-align: left "> Disables pipelining for this rule if it is globally enabled. This will cause this rule to not produce a< code > .rmeta</ code > file and all the dependent crates will instead use the< code > .rlib</ code > file.</ 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 > 400< tr >< td style ="text-align: left ">< a id ="rust_library-edition "></ a > edition</ td >< td style ="text-align: left "> The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 401< tr >< td style ="text-align: left ">< a id ="rust_library-proc_macro_deps "></ a > proc_macro_deps</ td >< td style ="text-align: left "> List of< code > rust_proc_macro</ code > targets used to help build this library target.</ 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 > 402< tr >< td style ="text-align: left ">< a id ="rust_library-rustc_env "></ a > rustc_env</ td >< td style ="text-align: left "> Dictionary of additional< code > "key": "value"</ code > environment variables to set for rustc.< br >< br > rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</ td >< td style ="text-align: left ">< 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 > 403< tr >< td style ="text-align: left ">< a id ="rust_library-rustc_env_files "></ a > rustc_env_files</ td >< td style ="text-align: left "> Files containing additional environment variables to set for rustc.< br >< br > These files should contain a single variable per line, of format< code > NAME=value</ code > , and newlines may be included in a value by ending a line with a trailing back-slash (< code > \\</ code > ).< br >< br > The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.< br >< br > Note that the variables here are subject to< a href ="https://docs.bazel.build/versions/main/user-manual.html#workspace_status "> workspace status</ a > stamping should the< code > stamp</ code > attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g.< code > NAME={WORKSPACE_STATUS_VARIABLE}</ code > .</ 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 > 404< tr >< td style ="text-align: left ">< a id ="rust_library-rustc_flags "></ a > rustc_flags</ td >< td style ="text-align: left "> List of compiler flags passed to< code > rustc</ code > .< br >< br > These strings are subject to Make variable expansion for predefined source/output path variables like< code > $location</ code > ,< code > $execpath</ code > , and< code > $rootpath</ code > . This expansion is useful if you wish to pass a generated file of arguments to rustc:< code > @$(location //package:target)</ code > .</ 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 > 405< tr >< td style ="text-align: left ">< a id ="rust_library-stamp "></ a > stamp</ td >< td style ="text-align: left "> Whether to encode build information into the< code > Rustc</ code > action. Possible values:< br >< br > -< code > stamp = 1</ code > : Always stamp the build information into the< code > Rustc</ code > action, even in< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --nostamp</ a > builds. This setting should be avoided, since it potentially kills remote caching for the target and any downstream actions that depend on it.< br >< br > -< code > stamp = 0</ code > : Always replace build information by constant values. This gives good build result caching.< br >< br > -< code > stamp = -1</ code > : Embedding of build information is controlled by the< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --[no]stamp</ a > flag.< br >< br > Stamped targets are not rebuilt unless their dependencies change.< br >< br > For example if a< code > rust_library</ code > is stamped, and a< code > rust_binary</ code > depends on that library, the stamped library won't be rebuilt when we change sources of the< code > rust_binary</ code > . This is different from how< a href ="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp ">< code > cc_library.linkstamps</ code ></ a > behaves.</ td >< td style ="text-align: left "> Integer</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > 0</ code ></ td ></ tr > 406< tr >< td style ="text-align: left ">< a id ="rust_library-version "></ a > version</ td >< td style ="text-align: left "> A version to inject in the cargo environment variable.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > "0.0.0"</ code ></ td ></ tr > 407</ tbody ></ table > 408</ div > 409< p >< a id ="rust_library_group "></ a ></ p > 410< h2 id ="rust_library_group ">< a class ="header "href ="#rust_library_group "> rust_library_group</ a ></ h2 > 411< pre > 412rust_library_group(< a href ="#rust_library_group-name "> name</ a > ,< a href ="#rust_library_group-deps "> deps</ a > ) 413</ pre > 414< p > Functions as an alias for a set of dependencies.</ p > 415< p > Specifically, the following are equivalent:</ p > 416< pre >< code class ="language-starlark "> rust_library_group( 417 name = "crate_group", 418 deps = [ 419 ":crate1", 420 ":crate2", 421 ], 422) 423 424rust_library( 425 name = "foobar", 426 deps = [":crate_group"], 427 ... 428) 429</ code ></ pre > 430< p > and</ p > 431< pre >< code class ="language-starlark "> rust_library( 432 name = "foobar", 433 deps = [ 434 ":crate1", 435 ":crate2", 436 ], 437 ... 438) 439</ code ></ pre > 440< p >< strong > ATTRIBUTES</ strong ></ p > 441< 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 > 442< tr >< td style ="text-align: left ">< a id ="rust_library_group-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 443< tr >< td style ="text-align: left ">< a id ="rust_library_group-deps "></ a > deps</ td >< td style ="text-align: left "> Other dependencies to forward through this crate group.</ 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 > 444</ tbody ></ table > 445</ div > 446< p >< a id ="rust_proc_macro "></ a ></ p > 447< h2 id ="rust_proc_macro ">< a class ="header "href ="#rust_proc_macro "> rust_proc_macro</ a ></ h2 > 448< pre > 449rust_proc_macro(< a href ="#rust_proc_macro-name "> name</ a > ,< a href ="#rust_proc_macro-deps "> deps</ a > ,< a href ="#rust_proc_macro-srcs "> srcs</ a > ,< a href ="#rust_proc_macro-data "> data</ a > ,< a href ="#rust_proc_macro-aliases "> aliases</ a > ,< a href ="#rust_proc_macro-alwayslink "> alwayslink</ a > ,< a href ="#rust_proc_macro-compile_data "> compile_data</ a > ,< a href ="#rust_proc_macro-crate_features "> crate_features</ a > , 450< a href ="#rust_proc_macro-crate_name "> crate_name</ a > ,< a href ="#rust_proc_macro-crate_root "> crate_root</ a > ,< a href ="#rust_proc_macro-edition "> edition</ a > ,< a href ="#rust_proc_macro-proc_macro_deps "> proc_macro_deps</ a > ,< a href ="#rust_proc_macro-rustc_env "> rustc_env</ a > ,< a href ="#rust_proc_macro-rustc_env_files "> rustc_env_files</ a > , 451< a href ="#rust_proc_macro-rustc_flags "> rustc_flags</ a > ,< a href ="#rust_proc_macro-stamp "> stamp</ a > ,< a href ="#rust_proc_macro-version "> version</ a > ) 452</ pre > 453< p > Builds a Rust proc-macro crate.</ p > 454< p >< strong > ATTRIBUTES</ strong ></ p > 455< 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 > 456< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 457< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-deps "></ a > deps</ td >< td style ="text-align: left "> List of other libraries to be linked to this library target.< br >< br > These can be either other< code > rust_library</ code > targets or< code > cc_library</ code > targets if linking a native library.</ 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 ="rust_proc_macro-srcs "></ a > srcs</ td >< td style ="text-align: left "> List of Rust< code > .rs</ code > source files used to build the library.< br >< br > If< code > srcs</ code > contains more than one file, then there must be a file either named< code > lib.rs</ code > . Otherwise,< code > crate_root</ code > must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</ td >< td style ="text-align: left ">< 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 > 459< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-data "></ a > data</ td >< td style ="text-align: left "> List of files used by this rule at compile time and runtime.< br >< br > If including data at compile time with include_str!() and similar, prefer< code > compile_data</ code > over< code > data</ code > , to prevent the data also being included in the runfiles.</ 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 > 460< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-aliases "></ a > aliases</ td >< td style ="text-align: left "> Remap crates to a new name or moniker for linkage to this target< br >< br > These are other< code > rust_library</ code > targets and will be presented as the new name given.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: Label -> String</ a ></ 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 ="rust_proc_macro-alwayslink "></ a > alwayslink</ td >< td style ="text-align: left "> If 1, any binary that depends (directly or indirectly) on this library will link in all the object files even if some contain no symbols referenced by the binary.< br >< br > This attribute is used by the C++ Starlark API when passing CcInfo providers.</ 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 > 462< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-compile_data "></ a > compile_data</ td >< td style ="text-align: left "> List of files used by this rule at compile time.< br >< br > This attribute can be used to specify any data files that are embedded into the library, such as via the< a href ="https://doc.rust-lang.org/std/macro.include_str!.html ">< code > include_str!</ code ></ a > macro.</ 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 > 463< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-crate_features "></ a > crate_features</ td >< td style ="text-align: left "> List of features to enable for this crate.< br >< br > Features are defined in the code using the< code > #[cfg(feature = "foo")]</ code > configuration option. The features listed here will be passed to< code > rustc</ code > with< code > --cfg feature="${feature_name}"</ code > flags.</ 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 ="rust_proc_macro-crate_name "></ a > crate_name</ td >< td style ="text-align: left "> Crate name to use for this target.< br >< br > This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 465< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-crate_root "></ a > crate_root</ td >< td style ="text-align: left "> The file that will be passed to< code > rustc</ code > to be used for building this crate.< br >< br > If< code > crate_root</ code > is not set, then this rule will look for a< code > lib.rs</ code > file (or< code > main.rs</ code > for rust_binary) or the single file in< code > srcs</ code > if< code > srcs</ code > contains only one 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 > 466< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-edition "></ a > edition</ td >< td style ="text-align: left "> The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 467< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-proc_macro_deps "></ a > proc_macro_deps</ td >< td style ="text-align: left "> List of< code > rust_proc_macro</ code > targets used to help build this library target.</ 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 > 468< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-rustc_env "></ a > rustc_env</ td >< td style ="text-align: left "> Dictionary of additional< code > "key": "value"</ code > environment variables to set for rustc.< br >< br > rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</ td >< td style ="text-align: left ">< 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 > 469< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-rustc_env_files "></ a > rustc_env_files</ td >< td style ="text-align: left "> Files containing additional environment variables to set for rustc.< br >< br > These files should contain a single variable per line, of format< code > NAME=value</ code > , and newlines may be included in a value by ending a line with a trailing back-slash (< code > \\</ code > ).< br >< br > The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.< br >< br > Note that the variables here are subject to< a href ="https://docs.bazel.build/versions/main/user-manual.html#workspace_status "> workspace status</ a > stamping should the< code > stamp</ code > attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g.< code > NAME={WORKSPACE_STATUS_VARIABLE}</ code > .</ 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 > 470< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-rustc_flags "></ a > rustc_flags</ td >< td style ="text-align: left "> List of compiler flags passed to< code > rustc</ code > .< br >< br > These strings are subject to Make variable expansion for predefined source/output path variables like< code > $location</ code > ,< code > $execpath</ code > , and< code > $rootpath</ code > . This expansion is useful if you wish to pass a generated file of arguments to rustc:< code > @$(location //package:target)</ code > .</ 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 > 471< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-stamp "></ a > stamp</ td >< td style ="text-align: left "> Whether to encode build information into the< code > Rustc</ code > action. Possible values:< br >< br > -< code > stamp = 1</ code > : Always stamp the build information into the< code > Rustc</ code > action, even in< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --nostamp</ a > builds. This setting should be avoided, since it potentially kills remote caching for the target and any downstream actions that depend on it.< br >< br > -< code > stamp = 0</ code > : Always replace build information by constant values. This gives good build result caching.< br >< br > -< code > stamp = -1</ code > : Embedding of build information is controlled by the< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --[no]stamp</ a > flag.< br >< br > Stamped targets are not rebuilt unless their dependencies change.< br >< br > For example if a< code > rust_library</ code > is stamped, and a< code > rust_binary</ code > depends on that library, the stamped library won't be rebuilt when we change sources of the< code > rust_binary</ code > . This is different from how< a href ="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp ">< code > cc_library.linkstamps</ code ></ a > behaves.</ td >< td style ="text-align: left "> Integer</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > 0</ code ></ td ></ tr > 472< tr >< td style ="text-align: left ">< a id ="rust_proc_macro-version "></ a > version</ td >< td style ="text-align: left "> A version to inject in the cargo environment variable.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > "0.0.0"</ code ></ td ></ tr > 473</ tbody ></ table > 474</ div > 475< p >< a id ="rust_shared_library "></ a ></ p > 476< h2 id ="rust_shared_library ">< a class ="header "href ="#rust_shared_library "> rust_shared_library</ a ></ h2 > 477< pre > 478rust_shared_library(< a href ="#rust_shared_library-name "> name</ a > ,< a href ="#rust_shared_library-deps "> deps</ a > ,< a href ="#rust_shared_library-srcs "> srcs</ a > ,< a href ="#rust_shared_library-data "> data</ a > ,< a href ="#rust_shared_library-aliases "> aliases</ a > ,< a href ="#rust_shared_library-alwayslink "> alwayslink</ a > ,< a href ="#rust_shared_library-compile_data "> compile_data</ a > ,< a href ="#rust_shared_library-crate_features "> crate_features</ a > , 479< a href ="#rust_shared_library-crate_name "> crate_name</ a > ,< a href ="#rust_shared_library-crate_root "> crate_root</ a > ,< a href ="#rust_shared_library-edition "> edition</ a > ,< a href ="#rust_shared_library-experimental_use_cc_common_link "> experimental_use_cc_common_link</ a > ,< a href ="#rust_shared_library-malloc "> malloc</ a > , 480< a href ="#rust_shared_library-platform "> platform</ a > ,< a href ="#rust_shared_library-proc_macro_deps "> proc_macro_deps</ a > ,< a href ="#rust_shared_library-rustc_env "> rustc_env</ a > ,< a href ="#rust_shared_library-rustc_env_files "> rustc_env_files</ a > ,< a href ="#rust_shared_library-rustc_flags "> rustc_flags</ a > ,< a href ="#rust_shared_library-stamp "> stamp</ a > , 481< a href ="#rust_shared_library-version "> version</ a > ) 482</ pre > 483< p > Builds a Rust shared library.</ p > 484< p > This shared library will contain all transitively reachable crates and native objects. 485It is meant to be used when producing an artifact that is then consumed by some other build system 486(for example to produce a shared library that Python program links against).</ p > 487< p > This rule provides CcInfo, so it can be used everywhere Bazel expects< code > rules_cc</ code > .</ p > 488< p > When building the whole binary in Bazel, use< code > rust_library</ code > instead.</ p > 489< p >< strong > ATTRIBUTES</ strong ></ p > 490< 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 > 491< tr >< td style ="text-align: left ">< a id ="rust_shared_library-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 492< tr >< td style ="text-align: left ">< a id ="rust_shared_library-deps "></ a > deps</ td >< td style ="text-align: left "> List of other libraries to be linked to this library target.< br >< br > These can be either other< code > rust_library</ code > targets or< code > cc_library</ code > targets if linking a native library.</ 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 > 493< tr >< td style ="text-align: left ">< a id ="rust_shared_library-srcs "></ a > srcs</ td >< td style ="text-align: left "> List of Rust< code > .rs</ code > source files used to build the library.< br >< br > If< code > srcs</ code > contains more than one file, then there must be a file either named< code > lib.rs</ code > . Otherwise,< code > crate_root</ code > must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</ td >< td style ="text-align: left ">< 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 > 494< tr >< td style ="text-align: left ">< a id ="rust_shared_library-data "></ a > data</ td >< td style ="text-align: left "> List of files used by this rule at compile time and runtime.< br >< br > If including data at compile time with include_str!() and similar, prefer< code > compile_data</ code > over< code > data</ code > , to prevent the data also being included in the runfiles.</ 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 > 495< tr >< td style ="text-align: left ">< a id ="rust_shared_library-aliases "></ a > aliases</ td >< td style ="text-align: left "> Remap crates to a new name or moniker for linkage to this target< br >< br > These are other< code > rust_library</ code > targets and will be presented as the new name given.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: Label -> String</ 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 ="rust_shared_library-alwayslink "></ a > alwayslink</ td >< td style ="text-align: left "> If 1, any binary that depends (directly or indirectly) on this library will link in all the object files even if some contain no symbols referenced by the binary.< br >< br > This attribute is used by the C++ Starlark API when passing CcInfo providers.</ 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 > 497< tr >< td style ="text-align: left ">< a id ="rust_shared_library-compile_data "></ a > compile_data</ td >< td style ="text-align: left "> List of files used by this rule at compile time.< br >< br > This attribute can be used to specify any data files that are embedded into the library, such as via the< a href ="https://doc.rust-lang.org/std/macro.include_str!.html ">< code > include_str!</ code ></ a > macro.</ 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 > 498< tr >< td style ="text-align: left ">< a id ="rust_shared_library-crate_features "></ a > crate_features</ td >< td style ="text-align: left "> List of features to enable for this crate.< br >< br > Features are defined in the code using the< code > #[cfg(feature = "foo")]</ code > configuration option. The features listed here will be passed to< code > rustc</ code > with< code > --cfg feature="${feature_name}"</ code > flags.</ 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 > 499< tr >< td style ="text-align: left ">< a id ="rust_shared_library-crate_name "></ a > crate_name</ td >< td style ="text-align: left "> Crate name to use for this target.< br >< br > This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 500< tr >< td style ="text-align: left ">< a id ="rust_shared_library-crate_root "></ a > crate_root</ td >< td style ="text-align: left "> The file that will be passed to< code > rustc</ code > to be used for building this crate.< br >< br > If< code > crate_root</ code > is not set, then this rule will look for a< code > lib.rs</ code > file (or< code > main.rs</ code > for rust_binary) or the single file in< code > srcs</ code > if< code > srcs</ code > contains only one 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 > 501< tr >< td style ="text-align: left ">< a id ="rust_shared_library-edition "></ a > edition</ td >< td style ="text-align: left "> The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 502< tr >< td style ="text-align: left ">< a id ="rust_shared_library-experimental_use_cc_common_link "></ a > experimental_use_cc_common_link</ td >< td style ="text-align: left "> Whether to use cc_common.link to link rust binaries. Possible values: [-1, 0, 1]. -1 means use the value of the toolchain.experimental_use_cc_common_link boolean build setting to determine. 0 means do not use cc_common.link (use rustc instead). 1 means use cc_common.link.</ td >< td style ="text-align: left "> Integer</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > -1</ code ></ td ></ tr > 503< tr >< td style ="text-align: left ">< a id ="rust_shared_library-malloc "></ a > malloc</ td >< td style ="text-align: left "> Override the default dependency on< code > malloc</ code > .< br >< br > By default, Rust binaries linked with cc_common.link are linked against< code > @bazel_tools//tools/cpp:malloc"</ code > , which is an empty library and the resulting binary will use libc's< code > malloc</ code > . This label must refer to a< code > cc_library</ code > rule.</ 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 > "@bazel_tools//tools/cpp:malloc"</ code ></ td ></ tr > 504< tr >< td style ="text-align: left ">< a id ="rust_shared_library-platform "></ a > platform</ td >< td style ="text-align: left "> Optional platform to transition the shared library to.</ 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 > 505< tr >< td style ="text-align: left ">< a id ="rust_shared_library-proc_macro_deps "></ a > proc_macro_deps</ td >< td style ="text-align: left "> List of< code > rust_proc_macro</ code > targets used to help build this library target.</ 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 > 506< tr >< td style ="text-align: left ">< a id ="rust_shared_library-rustc_env "></ a > rustc_env</ td >< td style ="text-align: left "> Dictionary of additional< code > "key": "value"</ code > environment variables to set for rustc.< br >< br > rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</ td >< td style ="text-align: left ">< 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 > 507< tr >< td style ="text-align: left ">< a id ="rust_shared_library-rustc_env_files "></ a > rustc_env_files</ td >< td style ="text-align: left "> Files containing additional environment variables to set for rustc.< br >< br > These files should contain a single variable per line, of format< code > NAME=value</ code > , and newlines may be included in a value by ending a line with a trailing back-slash (< code > \\</ code > ).< br >< br > The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.< br >< br > Note that the variables here are subject to< a href ="https://docs.bazel.build/versions/main/user-manual.html#workspace_status "> workspace status</ a > stamping should the< code > stamp</ code > attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g.< code > NAME={WORKSPACE_STATUS_VARIABLE}</ code > .</ 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 > 508< tr >< td style ="text-align: left ">< a id ="rust_shared_library-rustc_flags "></ a > rustc_flags</ td >< td style ="text-align: left "> List of compiler flags passed to< code > rustc</ code > .< br >< br > These strings are subject to Make variable expansion for predefined source/output path variables like< code > $location</ code > ,< code > $execpath</ code > , and< code > $rootpath</ code > . This expansion is useful if you wish to pass a generated file of arguments to rustc:< code > @$(location //package:target)</ code > .</ 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 > 509< tr >< td style ="text-align: left ">< a id ="rust_shared_library-stamp "></ a > stamp</ td >< td style ="text-align: left "> Whether to encode build information into the< code > Rustc</ code > action. Possible values:< br >< br > -< code > stamp = 1</ code > : Always stamp the build information into the< code > Rustc</ code > action, even in< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --nostamp</ a > builds. This setting should be avoided, since it potentially kills remote caching for the target and any downstream actions that depend on it.< br >< br > -< code > stamp = 0</ code > : Always replace build information by constant values. This gives good build result caching.< br >< br > -< code > stamp = -1</ code > : Embedding of build information is controlled by the< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --[no]stamp</ a > flag.< br >< br > Stamped targets are not rebuilt unless their dependencies change.< br >< br > For example if a< code > rust_library</ code > is stamped, and a< code > rust_binary</ code > depends on that library, the stamped library won't be rebuilt when we change sources of the< code > rust_binary</ code > . This is different from how< a href ="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp ">< code > cc_library.linkstamps</ code ></ a > behaves.</ td >< td style ="text-align: left "> Integer</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > 0</ code ></ td ></ tr > 510< tr >< td style ="text-align: left ">< a id ="rust_shared_library-version "></ a > version</ td >< td style ="text-align: left "> A version to inject in the cargo environment variable.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > "0.0.0"</ code ></ td ></ tr > 511</ tbody ></ table > 512</ div > 513< p >< a id ="rust_static_library "></ a ></ p > 514< h2 id ="rust_static_library ">< a class ="header "href ="#rust_static_library "> rust_static_library</ a ></ h2 > 515< pre > 516rust_static_library(< a href ="#rust_static_library-name "> name</ a > ,< a href ="#rust_static_library-deps "> deps</ a > ,< a href ="#rust_static_library-srcs "> srcs</ a > ,< a href ="#rust_static_library-data "> data</ a > ,< a href ="#rust_static_library-aliases "> aliases</ a > ,< a href ="#rust_static_library-alwayslink "> alwayslink</ a > ,< a href ="#rust_static_library-compile_data "> compile_data</ a > ,< a href ="#rust_static_library-crate_features "> crate_features</ a > , 517< a href ="#rust_static_library-crate_name "> crate_name</ a > ,< a href ="#rust_static_library-crate_root "> crate_root</ a > ,< a href ="#rust_static_library-edition "> edition</ a > ,< a href ="#rust_static_library-platform "> platform</ a > ,< a href ="#rust_static_library-proc_macro_deps "> proc_macro_deps</ a > ,< a href ="#rust_static_library-rustc_env "> rustc_env</ a > , 518< a href ="#rust_static_library-rustc_env_files "> rustc_env_files</ a > ,< a href ="#rust_static_library-rustc_flags "> rustc_flags</ a > ,< a href ="#rust_static_library-stamp "> stamp</ a > ,< a href ="#rust_static_library-version "> version</ a > ) 519</ pre > 520< p > Builds a Rust static library.</ p > 521< p > This static library will contain all transitively reachable crates and native objects. 522It is meant to be used when producing an artifact that is then consumed by some other build system 523(for example to produce an archive that Python program links against).</ p > 524< p > This rule provides CcInfo, so it can be used everywhere Bazel expects< code > rules_cc</ code > .</ p > 525< p > When building the whole binary in Bazel, use< code > rust_library</ code > instead.</ p > 526< p >< strong > ATTRIBUTES</ strong ></ p > 527< 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 > 528< tr >< td style ="text-align: left ">< a id ="rust_static_library-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 529< tr >< td style ="text-align: left ">< a id ="rust_static_library-deps "></ a > deps</ td >< td style ="text-align: left "> List of other libraries to be linked to this library target.< br >< br > These can be either other< code > rust_library</ code > targets or< code > cc_library</ code > targets if linking a native library.</ 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 > 530< tr >< td style ="text-align: left ">< a id ="rust_static_library-srcs "></ a > srcs</ td >< td style ="text-align: left "> List of Rust< code > .rs</ code > source files used to build the library.< br >< br > If< code > srcs</ code > contains more than one file, then there must be a file either named< code > lib.rs</ code > . Otherwise,< code > crate_root</ code > must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</ td >< td style ="text-align: left ">< 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 > 531< tr >< td style ="text-align: left ">< a id ="rust_static_library-data "></ a > data</ td >< td style ="text-align: left "> List of files used by this rule at compile time and runtime.< br >< br > If including data at compile time with include_str!() and similar, prefer< code > compile_data</ code > over< code > data</ code > , to prevent the data also being included in the runfiles.</ 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 > 532< tr >< td style ="text-align: left ">< a id ="rust_static_library-aliases "></ a > aliases</ td >< td style ="text-align: left "> Remap crates to a new name or moniker for linkage to this target< br >< br > These are other< code > rust_library</ code > targets and will be presented as the new name given.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: Label -> String</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > {}</ code ></ td ></ tr > 533< tr >< td style ="text-align: left ">< a id ="rust_static_library-alwayslink "></ a > alwayslink</ td >< td style ="text-align: left "> If 1, any binary that depends (directly or indirectly) on this library will link in all the object files even if some contain no symbols referenced by the binary.< br >< br > This attribute is used by the C++ Starlark API when passing CcInfo providers.</ 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 > 534< tr >< td style ="text-align: left ">< a id ="rust_static_library-compile_data "></ a > compile_data</ td >< td style ="text-align: left "> List of files used by this rule at compile time.< br >< br > This attribute can be used to specify any data files that are embedded into the library, such as via the< a href ="https://doc.rust-lang.org/std/macro.include_str!.html ">< code > include_str!</ code ></ a > macro.</ 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 > 535< tr >< td style ="text-align: left ">< a id ="rust_static_library-crate_features "></ a > crate_features</ td >< td style ="text-align: left "> List of features to enable for this crate.< br >< br > Features are defined in the code using the< code > #[cfg(feature = "foo")]</ code > configuration option. The features listed here will be passed to< code > rustc</ code > with< code > --cfg feature="${feature_name}"</ code > flags.</ 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 > 536< tr >< td style ="text-align: left ">< a id ="rust_static_library-crate_name "></ a > crate_name</ td >< td style ="text-align: left "> Crate name to use for this target.< br >< br > This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 537< tr >< td style ="text-align: left ">< a id ="rust_static_library-crate_root "></ a > crate_root</ td >< td style ="text-align: left "> The file that will be passed to< code > rustc</ code > to be used for building this crate.< br >< br > If< code > crate_root</ code > is not set, then this rule will look for a< code > lib.rs</ code > file (or< code > main.rs</ code > for rust_binary) or the single file in< code > srcs</ code > if< code > srcs</ code > contains only one 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 > 538< tr >< td style ="text-align: left ">< a id ="rust_static_library-edition "></ a > edition</ td >< td style ="text-align: left "> The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 539< tr >< td style ="text-align: left ">< a id ="rust_static_library-platform "></ a > platform</ td >< td style ="text-align: left "> Optional platform to transition the static library to.</ 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 > 540< tr >< td style ="text-align: left ">< a id ="rust_static_library-proc_macro_deps "></ a > proc_macro_deps</ td >< td style ="text-align: left "> List of< code > rust_proc_macro</ code > targets used to help build this library target.</ 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 > 541< tr >< td style ="text-align: left ">< a id ="rust_static_library-rustc_env "></ a > rustc_env</ td >< td style ="text-align: left "> Dictionary of additional< code > "key": "value"</ code > environment variables to set for rustc.< br >< br > rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</ td >< td style ="text-align: left ">< 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 > 542< tr >< td style ="text-align: left ">< a id ="rust_static_library-rustc_env_files "></ a > rustc_env_files</ td >< td style ="text-align: left "> Files containing additional environment variables to set for rustc.< br >< br > These files should contain a single variable per line, of format< code > NAME=value</ code > , and newlines may be included in a value by ending a line with a trailing back-slash (< code > \\</ code > ).< br >< br > The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.< br >< br > Note that the variables here are subject to< a href ="https://docs.bazel.build/versions/main/user-manual.html#workspace_status "> workspace status</ a > stamping should the< code > stamp</ code > attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g.< code > NAME={WORKSPACE_STATUS_VARIABLE}</ code > .</ 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 > 543< tr >< td style ="text-align: left ">< a id ="rust_static_library-rustc_flags "></ a > rustc_flags</ td >< td style ="text-align: left "> List of compiler flags passed to< code > rustc</ code > .< br >< br > These strings are subject to Make variable expansion for predefined source/output path variables like< code > $location</ code > ,< code > $execpath</ code > , and< code > $rootpath</ code > . This expansion is useful if you wish to pass a generated file of arguments to rustc:< code > @$(location //package:target)</ code > .</ 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 > 544< tr >< td style ="text-align: left ">< a id ="rust_static_library-stamp "></ a > stamp</ td >< td style ="text-align: left "> Whether to encode build information into the< code > Rustc</ code > action. Possible values:< br >< br > -< code > stamp = 1</ code > : Always stamp the build information into the< code > Rustc</ code > action, even in< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --nostamp</ a > builds. This setting should be avoided, since it potentially kills remote caching for the target and any downstream actions that depend on it.< br >< br > -< code > stamp = 0</ code > : Always replace build information by constant values. This gives good build result caching.< br >< br > -< code > stamp = -1</ code > : Embedding of build information is controlled by the< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --[no]stamp</ a > flag.< br >< br > Stamped targets are not rebuilt unless their dependencies change.< br >< br > For example if a< code > rust_library</ code > is stamped, and a< code > rust_binary</ code > depends on that library, the stamped library won't be rebuilt when we change sources of the< code > rust_binary</ code > . This is different from how< a href ="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp ">< code > cc_library.linkstamps</ code ></ a > behaves.</ td >< td style ="text-align: left "> Integer</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > 0</ code ></ td ></ tr > 545< tr >< td style ="text-align: left ">< a id ="rust_static_library-version "></ a > version</ td >< td style ="text-align: left "> A version to inject in the cargo environment variable.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > "0.0.0"</ code ></ td ></ tr > 546</ tbody ></ table > 547</ div > 548< p >< a id ="rust_test "></ a ></ p > 549< h2 id ="rust_test ">< a class ="header "href ="#rust_test "> rust_test</ a ></ h2 > 550< pre > 551rust_test(< a href ="#rust_test-name "> name</ a > ,< a href ="#rust_test-deps "> deps</ a > ,< a href ="#rust_test-srcs "> srcs</ a > ,< a href ="#rust_test-data "> data</ a > ,< a href ="#rust_test-aliases "> aliases</ a > ,< a href ="#rust_test-alwayslink "> alwayslink</ a > ,< a href ="#rust_test-compile_data "> compile_data</ a > ,< a href ="#rust_test-crate "> crate</ a > ,< a href ="#rust_test-crate_features "> crate_features</ a > , 552< a href ="#rust_test-crate_name "> crate_name</ a > ,< a href ="#rust_test-crate_root "> crate_root</ a > ,< a href ="#rust_test-edition "> edition</ a > ,< a href ="#rust_test-env "> env</ a > ,< a href ="#rust_test-env_inherit "> env_inherit</ a > ,< a href ="#rust_test-experimental_use_cc_common_link "> experimental_use_cc_common_link</ a > ,< a href ="#rust_test-malloc "> malloc</ a > , 553< a href ="#rust_test-platform "> platform</ a > ,< a href ="#rust_test-proc_macro_deps "> proc_macro_deps</ a > ,< a href ="#rust_test-rustc_env "> rustc_env</ a > ,< a href ="#rust_test-rustc_env_files "> rustc_env_files</ a > ,< a href ="#rust_test-rustc_flags "> rustc_flags</ a > ,< a href ="#rust_test-stamp "> stamp</ a > , 554< a href ="#rust_test-use_libtest_harness "> use_libtest_harness</ a > ,< a href ="#rust_test-version "> version</ a > ) 555</ pre > 556< p > Builds a Rust test crate.</ p > 557< p > Examples:</ p > 558< p > Suppose you have the following directory structure for a Rust library crate with unit test code in the library sources:</ p > 559< pre >< code class ="language-output "> [workspace]/ 560 WORKSPACE 561 hello_lib/ 562 BUILD 563 src/ 564 lib.rs 565</ code ></ pre > 566< p >< code > hello_lib/src/lib.rs</ code > :</ p > 567< pre >< pre class ="playground ">< code class ="language-rust ">< span class ="boring "> #![allow(unused)] 568</ span >< span class ="boring "> fn main() { 569</ span > pub struct Greeter { 570 greeting: String, 571} 572 573impl Greeter { 574 pub fn new(greeting: &str) -> Greeter { 575 Greeter { greeting: greeting.to_string(), } 576 } 577 578 pub fn greet(&self, thing: &str) -> String { 579 format!("{} {}", &self.greeting, thing) 580 } 581} 582 583#[cfg(test)] 584mod test { 585 use super::Greeter; 586 587 #[test] 588 fn test_greeting() { 589 let hello = Greeter::new("Hi"); 590 assert_eq!("Hi Rust", hello.greet("Rust")); 591 } 592} 593< span class ="boring "> }</ span ></ code ></ pre ></ pre > 594< p > To build and run the tests, simply add a< code > rust_test</ code > rule with no< code > srcs</ code > 595and only depends on the< code > hello_lib</ code > < code > rust_library</ code > target via the 596< code > crate</ code > attribute:</ p > 597< p >< code > hello_lib/BUILD</ code > :</ p > 598< pre >< code class ="language-python "> load("@rules_rust//rust:defs.bzl", "rust_library", "rust_test") 599 600rust_library( 601 name = "hello_lib", 602 srcs = ["src/lib.rs"], 603) 604 605rust_test( 606 name = "hello_lib_test", 607 crate = ":hello_lib", 608 # You may add other deps that are specific to the test configuration 609 deps = ["//some/dev/dep"], 610) 611</ code ></ pre > 612< p > Run the test with< code > bazel test //hello_lib:hello_lib_test</ code > .</ p > 613< h3 id ="example-test-directory ">< a class ="header "href ="#example-test-directory "> Example:< code > test</ code > directory</ a ></ h3 > 614< p > Integration tests that live in the< a href ="http://doc.rust-lang.org/book/testing.html#the-tests-directory ">< code > tests</ code > directory</ a > , they are essentially built as separate crates. Suppose you have the following directory structure where< code > greeting.rs</ code > is an integration test for the< code > hello_lib</ code > library crate:</ p > 615< pre >< code class ="language-output "> [workspace]/ 616 WORKSPACE 617 hello_lib/ 618 BUILD 619 src/ 620 lib.rs 621 tests/ 622 greeting.rs 623</ code ></ pre > 624< p >< code > hello_lib/tests/greeting.rs</ code > :</ p > 625< pre >< pre class ="playground ">< code class ="language-rust ">< span class ="boring "> #![allow(unused)] 626</ span >< span class ="boring "> fn main() { 627</ span > extern crate hello_lib; 628 629use hello_lib; 630 631#[test] 632fn test_greeting() { 633 let hello = greeter::Greeter::new("Hello"); 634 assert_eq!("Hello world", hello.greeting("world")); 635} 636< span class ="boring "> }</ span ></ code ></ pre ></ pre > 637< p > To build the< code > greeting.rs</ code > integration test, simply add a< code > rust_test</ code > target 638with< code > greeting.rs</ code > in< code > srcs</ code > and a dependency on the< code > hello_lib</ code > target:</ p > 639< p >< code > hello_lib/BUILD</ code > :</ p > 640< pre >< code class ="language-python "> load("@rules_rust//rust:defs.bzl", "rust_library", "rust_test") 641 642rust_library( 643 name = "hello_lib", 644 srcs = ["src/lib.rs"], 645) 646 647rust_test( 648 name = "greeting_test", 649 srcs = ["tests/greeting.rs"], 650 deps = [":hello_lib"], 651) 652</ code ></ pre > 653< p > Run the test with< code > bazel test //hello_lib:greeting_test</ code > .</ p > 654< p >< strong > ATTRIBUTES</ strong ></ p > 655< 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 > 656< tr >< td style ="text-align: left ">< a id ="rust_test-name "></ a > name</ td >< td style ="text-align: left "> A unique name for this target.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/concepts/labels#target-names "> Name</ a ></ td >< td style ="text-align: left "> required</ td >< td style ="text-align: left "></ td ></ tr > 657< tr >< td style ="text-align: left ">< a id ="rust_test-deps "></ a > deps</ td >< td style ="text-align: left "> List of other libraries to be linked to this library target.< br >< br > These can be either other< code > rust_library</ code > targets or< code > cc_library</ code > targets if linking a native library.</ 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 > 658< tr >< td style ="text-align: left ">< a id ="rust_test-srcs "></ a > srcs</ td >< td style ="text-align: left "> List of Rust< code > .rs</ code > source files used to build the library.< br >< br > If< code > srcs</ code > contains more than one file, then there must be a file either named< code > lib.rs</ code > . Otherwise,< code > crate_root</ code > must be set to the source file that is the root of the crate to be passed to rustc to build this crate.</ td >< td style ="text-align: left ">< 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 > 659< tr >< td style ="text-align: left ">< a id ="rust_test-data "></ a > data</ td >< td style ="text-align: left "> List of files used by this rule at compile time and runtime.< br >< br > If including data at compile time with include_str!() and similar, prefer< code > compile_data</ code > over< code > data</ code > , to prevent the data also being included in the runfiles.</ 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 > 660< tr >< td style ="text-align: left ">< a id ="rust_test-aliases "></ a > aliases</ td >< td style ="text-align: left "> Remap crates to a new name or moniker for linkage to this target< br >< br > These are other< code > rust_library</ code > targets and will be presented as the new name given.</ td >< td style ="text-align: left ">< a href ="https://bazel.build/rules/lib/dict "> Dictionary: Label -> String</ a ></ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > {}</ code ></ td ></ tr > 661< tr >< td style ="text-align: left ">< a id ="rust_test-alwayslink "></ a > alwayslink</ td >< td style ="text-align: left "> If 1, any binary that depends (directly or indirectly) on this library will link in all the object files even if some contain no symbols referenced by the binary.< br >< br > This attribute is used by the C++ Starlark API when passing CcInfo providers.</ 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 > 662< tr >< td style ="text-align: left ">< a id ="rust_test-compile_data "></ a > compile_data</ td >< td style ="text-align: left "> List of files used by this rule at compile time.< br >< br > This attribute can be used to specify any data files that are embedded into the library, such as via the< a href ="https://doc.rust-lang.org/std/macro.include_str!.html ">< code > include_str!</ code ></ a > macro.</ 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 > 663< tr >< td style ="text-align: left ">< a id ="rust_test-crate "></ a > crate</ td >< td style ="text-align: left "> Target inline tests declared in the given crate< br >< br > These tests are typically those that would be held out under< code > #[cfg(test)]</ code > declarations.</ 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 > 664< tr >< td style ="text-align: left ">< a id ="rust_test-crate_features "></ a > crate_features</ td >< td style ="text-align: left "> List of features to enable for this crate.< br >< br > Features are defined in the code using the< code > #[cfg(feature = "foo")]</ code > configuration option. The features listed here will be passed to< code > rustc</ code > with< code > --cfg feature="${feature_name}"</ code > flags.</ 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 > 665< tr >< td style ="text-align: left ">< a id ="rust_test-crate_name "></ a > crate_name</ td >< td style ="text-align: left "> Crate name to use for this target.< br >< br > This must be a valid Rust identifier, i.e. it may contain only alphanumeric characters and underscores. Defaults to the target name, with any hyphens replaced by underscores.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 666< tr >< td style ="text-align: left ">< a id ="rust_test-crate_root "></ a > crate_root</ td >< td style ="text-align: left "> The file that will be passed to< code > rustc</ code > to be used for building this crate.< br >< br > If< code > crate_root</ code > is not set, then this rule will look for a< code > lib.rs</ code > file (or< code > main.rs</ code > for rust_binary) or the single file in< code > srcs</ code > if< code > srcs</ code > contains only one 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 > 667< tr >< td style ="text-align: left ">< a id ="rust_test-edition "></ a > edition</ td >< td style ="text-align: left "> The rust edition to use for this crate. Defaults to the edition specified in the rust_toolchain.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > ""</ code ></ td ></ tr > 668< tr >< td style ="text-align: left ">< a id ="rust_test-env "></ a > env</ td >< td style ="text-align: left "> Specifies additional environment variables to set when the test is executed by bazel test. Values are subject to< code > $(rootpath)</ code > ,< code > $(execpath)</ code > , location, and< a href ="https://docs.bazel.build/versions/master/be/make-variables.html "> "Make variable"</ a > substitution.</ 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 > 669< tr >< td style ="text-align: left ">< a id ="rust_test-env_inherit "></ a > env_inherit</ td >< td style ="text-align: left "> Specifies additional environment variables to inherit from the external environment when the test is executed by bazel test.</ 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 > 670< tr >< td style ="text-align: left ">< a id ="rust_test-experimental_use_cc_common_link "></ a > experimental_use_cc_common_link</ td >< td style ="text-align: left "> Whether to use cc_common.link to link rust binaries. Possible values: [-1, 0, 1]. -1 means use the value of the toolchain.experimental_use_cc_common_link boolean build setting to determine. 0 means do not use cc_common.link (use rustc instead). 1 means use cc_common.link.</ td >< td style ="text-align: left "> Integer</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > -1</ code ></ td ></ tr > 671< tr >< td style ="text-align: left ">< a id ="rust_test-malloc "></ a > malloc</ td >< td style ="text-align: left "> Override the default dependency on< code > malloc</ code > .< br >< br > By default, Rust binaries linked with cc_common.link are linked against< code > @bazel_tools//tools/cpp:malloc"</ code > , which is an empty library and the resulting binary will use libc's< code > malloc</ code > . This label must refer to a< code > cc_library</ code > rule.</ 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 > "@bazel_tools//tools/cpp:malloc"</ code ></ td ></ tr > 672< tr >< td style ="text-align: left ">< a id ="rust_test-platform "></ a > platform</ td >< td style ="text-align: left "> Optional platform to transition the test to.</ 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 > 673< tr >< td style ="text-align: left ">< a id ="rust_test-proc_macro_deps "></ a > proc_macro_deps</ td >< td style ="text-align: left "> List of< code > rust_proc_macro</ code > targets used to help build this library target.</ 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 > 674< tr >< td style ="text-align: left ">< a id ="rust_test-rustc_env "></ a > rustc_env</ td >< td style ="text-align: left "> Dictionary of additional< code > "key": "value"</ code > environment variables to set for rustc.< br >< br > rust_test()/rust_binary() rules can use $(rootpath //package:target) to pass in the location of a generated file or external tool. Cargo build scripts that wish to expand locations should use cargo_build_script()'s build_script_env argument instead, as build scripts are run in a different environment - see cargo_build_script()'s documentation for more.</ td >< td style ="text-align: left ">< 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 > 675< tr >< td style ="text-align: left ">< a id ="rust_test-rustc_env_files "></ a > rustc_env_files</ td >< td style ="text-align: left "> Files containing additional environment variables to set for rustc.< br >< br > These files should contain a single variable per line, of format< code > NAME=value</ code > , and newlines may be included in a value by ending a line with a trailing back-slash (< code > \\</ code > ).< br >< br > The order that these files will be processed is unspecified, so multiple definitions of a particular variable are discouraged.< br >< br > Note that the variables here are subject to< a href ="https://docs.bazel.build/versions/main/user-manual.html#workspace_status "> workspace status</ a > stamping should the< code > stamp</ code > attribute be enabled. Stamp variables should be wrapped in brackets in order to be resolved. E.g.< code > NAME={WORKSPACE_STATUS_VARIABLE}</ code > .</ 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 > 676< tr >< td style ="text-align: left ">< a id ="rust_test-rustc_flags "></ a > rustc_flags</ td >< td style ="text-align: left "> List of compiler flags passed to< code > rustc</ code > .< br >< br > These strings are subject to Make variable expansion for predefined source/output path variables like< code > $location</ code > ,< code > $execpath</ code > , and< code > $rootpath</ code > . This expansion is useful if you wish to pass a generated file of arguments to rustc:< code > @$(location //package:target)</ code > .</ 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 > 677< tr >< td style ="text-align: left ">< a id ="rust_test-stamp "></ a > stamp</ td >< td style ="text-align: left "> Whether to encode build information into the< code > Rustc</ code > action. Possible values:< br >< br > -< code > stamp = 1</ code > : Always stamp the build information into the< code > Rustc</ code > action, even in< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --nostamp</ a > builds. This setting should be avoided, since it potentially kills remote caching for the target and any downstream actions that depend on it.< br >< br > -< code > stamp = 0</ code > : Always replace build information by constant values. This gives good build result caching.< br >< br > -< code > stamp = -1</ code > : Embedding of build information is controlled by the< a href ="https://docs.bazel.build/versions/main/user-manual.html#flag--stamp "> --[no]stamp</ a > flag.< br >< br > Stamped targets are not rebuilt unless their dependencies change.< br >< br > For example if a< code > rust_library</ code > is stamped, and a< code > rust_binary</ code > depends on that library, the stamped library won't be rebuilt when we change sources of the< code > rust_binary</ code > . This is different from how< a href ="https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.linkstamp ">< code > cc_library.linkstamps</ code ></ a > behaves.</ td >< td style ="text-align: left "> Integer</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > 0</ code ></ td ></ tr > 678< tr >< td style ="text-align: left ">< a id ="rust_test-use_libtest_harness "></ a > use_libtest_harness</ td >< td style ="text-align: left "> Whether to use< code > libtest</ code > . For targets using this flag, individual tests can be run by using the< a href ="https://docs.bazel.build/versions/4.0.0/command-line-reference.html#flag--test_arg "> --test_arg</ a > flag. E.g.< code > bazel test //src:rust_test --test_arg=foo::test::test_fn</ code > .</ 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 > 679< tr >< td style ="text-align: left ">< a id ="rust_test-version "></ a > version</ td >< td style ="text-align: left "> A version to inject in the cargo environment variable.</ td >< td style ="text-align: left "> String</ td >< td style ="text-align: left "> optional</ td >< td style ="text-align: left ">< code > "0.0.0"</ code ></ td ></ tr > 680</ tbody ></ table > 681</ div > 682< p >< a id ="rust_test_suite "></ a ></ p > 683< h2 id ="rust_test_suite ">< a class ="header "href ="#rust_test_suite "> rust_test_suite</ a ></ h2 > 684< pre > 685rust_test_suite(< a href ="#rust_test_suite-name "> name</ a > ,< a href ="#rust_test_suite-srcs "> srcs</ a > ,< a href ="#rust_test_suite-shared_srcs "> shared_srcs</ a > ,< a href ="#rust_test_suite-kwargs "> kwargs</ a > ) 686</ pre > 687< p > A rule for creating a test suite for a set of< code > rust_test</ code > targets.</ p > 688< p > This rule can be used for setting up typical rust< a href ="https://doc.rust-lang.org/rust-by-example/testing/integration_testing.html "> integration tests</ a > . Given the following 689directory structure:</ p > 690< pre >< code class ="language-text "> [crate]/ 691 BUILD.bazel 692 src/ 693 lib.rs 694 main.rs 695 tests/ 696 integrated_test_a.rs 697 integrated_test_b.rs 698 integrated_test_c.rs 699 patterns/ 700 fibonacci_test.rs 701 helpers/ 702 mod.rs 703</ code ></ pre > 704< p > The rule can be used to generate< a href ="#rust_test "> rust_test</ a > targets for each source file under< code > tests</ code > 705and a< a href ="https://docs.bazel.build/versions/master/be/general.html#test_suite "> test_suite</ a > which encapsulates all tests.</ p > 706< pre >< code class ="language-python "> load("//rust:defs.bzl", "rust_binary", "rust_library", "rust_test_suite") 707 708rust_library( 709 name = "math_lib", 710 srcs = ["src/lib.rs"], 711) 712 713rust_binary( 714 name = "math_bin", 715 srcs = ["src/main.rs"], 716) 717 718rust_test_suite( 719 name = "integrated_tests_suite", 720 srcs = glob(["tests/**"]), 721 shared_srcs=glob(["tests/helpers/**"]), 722 deps = [":math_lib"], 723) 724</ code ></ pre > 725< p >< strong > PARAMETERS</ strong ></ p > 726< 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 "> Default Value</ th ></ tr ></ thead >< tbody > 727< tr >< td style ="text-align: left ">< a id ="rust_test_suite-name "></ a > name</ td >< td style ="text-align: left "> The name of the< code > test_suite</ code > .</ td >< td style ="text-align: left "> none</ td ></ tr > 728< tr >< td style ="text-align: left ">< a id ="rust_test_suite-srcs "></ a > srcs</ td >< td style ="text-align: left "> All test sources, typically< code > glob(["tests/**/*.rs"])</ code > .</ td >< td style ="text-align: left "> none</ td ></ tr > 729< tr >< td style ="text-align: left ">< a id ="rust_test_suite-shared_srcs "></ a > shared_srcs</ td >< td style ="text-align: left "> Optional argument for sources shared among tests, typically helper functions.</ td >< td style ="text-align: left ">< code > []</ code ></ td ></ tr > 730< tr >< td style ="text-align: left ">< a id ="rust_test_suite-kwargs "></ a > kwargs</ td >< td style ="text-align: left "> Additional keyword arguments for the underyling< a href ="#rust_test "> rust_test</ a > targets. The< code > tags</ code > argument is also passed to the generated< code > test_suite</ code > target.</ td >< td style ="text-align: left "> none</ td ></ tr > 731</ tbody ></ table > 732</ div > 733</ main > 734 735< nav class ="nav-wrapper "aria-label ="Page navigation "> 736<!-- Mobile navigation buttons --> 737< a rel ="prev "href ="rules.html "class ="mobile-nav-chapters previous "title ="Previous chapter "aria-label ="Previous chapter "aria-keyshortcuts ="Left "> 738< i class ="fa fa-angle-left "></ i > 739</ a > 740 741< a rel ="next prefetch "href ="rust_doc.html "class ="mobile-nav-chapters next "title ="Next chapter "aria-label ="Next chapter "aria-keyshortcuts ="Right "> 742< i class ="fa fa-angle-right "></ i > 743</ a > 744 745< div style ="clear: both "></ div > 746</ nav > 747</ div > 748</ div > 749 750< nav class ="nav-wide-wrapper "aria-label ="Page navigation "> 751< a rel ="prev "href ="rules.html "class ="nav-chapters previous "title ="Previous chapter "aria-label ="Previous chapter "aria-keyshortcuts ="Left "> 752< i class ="fa fa-angle-left "></ i > 753</ a > 754 755< a rel ="next prefetch "href ="rust_doc.html "class ="nav-chapters next "title ="Next chapter "aria-label ="Next chapter "aria-keyshortcuts ="Right "> 756< i class ="fa fa-angle-right "></ i > 757</ a > 758</ nav > 759 760</ div > 761 762 763 764 765< script > 766window . playground_copyable = true ; 767</ script > 768 769 770< script src ="elasticlunr.min.js "></ script > 771< script src ="mark.min.js "></ script > 772< script src ="searcher.js "></ script > 773 774< script src ="clipboard.min.js "></ script > 775< script src ="highlight.js "></ script > 776< script src ="book.js "></ script > 777 778<!-- Custom JS scripts --> 779 780 781</ div > 782</ body > 783</ html >