tiscript 0.0.3

Turing-Incomplete TypeScript as a Configuration Language
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

use std::{fs::read_to_string, path::Path};

use serde::Deserialize;

use crate::{
    util::{eval, EvalOptions},
    value::de::from_value,
};

/// Evaluate the given source code and deserialize it into a Rust deserializable object.
pub fn from_str<'de, T>(source: &str) -> Result<T, Box<dyn std::error::Error>>
where
    T: Deserialize<'de>,
{
    let value = eval(source, &EvalOptions::new(Path::new("<eval>")))?;
    let object = from_value(value)?;
    Ok(object)
}

/// Evaluate the given source code and deserialize it into a Rust deserializable object.
pub fn from_str_with_timeout<'de, T>(
    source: &str,
    timeout: std::time::Duration,
) -> Result<T, Box<dyn std::error::Error>>
where
    T: Deserialize<'de>,
{
    let value = eval(
        source,
        &EvalOptions::new_with_timeout(Path::new("<eval>"), timeout),
    )?;
    let object = from_value(value)?;
    Ok(object)
}

/// Evaluate the given source file and deserialize it into a Rust deserializable object.
pub fn from_file<'de, T>(source_file: &str) -> Result<T, Box<dyn std::error::Error>>
where
    T: Deserialize<'de>,
{
    from_path(Path::new(source_file))
}

/// Evaluate the given source file and deserialize it into a Rust deserializable object.
pub fn from_file_with_timeout<'de, T>(
    source_file: &str,
    timeout: std::time::Duration,
) -> Result<T, Box<dyn std::error::Error>>
where
    T: Deserialize<'de>,
{
    let source_file = Path::new(source_file);
    let source = read_to_string(source_file)?;
    let value = eval(
        &source,
        &EvalOptions::new_with_timeout(source_file, timeout),
    )?;
    let object = from_value(value)?;
    Ok(object)
}

/// Evaluate the given source file and deserialize it into a Rust deserializable object.
pub fn from_path<'de, T>(source_file: &Path) -> Result<T, Box<dyn std::error::Error>>
where
    T: Deserialize<'de>,
{
    let source = read_to_string(source_file)?;
    let value = eval(&source, &EvalOptions::new(source_file))?;
    let object = from_value(value)?;
    Ok(object)
}

/// Evaluate the given source file and deserialize it into a Rust deserializable object.
pub fn from_path_with_timeout<'de, T>(
    source_file: &Path,
    timeout: std::time::Duration,
) -> Result<T, Box<dyn std::error::Error>>
where
    T: Deserialize<'de>,
{
    let source = read_to_string(source_file)?;
    let value = eval(
        &source,
        &EvalOptions::new_with_timeout(source_file, timeout),
    )?;
    let object = from_value(value)?;
    Ok(object)
}