Struct FrameworkVersion 

pub struct FrameworkVersion { /* private fields */ }

The framework train one binary was built from, and therefore the whole of what it claims about compatibility.

Its canonical wire spelling is the SemVer string itself, e.g. 0.56.2: three decimal segments, no prefix, no padding, no pre-release or build metadata. Equality is exact, so provenance and diagnostics always name the precise train; compatibility is Self::is_compatible_with, which asks whether two versions share a CompatibilityLine.

Implementations

impl FrameworkVersion

pub const CURRENT_SPELLING: &'static str = "0.62.0"

The canonical spelling of the train this binary was built from.

The crate version is the workspace train version: [workspace.package] version sets it and exact = pins keep every internal dependency on the same train.

pub const CURRENT: Self

The train this binary was built from.

Parsed from Self::CURRENT_SPELLING during const evaluation, so a crate version this type cannot represent fails the build rather than reaching a process boundary.

pub const fn new(major: u16, minor: u16, patch: u16) -> Self

Construct one exact framework version.

pub const fn major(self) -> u16

The version’s major component.

pub const fn minor(self) -> u16

The version’s minor component.

pub const fn patch(self) -> u16

The version’s patch component.

pub const fn compatibility_line(self) -> CompatibilityLine

The SemVer line this version belongs to: pre-1.0 trains break on every minor, and a released major breaks only on the major.

The line is what decides compatibility, through Self::is_compatible_with. The version stays exact so a record or a diagnostic can still name the train a binary was built from.

pub const fn is_compatible_with(self, other: Self) -> bool

Whether a peer built from other speaks this version’s contracts.

Two trains interoperate exactly when they share a CompatibilityLine, so this is the comparison every validator makes: a launch, a bundle admission, and a client attachment all ask this question and never for equality. The exact version remains available for provenance and diagnostics.

The promise is truthful because the compatibility CI enforces it at release: the gates prove each candidate’s wire and process surfaces against the trains already published on its line, and refuse a version too small for what its contracts changed. A patch train therefore cannot carry a surface change that a peer on the same line would fail to speak.

Trait Implementations

impl Clone for FrameworkVersion

fn clone(&self) -> FrameworkVersion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for FrameworkVersion

impl Debug for FrameworkVersion

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

Formats the value using the given formatter.

impl DescribeWire for FrameworkVersion

fn wire_schema() -> WireSchema

The shape a value of this type puts on the wire.

impl<'de> Deserialize<'de> for FrameworkVersion

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for FrameworkVersion

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

Formats the value using the given formatter.

impl Eq for FrameworkVersion

impl FromStr for FrameworkVersion

type Err = FrameworkVersionError

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for FrameworkVersion

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FrameworkVersion

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for FrameworkVersion

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FrameworkVersion