Struct VersionInfo 

pub struct VersionInfo {
    pub version: Version,
    pub commit: Option<String>,
    pub date: Option<String>,
}

Version information captured at build time.

Populate the version field from env!("CARGO_PKG_VERSION") (the VersionInfo::from_env helper does this) and inject commit / date via your build.rs (the vergen or built crates are canonical).

Fields

version: Version

Parsed semantic version.

commit: Option<String>

Short commit SHA, if known at build time.

date: Option<String>

ISO-8601 build timestamp, if known at build time.

Implementations

impl VersionInfo

pub const fn new(version: Version) -> VersionInfo

Construct from a parsed semver. commit and date start unset — add them with Self::with_commit / Self::with_date.

pub fn with_commit(self, commit: impl Into<String>) -> VersionInfo

Fluent setter for the commit SHA.

pub fn with_date(self, date: impl Into<String>) -> VersionInfo

Fluent setter for the build timestamp.

pub fn from_env() -> VersionInfo

Convenience: parse CARGO_PKG_VERSION with a silent fallback to 0.0.0 when parsing fails (which in turn is flagged by Self::is_development).

Call this inside fn main() — it’s evaluated per-invocation, not per-build.

pub fn is_development(&self) -> bool

true when this build is a development / pre-release build.

Development is any of:

• major == 0 (pre-1.0 builds are always considered development),
• a non-empty pre-release identifier (-alpha, -dev.5, …),
• version exactly 0.0.0 (the Self::from_env fallback).

Trait Implementations

impl Clone for VersionInfo

fn clone(&self) -> VersionInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VersionInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VersionInfo

fn deserialize<__D>( __deserializer: __D, ) -> Result<VersionInfo, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for VersionInfo

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.