ActDim.Emitron 1.0.0

ActDim.Emitron

ActDim.Emitron is a Roslyn-powered C# scripting evaluation engine and string template interpolation compiler for .NET.

Features

• Roslyn-Based C# Script Compilation: Compile arbitrary C# code snippets or multi-statement blocks into highly efficient, reusable Func<object, T> delegates.
• Collision-Free Property Binding: Pass any anonymous object, DTO, or dictionary as input. Properties are bound safely to a dynamic parameter variable (@params by default, fully customizable).
• Template Interpolation Compiler: Parse and compile templates with embedded expression placeholders (e.g., "Hello { @params.Name }!") into fast formatting delegates (Interpolator).
• Concurrent Script Caching: Script compilation occurs once per unique tuple (code, inputParameterName, returnType). Compiled delegates are cached in memory for zero-overhead re-execution.
• Fluent String Extension Helpers: Execute template interpolation directly via template.Interpolate(input).

Installation

Install via the .NET CLI:

dotnet add package ActDim.Emitron

Or via Package Manager Console:

Install-Package ActDim.Emitron

Quick Start Examples

1. Evaluating C# Expressions

using ActDim.Emitron;

// Compile expression operating on @params
Func<object, string> greet = ScriptEngine.Compile<string>("@params.Name.ToUpper() + \"!\"");

// Execute cached delegate
string result = greet(new { Name = "world" });
Console.WriteLine(result); // Output: WORLD!

2. Multi-Statement Script Blocks

using ActDim.Emitron;

var calculateTax = ScriptEngine.Compile<decimal>("""
    var price = (decimal)@params.Price;
    var rate = (decimal)@params.TaxRate;
    var total = price * (1 + rate);
    return Math.Round(total, 2);
""");

decimal taxResult = calculateTax(new { Price = 100.00m, TaxRate = 0.20m });
Console.WriteLine(taxResult); // Output: 120.00

3. Template Interpolation

using ActDim.Emitron;
using ActDim.Emitron.Extensions;

string template = "Order #{ @params.OrderId } for { @params.Customer } is { @params.Status }.";

// Using Interpolator delegate
var formatter = Interpolator.Compile(template);
string output1 = formatter(new { OrderId = 1001, Customer = "Acme Corp", Status = "SHIPPED" });

// Using fluent string extension method
string output2 = template.Interpolate(new { OrderId = 1002, Customer = "Globex", Status = "PENDING" });

4. Custom Parameter Variable Name

using ActDim.Emitron;

// Use 'model' instead of default '@params'
var eval = ScriptEngine.Compile<int>("model.A + model.B", inputParameterName: "model");
int sum = eval(new { A = 10, B = 20 });

License

This project is licensed under the MIT License.