While working on my demo on WebAssembly and Kubernetes, I wanted to create three different binaries based on the same code: demo Native: compile the Rust code to regular native code as a baseline
Embed: compile to WebAssembly and use the WasmEdge runtime image as the base Docker image
Runtime: compile to WebAssembly, use a base scratch image as my base image, and set the runtime when running the code Native: compile the Rust code to regular native code as a baseline Embed: compile to WebAssembly and use the WasmEdge runtime image as the base Docker image Runtime: compile to WebAssembly, use a base scratch image as my base image, and set the runtime when running the code scratch The code itself is an HTTP server that offers a single endpoint. For the sake of the demo, I wanted it to return the flavour of the underlying image. curl localhost:3000/get curl localhost:3000/get {"source": "native", "data": {}} {"source": "native", "data": {}} The idea is to have a single codebase that I can compile to native or WebAssembly. I solved this requirement by using a cfg compile flag. cfg #[cfg(flavor = "native")]
const FLAVOR: &str = "native";

#[cfg(flavor = "embed")]
const FLAVOR: &str = "embed";

#[cfg(flavor = "runtime")]
const FLAVOR: &str = "runtime";

// Use FLAVOR later in the returned HTTP response #[cfg(flavor = "native")]
const FLAVOR: &str = "native";

#[cfg(flavor = "embed")]
const FLAVOR: &str = "embed";

#[cfg(flavor = "runtime")]
const FLAVOR: &str = "runtime";

// Use FLAVOR later in the returned HTTP response In my case, I can live with three different values. But what if I had to deal with a high cardinality, say, fifteen? It would be quite a bore to define them manually. I searched for a solution and found Build Scripts. Some packages need to compile third-party non-Rust code, for example C libraries. Other packages need to link to C libraries which can either be located on the system or possibly need to be built from source. Others still need facilities for functionality such as code generation before building (think parser generators).
Cargo does not aim to replace other tools that are well-optimized for these tasks, but it does integrate with them with custom build scripts. Placing a file named build.rs in the root of a package will cause Cargo to compile that script and execute it just before building the package.-- Build Scripts Some packages need to compile third-party non-Rust code, for example C libraries. Other packages need to link to C libraries which can either be located on the system or possibly need to be built from source. Others still need facilities for functionality such as code generation before building (think parser generators). Cargo does not aim to replace other tools that are well-optimized for these tasks, but it does integrate with them with custom build scripts. Placing a file named build.rs in the root of a package will cause Cargo to compile that script and execute it just before building the package. build.rs -- Build Scripts Build Scripts Let's try with a simple build.script at the root of the crate: build.script fn main() {
    println!("Hello from build script!");
} fn main() {
    println!("Hello from build script!");
} cargo build cargo build Compiling high-cardinality-cfg-compile v0.1.0 (/Users/nico/projects/private/high-cardinality-cfg-compile)
 Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.08s Compiling high-cardinality-cfg-compile v0.1.0 (/Users/nico/projects/private/high-cardinality-cfg-compile)
 Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.08s There isn't any log–nothing seems to happen. The documentation reveals the reason: The output of the script is hidden from the terminal during normal compilation. If you would like to see the output directly in your terminal, invoke Cargo as "very verbose" with the -vv flag. The output of the script is hidden from the terminal during normal compilation. If you would like to see the output directly in your terminal, invoke Cargo as "very verbose" with the -vv flag. -vv Let's compile again with the verbose flag: cargo build --vv cargo build --vv The output is what we expect: ...
