Struct MetadataChange 

pub struct MetadataChange {
    pub field: String,
    pub old_value: Option<String>,
    pub new_value: Option<String>,
    pub kind: MetadataChangeKind,
}

A document-level metadata change between two SBOMs.

Surfaces changes that are invisible in the component/dependency/vulnerability passes: author or tool churn, timestamp updates, spec-version upgrades (e.g. CycloneDX 1.5 -> 1.7), lifecycle-phase transitions, signature presence or algorithm changes, and document- or primary-component version bumps. This is the cross-cutting metadata signal the BSI gap analysis flagged as missing.

Fields

field: String

Stable field key (e.g. name, spec_version, created, creator.tool, lifecycle_phase, signature.algorithm, primary_component_version).

old_value: Option<String>

Value in the old SBOM (None when the field was absent / added).

new_value: Option<String>

Value in the new SBOM (None when the field was removed).

kind: MetadataChangeKind

Whether the field was added, removed, or modified.

Implementations

impl MetadataChange

pub fn from_values( field: impl Into<String>, old_value: Option<String>, new_value: Option<String>, ) -> Option<Self>

Build a metadata change from a field key and the two optional values, inferring the MetadataChangeKind from presence. Returns None when the values are equal (no change to report).

Trait Implementations

impl Clone for MetadataChange

fn clone(&self) -> MetadataChange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MetadataChange

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MetadataChange

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for MetadataChange

impl PartialEq for MetadataChange

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

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 MetadataChange