Struct BuildOutput

pub struct BuildOutput {
    pub library_paths: Vec<PathBuf>,
    pub library_links: Vec<String>,
    pub linker_args: Vec<(LinkArgTarget, String)>,
    pub cfgs: Vec<String>,
    pub check_cfgs: Vec<String>,
    pub env: Vec<(String, String)>,
    pub metadata: Vec<(String, String)>,
    pub rerun_if_changed: Vec<PathBuf>,
    pub rerun_if_env_changed: Vec<String>,
    pub log_messages: Vec<(Severity, String)>,
}

Contains the parsed output of a custom build script.

Fields

library_paths: Vec<PathBuf>

Paths to pass to rustc with the -L flag.

library_links: Vec<String>

Names and link kinds of libraries, suitable for the -l flag.

linker_args: Vec<(LinkArgTarget, String)>

Linker arguments suitable to be passed to -C link-arg=<args>

cfgs: Vec<String>

Various --cfg flags to pass to the compiler.

check_cfgs: Vec<String>

Various --check-cfg flags to pass to the compiler.

env: Vec<(String, String)>

Additional environment variables to run the compiler with.

metadata: Vec<(String, String)>

Metadata to pass to the immediate dependencies.

rerun_if_changed: Vec<PathBuf>

Paths to trigger a rerun of this build script. May be absolute or relative paths (relative to package root).

rerun_if_env_changed: Vec<String>

Environment variables which, when changed, will cause a rebuild.

log_messages: Vec<(Severity, String)>

Errors and warnings generated by this build.

These are only displayed if this is a “local” package, -vv is used, or there is a build error for any target in this package. Note that any log message of severity Error will by itself cause a build error, and will cause all log messages to be displayed.

Implementations

impl BuildOutput

pub fn parse_file( path: &Path, library_name: Option<String>, pkg_descr: &str, script_out_dir_when_generated: &Path, script_out_dir: &Path, nightly_features_allowed: bool, targets: &[Target], msrv: &Option<RustVersion>, ) -> CargoResult<BuildOutput>

Like BuildOutput::parse but from a file path.

pub fn parse( input: &[u8], library_name: Option<String>, pkg_descr: &str, script_out_dir_when_generated: &Path, script_out_dir: &Path, nightly_features_allowed: bool, targets: &[Target], msrv: &Option<RustVersion>, ) -> CargoResult<BuildOutput>

Parses the output instructions of a build script.

• pkg_descr — for error messages
• library_name — for determining if RUSTC_BOOTSTRAP should be allowed

pub fn parse_rustc_flags( value: &str, whence: &str, ) -> CargoResult<(Vec<PathBuf>, Vec<String>)>

Parses cargo::rustc-flags instruction.

pub fn parse_rustc_env( value: &str, whence: &str, ) -> CargoResult<(String, String)>

Parses cargo::rustc-env instruction.

Trait Implementations

impl Clone for BuildOutput

fn clone(&self) -> BuildOutput

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BuildOutput

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

Formats the value using the given formatter.

impl Default for BuildOutput

fn default() -> BuildOutput

Returns the “default value” for a type.

impl Hash for BuildOutput

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for BuildOutput

fn cmp(&self, other: &BuildOutput) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for BuildOutput

fn eq(&self, other: &BuildOutput) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for BuildOutput

fn partial_cmp(&self, other: &BuildOutput) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for BuildOutput

impl StructuralPartialEq for BuildOutput

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 240 bytes