dpcs 0.12.0

Reference implementation of the Data Pipeline Contract Standard (DPCS)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

//! Governance metadata (SPEC Ch 25).

use serde::{Deserialize, Serialize};

use super::ExtensionMap;

/// Declarative governance metadata attached to a Pipeline Contract.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Default)]
#[cfg_attr(feature = "jsonschema", derive(schemars::JsonSchema))]
#[serde(rename_all = "camelCase")]
pub struct GovernanceMetadata {
    /// Owning team or organization (may mirror `metadata.owner`).
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub owner: Option<String>,
    /// Governing authority when distinct from owner.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub governing_authority: Option<String>,
    /// Publication status (for example `draft`, `published`, `deprecated`).
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub publication_status: Option<String>,
    /// Publication timestamp (implementation-defined string, typically ISO-8601).
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub published_at: Option<String>,
    /// Stewardship or classification tags.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
    /// Extension fields.
    #[serde(default, flatten)]
    pub extensions: ExtensionMap,
}

/// Known publication statuses used by validators.
pub const PUBLICATION_STATUSES: &[&str] =
    &["draft", "published", "deprecated", "retired", "unpublished"];

/// Returns `true` when `status` is a recognized publication status.
pub fn is_known_publication_status(status: &str) -> bool {
    PUBLICATION_STATUSES
        .iter()
        .any(|known| known.eq_ignore_ascii_case(status.trim()))
}