RuleScript.Core 1.10.1

RuleScript

RuleScript is a lightweight, embeddable .NET 8 scripting engine for rule-oriented workflows, automation, validation, JSON processing, and host-controlled execution.

It provides a lexer, parser, AST, interpreter, built-in functions, user functions, project imports, Host Function integration, HostTrigger runtimes, runtime diagnostics, and debugger APIs without exposing a full general-purpose programming language.

Installation

Install the stable package from NuGet:

dotnet add package RuleScript.Core --version 1.10.1

Quick Start

using RuleScript.Core.Runtime;

var engine = new RuleScriptEngine();
var context = new RuntimeContext();

context.Set("Name", "Mick");
context.Set("Distance", 519);

engine.Execute("""
    var message = "Hello " + Name;

    if Distance > 500 then:
        result = message + ": NG";
    else:
        result = message + ": OK";
    endif
    """, context);

Console.WriteLine(context.Get<string>("result"));

Run a project file:

var engine = new RuleScriptEngine
{
    WorkingDirectory = @"C:\rules"
};

var context = engine.ExecuteFile("main"); // Resolves main.rules

Register a Host Function:

engine.RegisterFunction("GetDistance", _ => 519);

var context = engine.Execute("result = GetDistance();");

Start a long-running HostTrigger runtime:

var engine = new RuleScriptEngine
{
    ExecutionTimeoutEnabled = false
};

var runtime = engine.CreateRuntime("""
    @HostTrigger("LotArrived")
    function OnLotArrived(lotId: string) -> void:
        Print("lot arrived: " + lotId);
        return;
    endfunction

    parallel:
        trigger task:
            dispatch;
        endtask
    endparallel
    """);

var running = runtime.StartAsync();

await runtime.TriggerAsync("LotArrived", ["LOT-001"]);
await runtime.StopAsync();
await running;

Documentation

Detailed syntax, Host integration, debugging, analysis, and version-specific behavior are maintained in the RuleScript Wiki.

• Getting Started
• Language Guide
• Built-in Function Reference
• Host Integration
• Debugging and Analysis
• API Reference by Class
• v1.10.1 release notes
• v1.10.1 API reference
• v1.10.0 release notes
• v1.9.0 release notes
• v1.8.0 maintenance notes
• v1.7.0 release notes

Development

The latest stable source is available on main. See the v1.10.1 release notes for source-file-aware analysis imports. See the v1.10.0 release notes for HostTrigger runtimes and long-running dispatch.

dotnet build RuleScript.sln
dotnet test RuleScript.sln

License

RuleScript is licensed under the MIT License.