Struct RustBuild 

pub struct RustBuild { /* private fields */ }

Represents a Rust build for a specific target triple.

Implementations

impl RustBuild

pub fn new(path: impl AsRef<Path>, triple: Triple) -> Self

Create a new rust build for the given path and target triple.

pub fn with_target_dir(self, target_dir: impl Into<PathBuf>) -> Self

Use an explicit Cargo target directory.

pub fn with_sccache(self, sccache_path: PathBuf) -> Self

Set the sccache path for compilation caching.

When set, RUSTC_WRAPPER will be configured to use sccache, which can significantly improve incremental build times.

pub fn with_feature(self, feature: impl Into<String>) -> Self

Add a Cargo feature to enable during the build.

Features are passed to cargo via --features.

pub fn with_features( self, features: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Add multiple Cargo features to enable during the build.

pub fn features(&self) -> &[String]

Cargo features this build passes via --features.

pub fn with_rustc_flag(self, flag: impl Into<String>) -> Self

Add a rustc flag to the build via RUSTFLAGS.

pub fn with_final_rustc_arg(self, flag: impl Into<String>) -> Self

Add a rustc flag that applies to the final crate only.

The flag is passed as a trailing cargo rustc argument instead of through RUSTFLAGS, so dependency unit fingerprints stay identical across builds that differ only in how their final artifact links. See the field documentation on final_rustc_args for why link arguments must take this route.

pub fn with_preferred_dynamic_linking(self) -> Self

Prefer dynamic Rust dependencies and emit loader search paths for them.

pub fn with_linkage( self, linkage: RustLinkage, development_feature: &str, loader_search_path: Option<&str>, ) -> Self

Configure this build for the selected Rust runtime linkage.

A shared-runtime development build enables the project’s dev feature (which resolves the shared waterui-dylib runtime), prefers dynamic linking, and — when the platform’s loader needs one — embeds a loader search path into the final artifact only. A static packaging build needs none of this.

pub fn with_crate_type_override(self, crate_type: impl Into<String>) -> Self

Override the library crate type passed to rustc.

pub fn with_env( self, key: impl Into<String>, value: impl Into<OsString>, ) -> Self

Add an environment variable for the cargo build process.

pub fn with_envs( self, envs: impl IntoIterator<Item = (String, OsString)>, ) -> Self

Add multiple environment variables for the cargo build process.

pub const fn triple(&self) -> &Triple

Get the target triple for this build.

pub async fn dev_build(&self) -> Result<PathBuf, RustBuildError>

Build rust library in development mode.

Will produce debug symbols and less optimizations for faster builds.

Return the path to the built library.

Errors

• RustBuildError::FailToExecuteCargoBuild: If there was an error executing the cargo build command.
• RustBuildError::FailToBuildRustLibrary: If there was an error building the Rust library.

pub async fn release_build(&self) -> Result<PathBuf, RustBuildError>

Build rust library in release mode.

Return the directory path containing the built library.

Errors

• RustBuildError::FailToExecuteCargoBuild: If there was an error executing the cargo build command.
• RustBuildError::FailToBuildRustLibrary: If there was an error building the Rust library.

pub async fn build_lib(&self, release: bool) -> Result<PathBuf, RustBuildError>

Build a library with the specified crate type.

Return the directory path containing the built library.

Errors

• RustBuildError::FailToExecuteCargoBuild: If there was an error executing the cargo build command.
• RustBuildError::FailToBuildRustLibrary: If there was an error building the Rust library.

pub async fn build_dylib( &self, crate_name: &str, release: bool, ) -> Result<PathBuf, RustBuildError>

Build a dynamic library (cdylib) and return the full path to the dylib file.

This is a convenience method that builds the library and computes the full path to the resulting dylib file based on the crate name and target triple.

Errors

• RustBuildError::FailToExecuteCargoBuild: If there was an error executing the cargo build command.
• RustBuildError::FailToBuildRustLibrary: If the library was not found after building.

pub async fn build_binary( &self, binary_name: &str, release: bool, ) -> Result<PathBuf, RustBuildError>

Builds one named binary and returns its full output path.

Errors

Returns an error when Cargo fails or the expected binary is missing.

pub async fn dylib_path( &self, crate_name: &str, release: bool, ) -> Result<PathBuf, RustBuildError>

Compute the expected dylib output path without building.

This uses cargo metadata to resolve the target directory to avoid assuming a fixed target/ path.

Errors

Returns an error if Cargo metadata cannot be read.

pub async fn lib_output_dir( &self, release: bool, ) -> Result<PathBuf, RustBuildError>

Resolve the Cargo library artifact directory for this build target and profile.

Errors

Returns an error if Cargo metadata cannot be read for this build target.

Trait Implementations

impl Clone for RustBuild

fn clone(&self) -> RustBuild

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RustBuild

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.