XCode

Here is an example of using the provided scripting engine to perform a series of operations. We'll demonstrate how to use some of the classes and functions defined in the Progressive.XCode namespace:

1. Initialization of Contexts and Trees: First, let's create some global and local trees, and a context to work within this engine.

using Progressive.XCode;
using System;

public class ExampleScript
{
    public static void Main()
    {
        // Create global and local trees
        XTree globalTree = new XTree();
        XTree localTree = new XTree();

        // Set some variables in global tree
        globalTree.map["globalVariable"] = "Global Value";

        // Create a context with global and local trees
        XContext context = new XContext(globalTree, localTree);

        // Set some variables in the local context
        context.Set("localVariable", "Local Value");

        // Output the set variables
        Console.WriteLine("Global Variable: " + context.Get(".globalVariable"));
        Console.WriteLine("Local Variable: " + context.Get("localVariable"));
    }
}

2. Fill-In Strings: Use the FillIn function to replace variables in a string template.

string template = "Hello, ${user}. Welcome to $(globalVariable)!";
XTree userTree = new XTree();
userTree.map["user"] = "Alice";

// Create a context with a merged tree for fill-in
XContext mergeContext = new XContext(globalTree, userTree);

string message = XHelper.FillIn(template, mergeContext);
Console.WriteLine(message); // Output: Hello, Alice. Welcome to Global Value!

3. Evaluate Expressions: Evaluate a mathematical expression using XExpression.

string expressionToEvaluate = "5 * $(value1) + $(value2)";
localTree.map["value1"] = 3;
localTree.map["value2"] = 4;

object result = XExpression.Eval(expressionToEvaluate, context);
Console.WriteLine("Expression Result: " + result); // Output: Expression Result: 19

4. Conditional Statements and Iterations: Use scripting commands to create conditional logic and loops.

Here's a functional script file example.dba:

# example.dba

let $x := 0

while $x < 5
    echo "Counting: $($x)"
    let $x := $x + 1
/endwhile

if $x == 5
    echo "Reached five!"
/if

To execute this script using the engine:

public class ExecuteScript
{
    public static void Main()
    {
        XTree globalTree = new XTree();
        XContext context = new XContext(globalTree);

        string script = @"
let $x := 0

while $x < 5
    echo ""Counting: $($x)""
    let $x := $x + 1
/endwhile

if $x == 5
    echo ""Reached five!""
/if
";

        using (var writer = new StringWriter())
        {
            XMachine machine = new XMachine("example", script, writer, context);
            machine.Run();
            Console.WriteLine(writer.ToString());
        }
    }
}

This code initializes a simple script using the engine's functionality, prints counting values up to 5, and then confirms the count in a conditional.

These examples demonstrate how to use various components of the script engine to perform dynamic operations, variable handling, and control flow logic. Adjust the example data and script paths according to your environment and requirements.

Edit