Crate rustc_version

Expand description

Simple library for getting the version information of a rustc compiler.

This can be used by build scripts or other tools dealing with Rust sources to make decisions based on the version of the compiler.

It calls $RUSTC --version -v and parses the output, falling back to rustc if $RUSTC is not set.

§Example

// This could be a cargo build script

use rustc_version::{version, version_meta, Channel, Version};

// Assert we haven't travelled back in time
assert!(version().unwrap().major >= 1);

// Set cfg flags depending on release channel
match version_meta().unwrap().channel {
    Channel::Stable => {
        println!("cargo:rustc-cfg=RUSTC_IS_STABLE");
    }
    Channel::Beta => {
        println!("cargo:rustc-cfg=RUSTC_IS_BETA");
    }
    Channel::Nightly => {
        println!("cargo:rustc-cfg=RUSTC_IS_NIGHTLY");
    }
    Channel::Dev => {
        println!("cargo:rustc-cfg=RUSTC_IS_DEV");
    }
}

// Check for a minimum version
if version().unwrap() >= Version::parse("1.4.0").unwrap() {
    println!("cargo:rustc-cfg=compiler_has_important_bugfix");
}

Structs§

LlvmVersion
LLVM version
Version
SemVer version as defined by https://semver.org.
VersionMeta
Rustc version plus metadata like git short hash and build date.

Enums§

Channel
Release channel of the compiler.
Error
The error type for this crate.
LlvmVersionParseError
LLVM Version Parse Error

Functions§

version
Returns the rustc SemVer version.
version_meta
Returns the rustc SemVer version and additional metadata like the git short hash and build date.
version_meta_for
Parses a “rustc -vV” output string and returns the SemVer version and additional metadata like the git short hash and build date.

Type Aliases§