bubbles-dialogue 1.0.0

Lightweight engine-agnostic dialogue runtime for Rust games.
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

//! Compile-time validation of cross-node references.

use crate::compiler::ast::Stmt;
use crate::compiler::program::Program;
use crate::error::{DialogueError, Result};

/// Validates all jump and detour targets in `program` refer to existing nodes.
///
/// # Errors
/// Returns [`DialogueError::Validation`] on the first broken reference found.
pub fn validate(program: &Program) -> Result<()> {
    for variants in program.nodes.values() {
        for node in variants {
            validate_stmts(node.body.as_ref(), program)?;
        }
    }
    Ok(())
}

fn validate_stmts(stmts: &[Stmt], program: &Program) -> Result<()> {
    for stmt in stmts {
        match stmt {
            Stmt::Jump(target) | Stmt::Detour(target) if !program.node_exists(target) => {
                return Err(DialogueError::Validation(format!(
                    "reference to unknown node '{target}'"
                )));
            }
            Stmt::If {
                branches,
                else_body,
            } => {
                for b in branches {
                    validate_stmts(&b.body, program)?;
                }
                validate_stmts(else_body, program)?;
            }
            Stmt::Once {
                body, else_body, ..
            } => {
                validate_stmts(body, program)?;
                validate_stmts(else_body, program)?;
            }
            Stmt::Options(items) => {
                for item in items {
                    validate_stmts(&item.body, program)?;
                }
            }
            _ => {}
        }
    }
    Ok(())
}

#[cfg(test)]
#[path = "validate_tests.rs"]
mod tests;