Struct Cargo 

pub struct Cargo { /* private fields */ }

Available on crate feature cargo only.

Configure the emission of VERGEN_CARGO_* instructions

NOTE - All cargo instructions are considered deterministic. If you change the version of cargo you are compiling with, these values should change if being used in the generated binary.

Variable	Sample
VERGEN_CARGO_DEBUG	true
VERGEN_CARGO_FEATURES	git,build
VERGEN_CARGO_OPT_LEVEL	1
VERGEN_CARGO_TARGET_TRIPLE	x86_64-unknown-linux-gnu

Example

Emit all of the cargo instructions

fn main() -> Result<()> {
    temp_env::with_vars([
        ("CARGO_FEATURE_BUILD", Some("")),
        ("DEBUG", Some("true")),
        ("OPT_LEVEL", Some("1")),
        ("TARGET", Some("x86_64-unknown-linux-gnu"))
    ], || {
        let cargo = Cargo::all_cargo();
        Emitter::default().add_instructions(&cargo)?.emit()?;
    });

Emit some of the cargo instructions

    temp_env::with_vars([
        ("OPT_LEVEL", Some("1")),
        ("TARGET", Some("x86_64-unknown-linux-gnu"))
    ], || {
        let cargo = Cargo::builder().opt_level(true).build();
        Emitter::default().add_instructions(&cargo)?.emit()?;
    });

Override output with your own value

fn main() -> Result<()> {
    temp_env::with_vars([
        ("CARGO_FEATURE_BUILD", Some("")),
        ("VERGEN_CARGO_DEBUG", Some("my own debug value")),
        ("OPT_LEVEL", Some("1")),
        ("TARGET", Some("x86_64-unknown-linux-gnu"))
     ], || {
         let cargo = Cargo::all_cargo();
         Emitter::default().add_instructions(&cargo)?.emit()?;
     });

Implementations

impl Cargo

pub fn builder() -> CargoBuilder

Create an instance of Cargo using the builder syntax

impl Cargo

pub fn all_cargo() -> Cargo

Emit all of the VERGEN_CARGO_* instructions

pub fn all_cargo_builder() -> CargoBuilder<SetTargetTriple<SetOptLevel<SetFeatures<SetDebug>>>>

Emit all of the VERGEN_CARGO_* instructions and return the builder

Trait Implementations

impl Add for Cargo

fn add_map_entries( &self, _idempotent: bool, cargo_rustc_env: &mut BTreeMap<VergenKey, String>, _cargo_rerun_if_changed: &mut Vec<String>, _cargo_warning: &mut Vec<String>, ) -> Result<(), Error>

Try to add instructions entries to the various given arguments.

fn add_default_entries( &self, config: &DefaultConfig, cargo_rustc_env_map: &mut BTreeMap<VergenKey, String>, _cargo_rerun_if_changed: &mut Vec<String>, cargo_warning: &mut Vec<String>, ) -> Result<(), Error>

Based on the given configuration, emit either default idempotent output or generate a failue.

impl Clone for Cargo

fn clone(&self) -> Cargo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cargo

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

Formats the value using the given formatter.

impl PartialEq for Cargo

fn eq(&self, other: &Cargo) -> 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 Copy for Cargo

impl StructuralPartialEq for Cargo