opys-core 0.1.13

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

use base64::Engine;
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(tag = "kind", rename_all = "lowercase")]
pub enum Source {
    Url { url: String },
    File { file: String },
    String { string: String },
    Bytes { bytes: String },
    Pointer { pointer: String },
}

impl Source {
    /// Construct a `Bytes` source from raw bytes, base64-encoding for transit.
    pub fn from_bytes(bytes: &[u8]) -> Self {
        Source::Bytes {
            bytes: base64::engine::general_purpose::STANDARD.encode(bytes),
        }
    }
}

/// Wire shape — discriminated by which field is present, NOT by a `kind` tag.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum SourceWire {
    Url { url: String },
    File { file: String },
    String { string: String },
    Bytes { bytes: String },
    Pointer { pointer: String },
}

pub fn decode_source(raw: SourceWire) -> Source {
    match raw {
        SourceWire::Url { url } => Source::Url { url },
        SourceWire::File { file } => Source::File { file },
        SourceWire::String { string } => Source::String { string },
        SourceWire::Bytes { bytes } => Source::Bytes { bytes },
        SourceWire::Pointer { pointer } => Source::Pointer { pointer },
    }
}

pub fn encode_source(source: &Source) -> SourceWire {
    match source {
        Source::Url { url } => SourceWire::Url { url: url.clone() },
        Source::File { file } => SourceWire::File { file: file.clone() },
        Source::String { string } => SourceWire::String {
            string: string.clone(),
        },
        Source::Bytes { bytes } => SourceWire::Bytes {
            bytes: bytes.clone(),
        },
        Source::Pointer { pointer } => SourceWire::Pointer {
            pointer: pointer.clone(),
        },
    }
}