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

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct ExtractPick {
    pub file: String,
    pub into: String,
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct ExtractScan {
    pub matches: String,
    pub into: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub strip: Option<Vec<String>>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub includes: Option<Vec<String>>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub excludes: Option<Vec<String>>,
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct ExtractDump {
    pub into: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub clean: Option<bool>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub includes: Option<Vec<String>>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub excludes: Option<Vec<String>>,
}

/// A single extract rule, discriminated structurally on the wire (which
/// field is present: `file` → Pick, `matches` → Scan, otherwise Dump).
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum ExtractRule {
    Pick(ExtractPick),
    Scan(ExtractScan),
    Dump(ExtractDump),
}

/// Wire form: one rule or many. Decoding flattens both into `Vec<ExtractRule>`;
/// encoding emits the bare object when the list has exactly one entry.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum ExtractWire {
    One(ExtractRule),
    Many(Vec<ExtractRule>),
}

pub fn decode_extract(raw: ExtractWire) -> Vec<ExtractRule> {
    match raw {
        ExtractWire::One(r) => vec![r],
        ExtractWire::Many(v) => v,
    }
}

pub fn encode_extract(rules: &[ExtractRule]) -> ExtractWire {
    if rules.len() == 1 {
        ExtractWire::One(rules[0].clone())
    } else {
        ExtractWire::Many(rules.to_vec())
    }
}