json-template 0.9.5

A simple library for creating JSON templates.
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

//! Context module.

use std::path::PathBuf;

use serde_json::Value;

use crate::{Deserializer, Functions, GetDot, Placeholder, JSON};

/// Deserialization context.
#[derive(Default, Clone)]
pub struct Context {
    /// JSON data.
    data: Value,
    /// Directory.
    directory: Option<PathBuf>,
    /// Functions.
    functions: Functions,
    /// JSON data being resolved.
    current: Value
}

impl Context {
     /// Create a new template.
     pub fn new() -> Self {
        Self::default()
    }

    /// Set data.
    pub fn with_data(mut self, data: Value) -> Self {
        self.data = data.into();
        self
    }

    /// Set data.
    pub fn set_data(&mut self, data: Value) -> &mut Self {
        self.data = data.into();
        self
    }

    /// Get data.
    pub fn data(&self) -> &Value {
        &self.data
    }

    /// Set function.
    pub fn set_function(&mut self, name: impl AsRef<str>, function: impl Fn(&Deserializer, &Context, &Placeholder) -> serde_json::Result<Value> + 'static) -> &mut Self {
        self.functions.register(name, function);
        self
    }

    /// Set function.
    pub fn with_function(mut self, name: impl AsRef<str>, function: impl Fn(&Deserializer, &Context, &Placeholder) -> serde_json::Result<Value> + 'static) -> Self {
        self.set_function(name, function);
        self
    }

    /// Get functions.
    pub fn functions(&self) -> &Functions {
        &self.functions
    }

    /// Override data.
    pub fn with_override(mut self, new_value: Value) -> Self {
        self.override_data(new_value);
        self
    }

    /// Override data.
    pub fn override_data(&mut self, new_value: Value) -> &mut Self {
        self.data.override_recursive(new_value);
        self
    }

    /// Add data.
    pub fn with_additional_data(mut self, new_value: Value) -> Self {
        self.add_data(new_value);
        self
    }

    /// Add data.
    pub fn add_data(&mut self, new_value: Value) -> &mut Self {
        self.data.add_recursive(new_value);
        self
    }

    /// Set directory.
    pub fn with_directory(mut self, directory: Option<PathBuf>) -> Self {
        self.directory = directory;
        self
    }

    /// Set directory.
    pub fn set_directory(&mut self, directory: Option<PathBuf>) -> &mut Self {
        self.directory = directory;
        self
    }

    /// Get directory.
    pub fn directory(&self) -> Option<&PathBuf> {
        self.directory.as_ref()
    }

    pub(crate) fn set_current_data(&mut self, current: Value) {
        self.current = current;
    }

    /// Find placeholder value.
    pub fn find(&self, deserializer: &Deserializer, placeholder: &Placeholder) -> serde_json::Result<Value> {
        self
            .data
            .get_dot_deserializing(placeholder.path(), deserializer, self)
            .or_else(|_| self.current.get_dot_deserializing(placeholder.path(), deserializer, self))
    }
}