Struct escargot::CargoBuild

pub struct CargoBuild { /* fields omitted */ }

The build subcommand.

Example

escargot::CargoBuild::new()
    .bin("bin_fixture")
    .current_release()
    .current_target()
    .exec()
    .unwrap();

Methods

impl CargoBuild

pub fn new() -> Self

Shortcut to create a build subcommand.

See also Cargo.

Example

escargot::CargoBuild::new()
    .exec()
    .unwrap();

pub fn package<S: AsRef<OsStr>>(self, name: S) -> Self

Build from name package in workspaces.

Example

escargot::CargoBuild::new()
    .package("escargot")
    .bin("bin_fixture")
    .exec()
    .unwrap();

pub fn bin<S: AsRef<OsStr>>(self, name: S) -> Self

Build only name binary.

Example

escargot::CargoBuild::new()
    .bin("bin_fixture")
    .exec()
    .unwrap();

pub fn example<S: AsRef<OsStr>>(self, name: S) -> Self

Build only name example.

Example

escargot::CargoBuild::new()
    .example("example_fixture")
    .exec()
    .unwrap();

pub fn manifest_path<S: AsRef<OsStr>>(self, path: S) -> Self

Path to Cargo.toml

pub fn release(self) -> Self

Build artifacts in release mode, with optimizations.

pub fn current_release(self) -> Self

Build artifacts in release mode if the current process has, with optimizations.

pub fn target<S: AsRef<OsStr>>(self, triplet: S) -> Self

Build for the target triplet.

pub fn current_target(self) -> Self

Build for the current process' triplet.

pub fn target_dir<S: AsRef<OsStr>>(self, dir: S) -> Self

Directory for all generated artifacts

pub fn all_features(self) -> Self

Activate all available features

pub fn no_default_features(self) -> Self

Do not activate the default feature

pub fn features<S: AsRef<OsStr>>(self, features: S) -> Self

Space-separated list of features to activate

pub fn arg<S: AsRef<OsStr>>(self, arg: S) -> Self

Manually pass an argument that is unsupported.

Caution: Passing in -- can throw off the API.

pub fn exec(self) -> CargoResult<MessageIter>

Build the configured target, returning compiler messages.

pub fn run(self) -> CargoResult<CargoRun>

Provide a proxy for running the built target.

Example

let run = escargot::CargoBuild::new()
    .bin("bin_fixture")
    .current_release()
    .current_target()
    .run()
    .unwrap();
println!("artifact={}", run.path().display());

Trait Implementations

impl Default for CargoBuild

fn default() -> Self

Returns the "default value" for a type.