Module version 

Version comparison utility for git describe format version strings.

Supports comparing versions like:

• v0.9.46 (tagged releases)
• v0.9.46-5-gabc123 (development builds with commits ahead)
• v0.9.46-5-gabc123-dirty (dirty working tree)

When versions contain different git hashes, GitHub API is used to check ancestry relationships. The API client is created internally with no authentication for public repository access.

Structs

BuildAttributes

Compile-time build provenance attributes.

BuildTimestamp

Build timestamp parsed from Unix epoch seconds.

CompareResponse 🔒

Response from GitHub’s compare API.

GitVersion

A parsed git describe version string.

PullRequestInfo

Pull request metadata captured at build time.

Version

Complete compile-time version metadata for display.

Enums

BuildKind

Build flavor captured from Cargo features.

VersionComparison

Result of comparing two versions.

VersionError

Errors that can occur during version parsing or comparison.

Functions

check_ancestry 🔒

Checks commit ancestry using GitHub’s compare API.

compare_semver

Compares semantic versions (major, minor, patch) between two versions.

get_build_attributes

Returns compile-time build provenance attributes.

get_build_kind 🔒

get_current_version

Returns the current application version from compile-time environment.

get_version

Returns complete compile-time version metadata for display.

parse_semver 🔒