Struct SchemaVersion 

pub struct SchemaVersion {
    pub value: String,
    pub from_legacy_int: bool,
}

T-265 PR-a: compose schema version. Stored as a semver string; validate-time check (validate::validate) enforces the semver shape via the semver crate.

Custom Deserialize accepts two shapes:

• YAML string (e.g. version: "2.0.0") — taken verbatim; semver shape is checked later at validate time, NOT here, so the deserializer’s job stays narrow (parse, not validate).
• YAML integer literal 2 only (the one legacy value that ever shipped in any in-tree compose) → coerced to SchemaVersion carrying "2.0.0" AND flagged from_legacy_int = true. The load orchestration in Compose::load reads that flag to decide whether to auto-rewrite the on-disk file so the integer self-heals to the semver shape (owner-ratified tg 2989 + tg 3440, “option 1 + variant A”).

Anything else — version: 1, version: 3, version: true, version: [1,2,3] — fails to deserialize with a message that names the constraint: only "X.Y.Z" or the legacy 2.

from_legacy_int is #[serde(skip)] so it never round-trips through serialize; it’s a deserialize-side signal only.

Fields

value: String

from_legacy_int: bool

Implementations

impl SchemaVersion

pub fn new(value: impl Into<String>) -> Self

Construct directly from a semver-shaped string; for fixtures and tests + the in-memory legacy coercion.

Trait Implementations

impl Clone for SchemaVersion

fn clone(&self) -> SchemaVersion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SchemaVersion

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SchemaVersion

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

Deserialize this value from the given Serde deserializer.

impl Eq for SchemaVersion

impl PartialEq for SchemaVersion

fn eq(&self, other: &SchemaVersion) -> 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 SchemaVersion

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 SchemaVersion