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 with the version_info! macro, 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) -> Self

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>) -> Self

Fluent setter for the commit SHA.

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

Fluent setter for the build timestamp.

pub fn from_pkg_version(raw: &str) -> Self

Parse a CARGO_PKG_VERSION-shaped string, with a silent fallback to 0.0.0 when parsing fails (which in turn is flagged by Self::is_development).

Prefer the version_info! macro, which passes the calling crate’s version for you. Call this directly only when the version string comes from somewhere else — a build.rs output, say.

pub fn from_env() -> Self

👎Deprecated since 0.9.0:

returns rtb-app’s version, not the calling tool’s — env! expands where it is written. Use the rtb_app::version_info!() macro instead.

Parse rtb-app’s own CARGO_PKG_VERSION.

This is almost certainly not what you want

env! is expanded by the compiler wherever it is written — and it is written here, inside rtb-app. So this returns the version of the framework, never the version of the tool calling it. Every downstream tool using it reported rtb-app’s version as its own.

That is not merely cosmetic: crate::metadata-driven self-update verifies a freshly staged binary by checking the version it reports against the release tag it came from. A binary that misreports its version fails that check, and the update is refused.

Use the version_info! macro instead — it expands env! at your call site.

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_pkg_version 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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.