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§