Struct SubdomainBaselineDiff 

pub struct SubdomainBaselineDiff {
    pub domain: String,
    pub baseline_recorded_at: Option<DateTime<Utc>>,
    pub added: Vec<String>,
    pub removed: Vec<String>,
    pub unchanged_count: usize,
    pub baseline_missing: bool,
    pub baseline_truncated: bool,
}

A report of how a fresh enumeration differs from the stored baseline.

Produced by SubdomainBaselines::diff; rendered by the human/markdown formatters and serialized directly for JSON/YAML output.

Fields

domain: String

The domain compared.

baseline_recorded_at: Option<DateTime<Utc>>

When the baseline was recorded (None when no baseline exists).

added: Vec<String>

Names present now but absent from the baseline (the material change).

removed: Vec<String>

Names in the baseline but absent from the fresh enumeration. Informational only — see the module docs for why removals don’t count as material.

unchanged_count: usize

Number of names present in both the baseline and the fresh set.

baseline_missing: bool

True when no baseline was stored for this domain (first run). The added/removed lists are empty in that case so callers keying the exit code off Self::has_new_names exit 0 on a first run.

baseline_truncated: bool

True when the baseline was recorded only from truncated enumerations. added is still listed, but those names may simply be ones the truncated run never saw, so they are not material until a complete run has been recorded.

Implementations

impl SubdomainBaselineDiff

pub fn has_new_names(&self) -> bool

True when at least one new name appeared since a complete baseline. Callers (CLI/cron) use this to drive a non-zero exit code. Removals never make this true — see the module docs — and neither do names “added” relative to a truncated baseline (a certspotter fallback that hit its page cap), which the next complete run would otherwise report wholesale as new.

pub fn between( domain: &str, baseline: Option<&SubdomainBaseline>, fresh: &[String], ) -> Self

Diffs a fresh enumeration against an optional stored baseline.

With no baseline, returns an empty diff flagged baseline_missing — a first run has nothing to compare against and must not alert.

Trait Implementations

impl Clone for SubdomainBaselineDiff

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubdomainBaselineDiff

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SubdomainBaselineDiff

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SubdomainBaselineDiff

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.