Struct RustBuilder 

pub struct RustBuilder { /* private fields */ }

Builder for Rust project compilation with smart defaults.

Discovers Cargo.toml by walking up from the starting path, parses project metadata, and provides methods to build and copy binaries to ~/hero/bin.

Implementations

impl RustBuilder

pub fn new() -> Self

Creates a new RustBuilder starting from the current directory.

pub fn from_path<P: AsRef<Path>>(path: P) -> Self

Creates a new RustBuilder starting from the given path. The path can be a file or directory - will walk up to find Cargo.toml.

pub fn release(self) -> Self

Sets the build profile to Release (production).

pub fn debug(self) -> Self

Sets the build profile to Debug (development).

pub fn profile(self, profile: BuildProfile) -> Self

Sets the build profile.

pub fn bin(self, name: impl Into<String>) -> Self

Build a specific binary by name.

pub fn lib(self) -> Self

Build the library.

pub fn example(self, name: impl Into<String>) -> Self

Build a specific example.

pub fn all_bins(self) -> Self

Build all binaries.

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

Enable a specific feature.

pub fn features(self, features: Vec<String>) -> Self

Enable multiple features.

pub fn all_features(self) -> Self

Enable all features.

pub fn no_default_features(self) -> Self

Disable default features.

pub fn copy_to_hero_bin(self) -> Self

Copy the built binary to ~/hero/bin after successful build. Removes existing file at destination before copying.

pub fn output_dir<P: AsRef<Path>>(self, path: P) -> Self

Set a custom output directory for copying (instead of /hero/bin). Tilde () in paths will be expanded to home directory.

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

Add extra arguments to pass to cargo.

pub fn verbose(self) -> Self

Enable verbose output.

pub fn discover(&mut self) -> BuilderResult<&CargoMetadata>

Discovers Cargo.toml and parses metadata. Called automatically by build() if not called explicitly.

pub fn cargo_toml_path(&self) -> Option<&Path>

Returns the path to Cargo.toml (after discovery).

pub fn project_root(&self) -> Option<&Path>

Returns the project root directory (parent of Cargo.toml).

pub fn metadata(&self) -> Option<&CargoMetadata>

Returns parsed cargo metadata (after discovery).

pub fn list_binaries(&mut self) -> BuilderResult<Vec<BinaryTarget>>

Lists all available binaries in the project.

pub fn build(self) -> BuilderResult<BuildResult>

Executes the build with configured options.

Trait Implementations

impl Clone for RustBuilder

fn clone(&self) -> RustBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RustBuilder

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

Formats the value using the given formatter.

impl Default for RustBuilder

fn default() -> Self

Returns the “default value” for a type.