Struct BuildIdentity 

pub struct BuildIdentity {
    pub version: &'static str,
    pub commit: &'static str,
    pub dirty: &'static str,
    pub built_at: String,
}

The source revision this binary was built from, stamped by build.rs.

Fields

version: &'static str

Crate version. Coarse on its own — retained because it is the version an operator matches against a release, a changelog, and a crates.io page.

commit: &'static str

Full commit hash of the source tree, or "unknown" for a build with no repository (a crates.io tarball, a vendored copy, an export). Its rerun triggers are registered in the build script, so unlike Self::dirty it carries no staleness caveat.

dirty: &'static str

Whether uncommitted changes were observed when the build script last ran, or "unknown" when it could not be established.

"true" is trustworthy. "false" means “no uncommitted change was observed”, NOT “the tree was provably clean.” Cargo cannot watch a working tree, so a tree dirtied in a different workspace crate after this script ran is reported clean. Stated here rather than left for a reader to assume away — a limitation named is worth more than a boolean that is silently wrong in one direction.

built_at: String

When the build script ran, RFC 3339, or "unknown". Honours SOURCE_DATE_EPOCH, so a reproducible build gets a reproducible stamp rather than this being the one field that defeats reproducibility.

Implementations

impl BuildIdentity

pub fn current() -> Self

The identity compiled into this binary.

pub fn line(&self) -> String

The one-line form for the startup banner, so the identity is also in the log a crashed server leaves behind — not only on an endpoint that needs the server alive to answer.

Trait Implementations

impl Clone for BuildIdentity

fn clone(&self) -> BuildIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuildIdentity

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

Formats the value using the given formatter.

impl Eq for BuildIdentity

impl PartialEq for BuildIdentity

fn eq(&self, other: &BuildIdentity) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for BuildIdentity

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BuildIdentity