kataru 0.1.14

Kataru - the YAML-based dialogue engine for game development.
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

use super::{
    Branches, Choices, Command, Dialogue, Map, PositionalCommand, RawChoices, RawCommand, State,
};
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Call {
    #[serde(rename = "call")]
    pub passage: String,
}

#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Return {
    pub r#return: (),
}

#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SetCommand {
    pub set: State,
}

#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Input {
    #[serde(default)]
    pub timeout: f64,
    pub input: Map<String, String>,
}

/// Internal representation of a line used for deserializing YAML.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
#[serde(untagged)]
pub enum RawLine {
    Branches(Branches),
    SetCommand(SetCommand),
    Input(Input),
    Choices(RawChoices),
    Command(RawCommand),
    PositionalCommand(PositionalCommand),
    Call(Call),
    Return(Return),
    Text(String),
    Dialogue(Map<String, String>),
}

/// Public interface for a line in a Kataru script.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub enum Line {
    Choices(Choices),
    InvalidChoice,
    Dialogue(Dialogue),
    Input(Input),
    Command(Command),
    End,
}

/// All lines take up 1 except for branches,
/// which need their length recursively computed.
pub fn line_len(lines: &[RawLine]) -> usize {
    let mut length = 0;
    for line in lines {
        match &line {
            RawLine::Branches(branches) => length += branches.line_len(),
            RawLine::Choices(choices) => length += choices.line_len(),
            _ => length += 1,
        }
    }
    length
}