idiolect-records 0.9.0

// @generated by idiolect-codegen. do not edit.
// source: dev.panproto.schema.lensAttestation

//! Generated from `dev.panproto.schema.lensAttestation`.

#![allow(
    missing_docs,
    clippy::doc_markdown,
    clippy::struct_excessive_bools,
    clippy::derive_partial_eq_without_eq,
    clippy::large_enum_variant
)]
use serde::{Deserialize, Serialize};

/// A declaration of stance toward a lens by some party (identified by DID). Provides the minimal governance substrate: services can filter lenses by attestation, and users can see who has reviewed or deployed a given lens.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct PanprotoLensAttestation {
    pub created_at: idiolect_records::Datetime,
    /// AT-URI of the lens being attested.
    pub lens: idiolect_records::AtUri,
    /// Free-text explanation of the attestation.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub note: Option<String>,
    /// Optional scope qualifier, e.g. a service name or domain this attestation applies to.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub scope: Option<String>,
    /// The attester's declared relationship to this lens.
    pub stance: PanprotoLensAttestationStance,
    /// AT-URI of a previous attestation this one replaces.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub supersedes: Option<idiolect_records::AtUri>,
}

impl crate::Record for PanprotoLensAttestation {
    const NSID: &'static str = "dev.panproto.schema.lensAttestation";
}

/// PanprotoLensAttestationStance. Open-enum slug; known values are kebab-cased; community-extended values pass through as `Other(String)`.
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub enum PanprotoLensAttestationStance {
    Reviewed,
    Deployed,
    Endorsed,
    Contested,
    Deprecated,
    /// Community-extended slug not present in the lexicon's
    /// `knownValues`. Resolves through the sibling
    /// `*Vocab` field on the containing record.
    Other(String),
}
impl PanprotoLensAttestationStance {
    /// Wire-form slug for this value. Known variants render
    /// kebab-case; the fallback variant passes through verbatim.
    #[must_use]
    pub fn as_str(&self) -> &str {
        match self {
            Self::Reviewed => "reviewed",
            Self::Deployed => "deployed",
            Self::Endorsed => "endorsed",
            Self::Contested => "contested",
            Self::Deprecated => "deprecated",
            Self::Other(s) => s.as_str(),
        }
    }
    /// Whether this slug is subsumed by `ancestor` under the
    /// `subsumed_by` relation in the supplied vocab. Reflexive:
    /// every slug is subsumed by itself.
    #[must_use]
    pub fn is_subsumed_by(
        &self,
        vocab: &idiolect_records::vocab::VocabGraph,
        ancestor: &str,
    ) -> bool {
        vocab.is_subsumed_by(self.as_str(), ancestor)
    }
    /// Whether this slug satisfies a requirement of `target`
    /// under the named `relation` in the supplied vocab.
    /// Generalises `is_subsumed_by` to any directed relation
    /// (e.g. `stronger_than`, `provides_at_least`,
    /// `equivalent_to`). Reflexive: a slug satisfies itself.
    #[must_use]
    pub fn satisfies(
        &self,
        vocab: &idiolect_records::vocab::VocabGraph,
        relation: &str,
        target: &str,
    ) -> bool {
        if self.as_str() == target {
            return true;
        }
        vocab
            .walk_relation(self.as_str(), relation, false)
            .iter()
            .any(|n| n == target)
    }
    /// Translate this slug across vocabularies via
    /// `equivalent_to` edges. Returns the translated slug as
    /// a target enum value when a translation exists, `None`
    /// when no path is found (callers fall back to passing
    /// the slug through verbatim, which is wire-compatible).
    #[must_use]
    pub fn translate_to<T: From<String>>(
        &self,
        src_vocab_uri: &str,
        tgt_vocab_uri: &str,
        registry: &idiolect_records::vocab::VocabRegistry,
    ) -> Option<T> {
        registry
            .translate(src_vocab_uri, tgt_vocab_uri, self.as_str())
            .map(T::from)
    }
}
impl From<String> for PanprotoLensAttestationStance {
    fn from(s: String) -> Self {
        match s.as_str() {
            "reviewed" => Self::Reviewed,
            "deployed" => Self::Deployed,
            "endorsed" => Self::Endorsed,
            "contested" => Self::Contested,
            "deprecated" => Self::Deprecated,
            _ => Self::Other(s),
        }
    }
}
impl From<&str> for PanprotoLensAttestationStance {
    fn from(s: &str) -> Self {
        match s {
            "reviewed" => Self::Reviewed,
            "deployed" => Self::Deployed,
            "endorsed" => Self::Endorsed,
            "contested" => Self::Contested,
            "deprecated" => Self::Deprecated,
            _ => Self::Other(s.to_owned()),
        }
    }
}
impl serde::Serialize for PanprotoLensAttestationStance {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        serializer.serialize_str(self.as_str())
    }
}
impl<'de> serde::Deserialize<'de> for PanprotoLensAttestationStance {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: serde::Deserializer<'de>,
    {
        let s = String::deserialize(deserializer)?;
        Ok(Self::from(s))
    }
}