Class ExpressionEmbeddedCodePreparer

Namespace

Utils.Parser.Expressions

Assembly

Utils.Parser.Expressions.dll

Provides the supported runtime-inline compilation facade for embedded parser semantic predicates and inline actions. It validates and transforms embedded source through the shared transformation pipeline, builds expressions that read runtime symbols from the delegate context, delegates expression compilation to IExpressionCompiler, and materializes specialized CLR lambdas in strongly typed prepared artifacts. Preparation does not execute the embedded code or capture runtime values. This facade does not generate C# source, replace the source generator, compile lexer hooks, or select the parser's overall execution strategy.

public sealed class ExpressionEmbeddedCodePreparer : IEmbeddedCodePreparer<PreparedExpressionSemanticPredicate, PreparedExpressionParserAction>

Inheritance

object

ExpressionEmbeddedCodePreparer

Implements

IEmbeddedCodePreparer<PreparedExpressionSemanticPredicate, PreparedExpressionParserAction>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

DataUtils.ToDbValue(object?)

MathEx.Clamp<T>(T, T, T, IComparer<T>)

FluentExtensions.Failure<T>(T)

FluentExtensions.IsEqualTo<T, CT>(T, CT)

FluentExtensions.IsGreaterOrEqualsThan<T, CT>(T, CT)

FluentExtensions.IsGreaterThan<T, CT>(T, CT)

FluentExtensions.IsIn<T>(T, params T[])

FluentExtensions.IsLowerOrEqualsThan<T, CT>(T, CT)

FluentExtensions.IsLowerThan<T, CT>(T, CT)

FluentExtensions.IsNotIn<T>(T, params T[])

FluentExtensions.IsNotNull<T>(T)

FluentExtensions.IsNull<T>(T)

FluentExtensions.Success<T>(T)

FluentExtensions.Test<T>(T, Func<T, bool>)

ObjectUtils.Between<T>(T, IComparer<T>, T, T)

ObjectUtils.Between<T>(T, IComparer<T>, T, T, bool, bool)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Task<Result>>, Func<Task<Result>>)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Task<Result>>, Result)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Result>, Func<Result>)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Result>, Result)

ObjectUtils.Do<T, Result>(T, Func<T, Result>, Func<Result>)

ObjectUtils.Do<T, Result>(T, Func<T, Result>, Result)

ObjectUtils.In<T>(T, params T[])

ObjectUtils.NotIn<T>(T, params T[])

Validations.ArgMustBe<T>(T, Func<T, bool>, string, string)

Validations.ArgMustNotBe<T>(T, Func<T, bool>, string, string)

Validations.Arg<T>(T, string)

Validations.ValueMustNotBeNull<T>(T, string)

Validations.Variable<T>(T, string)

Constructors

ExpressionEmbeddedCodePreparer(IExpressionCompiler, IParserEmbeddedCodeTransformer?)

Initializes the supported expression-backed runtime preparation facade.

public ExpressionEmbeddedCodePreparer(IExpressionCompiler compiler, IParserEmbeddedCodeTransformer? embeddedCodeTransformer = null)

Parameters

compiler IExpressionCompiler

Required caller-supplied compiler that converts validated transformed text into an expression tree. It is not called for unsupported categories or non-runtime targets and is called exactly once for each supported preparation.

embeddedCodeTransformer IParserEmbeddedCodeTransformer

Optional transformer run through Utils.Parser.Diagnostics.EmbeddedCode.EmbeddedCodeTransformationPipeline before compiler invocation; Instance is used when no transformer is supplied.

Exceptions

ArgumentNullException

Thrown when compiler is null.

Methods

PrepareParserAction(EmbeddedCodeSource, EmbeddedCodePreparationContext)

Prepares an ParserInlineAction for the RuntimeInlineExpression target without executing it.

public EmbeddedCodePreparationResult<PreparedExpressionParserAction> PrepareParserAction(EmbeddedCodeSource source, EmbeddedCodePreparationContext context)

Parameters

source EmbeddedCodeSource

Raw inline parser-action source and its parser metadata.

context EmbeddedCodePreparationContext

Preparation context that selects the runtime target and allowed contextual symbols.

Returns

EmbeddedCodePreparationResult<PreparedExpressionParserAction>

Unsupported for another category, PreservedNotCompiled for another target, CompilationFailed after a transformation or compilation failure, or Succeeded with a PreparedExpressionParserAction containing an Action<T> over ParserActionExecutionContext. The shared pipeline transforms the source before runtime-bound symbol expressions are passed to the compiler. A non-void expression is normalized to an action whose value is ignored, and the resulting delegate is not invoked during preparation.

PrepareSemanticPredicate(EmbeddedCodeSource, EmbeddedCodePreparationContext)

Prepares a SemanticPredicate for the RuntimeInlineExpression target without evaluating it.

public EmbeddedCodePreparationResult<PreparedExpressionSemanticPredicate> PrepareSemanticPredicate(EmbeddedCodeSource source, EmbeddedCodePreparationContext context)

Parameters

source EmbeddedCodeSource

Raw semantic-predicate source and its parser metadata.

context EmbeddedCodePreparationContext

Preparation context that selects the runtime target and allowed contextual symbols.

Returns

EmbeddedCodePreparationResult<PreparedExpressionSemanticPredicate>

Unsupported for another category, PreservedNotCompiled for another target, CompilationFailed after a transformation or compilation failure, or Succeeded with a PreparedExpressionSemanticPredicate containing a Func<T, TResult> over SemanticPredicateEvaluationContext. The shared pipeline transforms the source before runtime-bound symbol expressions are passed to the compiler; the resulting delegate is not invoked during preparation.