endbasic-core 0.8.1

The EndBASIC programming language - core
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

// EndBASIC
// Copyright 2020 Julio Merino
//
// Licensed under the Apache License, Version 2.0 (the "License"); you may not
// use this file except in compliance with the License.  You may obtain a copy
// of the License at:
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
// License for the specific language governing permissions and limitations
// under the License.

//! Configuration file parser using an EndBASIC interpreter.
//!
//! This example sets up a minimal EndBASIC interpreter and uses it to parse what could be a
//! configuration file.  Because the interpreter is configured without any commands or functions,
//! the scripted code cannot call back into Rust land, so the script's execution is guaranteed to
//! not have side-effects.

use endbasic_core::exec::{Machine, StopReason};
use futures_lite::future::block_on;

/// Sample configuration file to parse.
const INPUT: &str = r#"
foo_value = 123
enable_bar = (foo_value > 122)
'enable_baz = "this is commented out"
"#;

fn main() {
    // Create an empty machine.
    let mut machine = Machine::default();

    // Execute the sample script.  All this script can do is modify the state of the machine itself.
    // In other words: the script can set variables in the machine's environment, but that's it.
    let result = block_on(machine.exec(&mut INPUT.as_bytes())).expect("Execution error");
    assert!(result == StopReason::Eof, "We did not register an EXIT command");

    // Now that our script has run, inspect the variables it set on the machine.
    match machine.get_var_as_int("foo_value") {
        Ok(i) => println!("foo_value is {}", i),
        Err(e) => println!("Input did not contain foo_value: {}", e),
    }
    match machine.get_var_as_bool("enable_bar") {
        Ok(b) => println!("enable_bar is {}", b),
        Err(e) => println!("Input did not contain enable_bar: {}", e),
    }
    match machine.get_var_as_string("enable_baz") {
        Ok(b) => println!("enable_bar is {}", b),
        Err(e) => println!("enable_baz is not set: {}", e),
    }
}