CelExpression

Cel.CelExpression is a one-call entry point: it parses, type-checks, and returns a reusable CompiledProgram.

Signature

namespace DotnetCel;

public static class CelExpression
{
    public static CompiledProgram Compile(string source, CelEnv env);
}

Behaviour

• Parses source using the env’s macros (standard set + any contributed by extensions).
• Type-checks the resulting AST against env’s declared variables, functions, type provider, and container.
• Returns a CompiledProgram if both phases succeed.
• Throws DotnetCel.Diagnostics.CelCompileException (with the full diagnostic list) if either phase fails.

Example

using DotnetCel;
using DotnetCel.Types;

var env = CelEnv.NewBuilder()
    .Variable("x", CelTypes.Int)
    .Build();

var program = CelExpression.Compile("x * 2 + 1", env);

Console.WriteLine(program.Eval(new Dictionary<string, object?> { ["x"] = 7 }));
// 15

Diagnostics

try
{
    var p = CelExpression.Compile("undeclared_var * 2", env);
}
catch (CelCompileException ex)
{
    foreach (var d in ex.Diagnostics)
    {
        Console.WriteLine($"{d.Line}:{d.Column} {d.Severity} {d.Message}");
    }
}

Diagnostics is an ImmutableArray<Diagnostic>. Each carries a line, column, severity, and message.

See also

• CelEnv — the environment passed in.
• CompiledProgram — what comes out.