Hyperbee.Expressions.Lab
1.2.0-develop.250417163546
dotnet add package Hyperbee.Expressions.Lab --version 1.2.0-develop.250417163546
NuGet\Install-Package Hyperbee.Expressions.Lab -Version 1.2.0-develop.250417163546
<PackageReference Include="Hyperbee.Expressions.Lab" Version="1.2.0-develop.250417163546" />
<PackageVersion Include="Hyperbee.Expressions.Lab" Version="1.2.0-develop.250417163546" />
<PackageReference Include="Hyperbee.Expressions.Lab" />
paket add Hyperbee.Expressions.Lab --version 1.2.0-develop.250417163546
#r "nuget: Hyperbee.Expressions.Lab, 1.2.0-develop.250417163546"
#addin nuget:?package=Hyperbee.Expressions.Lab&version=1.2.0-develop.250417163546&prerelease
#tool nuget:?package=Hyperbee.Expressions.Lab&version=1.2.0-develop.250417163546&prerelease
Welcome to Hyperbee Expressions
Hyperbee.Expressions
is a library for creating c# expression trees that extend the capabilities of standard expression
trees to handle asynchronous workflows and other language constructs.
Features
Async Expressions
AwaitExpression
: An expression that represents an await operation.AsyncBlockExpression
: An expression that represents an asynchronous code block.
Yield Expressions
YieldExpression
: An expression that represents a yield return or break statement.EnumerableBlockExpression
: An expression that represents an enumerable code block.
Using Expression
UsingExpression
: An expression that automatically disposes IDisposable resources.
Looping Expressions
WhileExpression
: An expression that represents a while loop.ForExpression
: An expression that represents a for loop.ForEachExpression
: An expression that represents a foreach loop.
Other Expressions
StringFormatExpression
: An expression that creates a string using a supplied format string and parameters.ConfigurationExpression
: An expression that allows access to IConfiguration.InjectExpression
: An expression that allows for depency inject from a IServiceProvider.DebugExpression
: An expression that helps when debugging expression trees.
Supports Fast Expression Compiler (FEC) for improved performance.
Supports interpreted expression trees using
lambda.Compile(preferInterpretation: true)
.var lambda = Expression.Lambda<Func<int>>(Expression.Constant(1)); var interpetedLambda = lambda.Compile(preferInterpretation: true);
Examples
Asynchronous Expressions
The following example demonstrates how to create an asynchronous expression tree.
When the expression tree is compiled, the AsyncBlockExpression
will auto-generate a state machine that executes
AwaitExpressions
in the block asynchronously.
public class Example
{
public async Task ExampleAsync()
{
// Create an async block that calls async methods and assigns their results
var instance = Constant( this );
var result1 = Variable( typeof(int), "result1" );
var result2 = Variable( typeof(int), "result2" );
var asyncBlock = BlockAsync(
[result1, result2],
Assign( result1, Await(
Call( instance, nameof(FirstAsyncMethod), Type.EmptyTypes )
) ),
Assign( result2, Await(
Call( instance, nameof(SecondAsyncMethod), Type.EmptyTypes, result1 )
) )
);
// Compile and execute the async block
var lambda = Lambda<Func<Task<int>>>( asyncBlock );
var compiledLambda = lambda.Compile();
var resultValue2 = await compiledLambda();
Console.WriteLine( $"Second async method result: {resultValue2}" );
}
public static async Task<int> FirstAsyncMethod()
{
await Task.Delay( 1000 ); // Simulate async work
return 42; // Example result
}
public static async Task<int> SecondAsyncMethod( int value )
{
await Task.Delay( 1000 ); // Simulate async work
return value * 2; // Example result
}
}
Yield Expressions
The following example demonstrates how to create a yield expression tree.
When the expression tree is compiled, the EnumerableBlockExpression
will auto-generate a state machine that executes
YieldExpressions
in the block.
public class Example
{
public void ExampleYield()
{
// Create an enumerable block that yields values
var index = Variable( typeof(int), "index" );
var enumerableBlock = BlockEnumerable(
[index],
For( Assign( index, Constant( 0 ) ), LessThan( index, Constant( 10 ) ), PostIncrementAssign( index ),
Yield( index )
)
);
// Compile and execute the enumerable block
var lambda = Lambda<Func<IEnumerable<int>>>( enumerableBlock );
var compiledLambda = lambda.Compile();
var enumerable = compiledLambda();
foreach( var value in enumerable )
{
Console.WriteLine( $"Yielded value: {value}" );
}
}
}
Using Expression
The following example demonstrates how to create a Using expression.
public class Example
{
private class DisposableResource : IDisposable
{
public bool IsDisposed { get; private set; }
public void Dispose() => IsDisposed = true;
}
public void ExampleUsing()
{
var resource = new TestDisposableResource();
var disposableExpression = Expression.Constant( resource, typeof( TestDisposableResource ) );
var bodyExpression = Expression.Empty(); // Actual body isn't important
var usingExpression = ExpressionExtensions.Using(
disposableExpression,
bodyExpression
);
var compiledLambda = Expression.Lambda<Action>( reducedExpression ).Compile();
compiledLambda();
Console.WriteLine( $"Resource was disposed {resource.IsDisposed}." );
}
}
Credits
Special thanks to:
- Sergey Tepliakov - Dissecting the async methods in C#.
- Fast Expression Compiler for improved performance. ❤️
- Just The Docs for the documentation theme.
Contributing
We welcome contributions! Please see our Contributing Guide for more detai
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. |
-
net8.0
- Hyperbee.Collections (>= 2.4.0)
- Hyperbee.Expressions (>= 1.2.0-develop.250417163546)
- Hyperbee.Json (>= 3.0.3)
- Microsoft.CodeAnalysis.CSharp (>= 4.13.0)
- Microsoft.Extensions.Configuration (>= 9.0.4)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.4)
- Microsoft.Extensions.DependencyInjection (>= 9.0.4)
- Microsoft.Extensions.Http (>= 9.0.4)
-
net9.0
- Hyperbee.Collections (>= 2.4.0)
- Hyperbee.Expressions (>= 1.2.0-develop.250417163546)
- Hyperbee.Json (>= 3.0.3)
- Microsoft.CodeAnalysis.CSharp (>= 4.13.0)
- Microsoft.Extensions.Configuration (>= 9.0.4)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.4)
- Microsoft.Extensions.DependencyInjection (>= 9.0.4)
- Microsoft.Extensions.Http (>= 9.0.4)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.2.0-develop.250417163546 | 160 | 14 days ago |