Struct Interpreter 

pub struct Interpreter { /* private fields */ }

The FiddlerScript interpreter.

Implementations

impl Interpreter

pub fn new() -> Self

Create a new interpreter with default built-in functions.

The interpreter is initialized with all current OS environment variables available as script variables.

Examples found in repository

examples/run.rs (line 130)

fn run_example(source: &str) {
    let mut interpreter = Interpreter::new();
    match interpreter.run(source) {
        Ok(_) => {}
        Err(e) => eprintln!("Error: {}", e),
    }
}

pub fn with_builtins( builtins: HashMap<String, fn(Vec<Value>) -> Result<Value, RuntimeError>>, ) -> Self

Create a new interpreter with custom built-in functions.

The interpreter is initialized with all current OS environment variables available as script variables.

pub fn new_without_env() -> Self

Create a new interpreter without loading environment variables.

pub fn parse_only(&self, source: &str) -> Result<Program, FiddlerError>

Parse FiddlerScript source without executing it.

Identical to crate::parse but provided as a method for API symmetry with Interpreter::run.

pub fn run(&mut self, source: &str) -> Result<Value, FiddlerError>

Run FiddlerScript source code.

Examples found in repository

examples/run.rs (line 131)

fn run_example(source: &str) {
    let mut interpreter = Interpreter::new();
    match interpreter.run(source) {
        Ok(_) => {}
        Err(e) => eprintln!("Error: {}", e),
    }
}

pub fn execute(&mut self, program: &Program) -> Result<Value, RuntimeError>

Execute a parsed program.

pub fn output(&self) -> &[String]

Get captured output (for testing).

pub fn clear_output(&mut self)

Clear captured output.

pub fn is_output_truncated(&self) -> bool

Check if captured output was truncated.

pub fn set_variable_value(&mut self, name: impl Into<String>, value: Value)

Set a variable by name in the global scope.

This allows external code to inject values into the interpreter before running a script.

Arguments

• name - The variable name
• value - The value to set

pub fn set_variable_bytes(&mut self, name: impl Into<String>, bytes: Vec<u8>)

Set a variable from bytes.

Convenience method to set a variable with byte data.

Arguments

• name - The variable name
• bytes - The byte data

pub fn set_variable_string( &mut self, name: impl Into<String>, value: impl Into<String>, )

Set a variable from a string.

Convenience method to set a variable with string data.

Arguments

• name - The variable name
• value - The string value

pub fn set_variable_int(&mut self, name: impl Into<String>, value: i64)

Set a variable from an integer.

Convenience method to set a variable with an integer value.

Arguments

• name - The variable name
• value - The integer value

pub fn set_variable_array( &mut self, name: impl Into<String>, values: Vec<Value>, )

Set a variable as an array.

Convenience method to set a variable with an array value.

Arguments

• name - The variable name
• values - The array values

pub fn set_variable_dict( &mut self, name: impl Into<String>, values: IndexMap<String, Value>, )

Set a variable as a dictionary.

Convenience method to set a variable with a dictionary value.

Arguments

• name - The variable name
• values - The dictionary values

pub fn get_value(&self, name: &str) -> Option<Value>

Get a variable by name, returning the Value type.

Searches all scopes from innermost to outermost.

Arguments

• name - The variable name

Returns

• Some(Value) if the variable exists
• None if the variable is not defined

pub fn get_bytes(&self, name: &str) -> Option<Vec<u8>>

Get a variable by name as bytes.

Converts the variable value to its byte representation.

Arguments

• name - The variable name

Returns

• Some(Vec<u8>) if the variable exists
• None if the variable is not defined

pub fn has_variable(&self, name: &str) -> bool

Check if a variable exists.

Arguments

• name - The variable name

Returns

• true if the variable exists in any scope
• false otherwise

Trait Implementations

impl Default for Interpreter

fn default() -> Self

Returns the “default value” for a type.