Struct VersionReport 

pub struct VersionReport {
    pub declared: String,
    pub tool: String,
    pub agree: bool,
    pub last_release: Option<String>,
    pub bump: String,
    pub commits_imply: Option<String>,
    pub next: Option<String>,
    pub decided_by: DecidedBy,
    pub contract_unreadable: Option<String>,
    pub changes: Vec<Change>,
}

What the version is, what the public contract requires it to become, and what the commits since the last release say about themselves.

next is the contract’s answer (ADR 0051): the analysis’ required_version, or the smallest release above the last when that requirement is the last release itself. The commit inference is evidence — bump and commits_imply — and never the answer: when the contract cannot be measured next is absent, decided_by is undecided and contract_unreadable says why. The selection is crate::release::version::select, the one function release bump also takes its default target from.

Fields

declared: String

The version the crate manifest declares — the one place it is authored.

tool: String

The version bin/majordomus prints: what its projection, share/version.txt, states.

agree: bool

Whether that projection is current. generate --check refuses a stale one and scripts/release-version --check proves the tool prints it; this is the same question asked by the executable, so every surface can show the answer.

last_release: Option<String>

The last release: the highest version the layer records (the newest version tag when it records none) — the baseline release analyze measures the contract from, so the contract and the commit evidence describe one window.

bump: String

What the commit subjects since it imply: major, minor, patch, or none. Evidence only — the contract decides next; release analyze reports where the two disagree.

commits_imply: Option<String>

The version that bump would produce from the last release (from the declared version when nothing was released yet). Evidence only, even when the contract cannot answer.

next: Option<String>

The next version. When the contract could be measured, the version it requires: the declared version when that already satisfies it, otherwise the smallest one it allows — and, when that is the last release itself, the smallest release above it. Absent when nothing would be released, and when the contract could not be measured (decided_by: undecided): an unmeasurable baseline is refused, not guessed.

decided_by: DecidedBy

Who answered next.

contract_unreadable: Option<String>

Why the contract could not answer, when decided_by is undecided.

changes: Vec<Change>

How many commits since the last release, and of what kind — the evidence for the bump, so that a surprising answer can be checked rather than believed.

Trait Implementations

impl Clone for VersionReport

fn clone(&self) -> VersionReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VersionReport

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VersionReport

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for VersionReport

impl JsonSchema for VersionReport

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for VersionReport

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for VersionReport

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 VersionReport