opys-core 0.1.14

opys manifest data model + shorthand + Val/Valset. Reference implementation of opys.json.
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use serde::{Deserialize, Serialize};
use opys_mojang_rules::{satisfies_ruleset, OsOptions, RuleError, Ruleset};

use crate::discovery::Discovery;
use crate::extract::{decode_extract, encode_extract, ExtractRule, ExtractWire};
use crate::integrity::Integrity;
use crate::shorthand::{encode_short_ruleset, parse_short_ruleset, RawRuleset, ShorthandError};
use crate::source::{decode_source, encode_source, Source, SourceWire};

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Artifact {
    pub path: String,
    pub source: Source,
    pub size: Option<u64>,
    pub rules: Ruleset,
    pub integrity: Option<Integrity>,
    pub discovery: Option<Discovery>,
    pub metadata: Option<serde_json::Value>,
    pub extract: Option<Vec<ExtractRule>>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ArtifactWire {
    pub path: String,
    pub source: SourceWire,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub size: Option<u64>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub rules: Option<RawRuleset>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub integrity: Option<Integrity>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub discovery: Option<Discovery>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub metadata: Option<serde_json::Value>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub extract: Option<ExtractWire>,
}

pub fn decode_artifact(raw: ArtifactWire) -> Result<Artifact, ShorthandError> {
    Ok(Artifact {
        path: raw.path,
        source: decode_source(raw.source),
        size: raw.size,
        rules: raw.rules.map(parse_short_ruleset).transpose()?.unwrap_or_default(),
        integrity: raw.integrity,
        discovery: raw.discovery,
        metadata: raw.metadata,
        extract: raw.extract.map(decode_extract),
    })
}

pub fn encode_artifact(u: &Artifact) -> ArtifactWire {
    ArtifactWire {
        path: u.path.clone(),
        source: encode_source(&u.source),
        size: u.size,
        rules: (!u.rules.is_empty()).then(|| encode_short_ruleset(&u.rules)),
        integrity: u.integrity.clone().map(Integrity::collapsed),
        discovery: u.discovery.clone(),
        metadata: u.metadata.clone(),
        extract: u.extract.as_deref().map(encode_extract),
    }
}

/// Deduplicate by normalized path — later entries win.
pub fn deduplicate_artifacts(artifacts: Vec<Artifact>) -> Vec<Artifact> {
    use indexmap::IndexMap;
    let mut map: IndexMap<String, Artifact> = IndexMap::new();
    for u in artifacts {
        let norm = normalize_posix(&u.path);
        map.shift_remove(&norm);
        map.insert(norm, u);
    }
    map.into_values().collect()
}

fn normalize_posix(p: &str) -> String {
    // Approximate POSIX `path.normalize` — collapse `./`, `//`, resolve `..`.
    let mut stack: Vec<&str> = Vec::new();
    let leading_slash = p.starts_with('/');
    for part in p.split('/') {
        match part {
            "" | "." => continue,
            ".." => {
                if matches!(stack.last(), Some(&prev) if prev != "..") {
                    stack.pop();
                } else if !leading_slash {
                    stack.push("..");
                }
            }
            other => stack.push(other),
        }
    }
    let joined = stack.join("/");
    if leading_slash {
        format!("/{joined}")
    } else if joined.is_empty() {
        ".".to_owned()
    } else {
        joined
    }
}

impl Artifact {
    /// True if the artifact's ruleset matches the given platform + features.
    pub fn applies(&self, os: &OsOptions, feats: &[String]) -> Result<bool, RuleError> {
        satisfies_ruleset(&self.rules, os, feats)
    }
}

/// Free-fn alias for `Artifact::applies` — kept until callers migrate.
pub fn artifact_applies(
    u: &Artifact,
    os: &OsOptions,
    feats: &[String],
) -> Result<bool, RuleError> {
    u.applies(os, feats)
}