Struct Rustc

pub struct Rustc { /* private fields */ }

Available on crate feature rustc only.

The VERGEN_RUSTC_* configuration features

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

Variable	Sample
VERGEN_RUSTC_CHANNEL	nightly
VERGEN_RUSTC_COMMIT_DATE	2021-02-24
VERGEN_RUSTC_COMMIT_HASH	a8486b64b0c87dabd045453b6c81500015d122d6
VERGEN_RUSTC_HOST_TRIPLE	x86_64-apple-darwin
VERGEN_RUSTC_LLVM_VERSION	11.0
VERGEN_RUSTC_SEMVER	1.52.0-nightly

Example

Emit all of the rustc instructions

let rustc = RustcBuilder::all_rustc()?;
Emitter::default().add_instructions(&rustc)?.emit();

Emit some of the rustc instructions

let rustc = RustcBuilder::default().channel(true).semver(true).build()?;
Emitter::default().add_instructions(&rustc)?.emit();

Override output with your own value

temp_env::with_var("VERGEN_RUSTC_CHANNEL", Some("this is the channel I want output"), || {
    let result = || -> Result<()> {
        let rustc = RustcBuilder::default().channel(true).semver(true).build()?;
        Emitter::default().add_instructions(&rustc)?.emit();   
        Ok(())  
    }();
    assert!(result.is_ok());
});

Trait Implementations

impl Add for Rustc

fn add_map_entries( &self, _idempotent: bool, cargo_rustc_env: &mut CargoRustcEnvMap, _cargo_rerun_if_changed: &mut CargoRerunIfChanged, cargo_warning: &mut CargoWarning, ) -> Result<()>

Try to add instructions entries to the various given arguments.

fn add_default_entries( &self, config: &DefaultConfig, cargo_rustc_env_map: &mut CargoRustcEnvMap, _cargo_rerun_if_changed: &mut CargoRerunIfChanged, cargo_warning: &mut CargoWarning, ) -> Result<()>

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

impl Clone for Rustc

fn clone(&self) -> Rustc

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Rustc

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

Formats the value using the given formatter.

impl PartialEq for Rustc

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

impl StructuralPartialEq for Rustc