[high-cardinality-cfg-compile 0.1.0] Hello from build script!
... ...
[high-cardinality-cfg-compile 0.1.0] Hello from build script!
... Now is the time to do something useful: I'll use the build script to replace the hard-coded constants above. For that, I'll generate a Rust code file that contains the value passed for flavor. Note the build script runs before compilation. Hence, it doesn't have access to the cfg flags. Instead, I'll pass the value as a Cargo.toml package metadata key value. build script runs before compilation cfg Cargo.toml [package.metadata]
flavor = "foobar" [package.metadata]
flavor = "foobar" For our build script to read the Cargo.toml metadata, we need to add a build dependency: Cargo.toml [build-dependencies]
cargo_metadata = "0.19.1" [build-dependencies]
cargo_metadata = "0.19.1" The code is straightforward: fn main() {
    let metadata = MetadataCommand::new()                                         //1
        .exec()
        .expect("Failed to fetch cargo metadata");

    let package = metadata.root_package().expect("No root package found");        //2

    let flavor = package                                                          //3
        .metadata
        .get("flavor")
        .and_then(|f| f.as_str())
        .expect("flavor is not set in Cargo.toml under [package.metadata]");

    let dest_path = Path::new("src").join("flavor.rs");                           //4

    fs::write(&dest_path, format!("pub const FLAVOR: &str = \"{}\";\n", flavor))  //5
        .expect("Failed to write flavor.rs");

    println!("cargo:rerun-if-changed=Cargo.toml");
    println!("cargo:warning=FLAVOR written to {}", dest_path.display());
} fn main() {
    let metadata = MetadataCommand::new()                                         //1
        .exec()
        .expect("Failed to fetch cargo metadata");

    let package = metadata.root_package().expect("No root package found");        //2

    let flavor = package                                                          //3
        .metadata
        .get("flavor")
        .and_then(|f| f.as_str())
        .expect("flavor is not set in Cargo.toml under [package.metadata]");

    let dest_path = Path::new("src").join("flavor.rs");                           //4

    fs::write(&dest_path, format!("pub const FLAVOR: &str = \"{}\";\n", flavor))  //5
        .expect("Failed to write flavor.rs");

    println!("cargo:rerun-if-changed=Cargo.toml");
    println!("cargo:warning=FLAVOR written to {}", dest_path.display());
} Get the metadata
Get the package where we want to create the new file
Read the flavor value
Reference src/flavor.rs
Write pub const FLAVOR: &str = <flavor> Get the metadata Get the package where we want to create the new file Read the flavor value Reference src/flavor.rs src/flavor.rs Write pub const FLAVOR: &str = <flavor> pub const FLAVOR: &str = <flavor> On the code side, we only need to use the FLAVOR const from the flavor module: FLAVOR flavor mod flavor;

fn main() {
    println!("Hello from flavor {}", flavor::FLAVOR);
} mod flavor;

fn main() {
    println!("Hello from flavor {}", flavor::FLAVOR);
} Running the program outputs the flavor configured in the Cargo.toml file: Cargo.toml cargo run cargo run Hello from flavor foobar Hello from flavor foobar Conclusion In this, I've shown how to use high-cardinality build parameters from the package metadata. I could have achieved the same with environment variables, but I wanted to learn about the metadata section of the Cargo.toml file. metadata Cargo.toml The build.rs file is a handy trick for achieving goals that aren't possible with regular Cargo features. build.rs To go further: To go further: Build Scripts Build Scripts Build Scripts Originally published at A Java Geek on April 13th, 2025 Originally published at A Java Geek on April 13th, 2025 A Java Geek

Waiting: The Subtle Art That You Should Master

A Kubernetes Special: Even More OpenTelemetry to Chew On

Read all my posts!

Rust’s Build.rs Might Be the Most Underrated Feature in Cargo

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

10 Essential Java Libraries - How Essential Are They Really?

4 Ways to Manage the Configuration in Python

5 Reasons We Use Open Source FreeBSD as Our Enterprise OS

Guide To Organizing Your iOS Debug, Development, and Release States With .xcconfig Files

A Non-Standard Way to Use Apache Kafka Message Broker

Automating open source project configuration with Mrm

10 Essential Java Libraries - How Essential Are They Really?

4 Ways to Manage the Configuration in Python

5 Reasons We Use Open Source FreeBSD as Our Enterprise OS

Guide To Organizing Your iOS Debug, Development, and Release States With .xcconfig Files

A Non-Standard Way to Use Apache Kafka Message Broker

Automating open source project configuration with Mrm

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps