FastExpressionCompiler 3.1.0-preview-01

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
This is a prerelease version of FastExpressionCompiler.
There is a newer version of this package available.
See the version list below for details.
dotnet add package FastExpressionCompiler --version 3.1.0-preview-01
NuGet\Install-Package FastExpressionCompiler -Version 3.1.0-preview-01
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FastExpressionCompiler" Version="3.1.0-preview-01" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FastExpressionCompiler --version 3.1.0-preview-01
#r "nuget: FastExpressionCompiler, 3.1.0-preview-01"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install FastExpressionCompiler as a Cake Addin
#addin nuget:?package=FastExpressionCompiler&version=3.1.0-preview-01&prerelease

// Install FastExpressionCompiler as a Cake Tool
#tool nuget:?package=FastExpressionCompiler&version=3.1.0-preview-01&prerelease

FastExpressionCompiler is 10-40x times faster than Expression.Compile()

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  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. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net45 is compatible.  net451 was computed.  net452 was computed.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (54)

Showing the top 5 NuGet packages that depend on FastExpressionCompiler:

Package Downloads
RulesEngine

Rules Engine is a package for abstracting business logic/rules/policies out of the system. This works in a very simple way by giving you an ability to put your rules in a store outside the core logic of the system thus ensuring that any change in rules doesn't affect the core system.

JasperFx.CodeGeneration

Code Generation Chicanery for .Net

DotVVM

DotVVM is an open source ASP.NET-based framework which allows to build interactive web apps easily by using mostly C# and HTML.

Miruken

Miruken handles your application

TestBase

*TestBase* gives you a flying start with - fluent assertions that are easy to extend - sharp error messages - tools to help you test with “heavyweight” dependencies on - AspNetCore.Mvc, AspNet.Mvc or WebApi Contexts - HttpClient - Ado.Net - Streams & Logging - Mix & match with your favourite test runners & assertions. ``` UnitUnderTest.Action() .ShouldNotBeNull() .ShouldEqualByValueExceptFor(new {Id=1, Descr=expected}, ignoreList ) .Payload .ShouldMatchIgnoringCase("I expected this") .Should(someOtherPredicate); .Items .ShouldAll(predicate) .ShouldContain(item) .ShouldNotContain(predicate) .Where(predicate) .SingleOrAssertFail() .ShouldEqualByValue().ShouldEqualByValueExceptFor(...).ShouldEqualByValueOnMembers() work with all kinds of object and collections, and report what differed. string.ShouldMatch(pattern).ShouldNotMatch().ShouldBeEmpty().ShouldNotBeEmpty() .ShouldNotBeNullOrEmptyOrWhiteSpace().ShouldEqualIgnoringCase() .ShouldContain().ShouldStartWith().ShouldEndWith().ShouldBeContainedIn(), ... numeric.ShouldBeBetween().ShouldEqualWithTolerance()....GreaterThan....LessThan...GreaterOrEqualTo ... ienumerable.ShouldAll().ShouldContain().ShouldNotContain().ShouldBeEmpty().ShouldNotBeEmpty() ... stream.ShouldHaveSameStreamContentAs().ShouldContain() value.ShouldBe().ShouldNotBe().ShouldBeOfType().ShouldBeAssignableTo()... ``` TestBase.HttpClient.Fake ``` new FakeHttpClient() .Setup(x=>x.RequestUri.PathAndQuery.StartsWith("/this")) .Returns(response) .Setup(x=>x.Method==HttpMethod.Put) .Returns(new HttpResponseMessage(HttpStatusCode.Accepted)); ``` TestBase.AdoNet ------------------ `FakeDbConnection` ``` - db.SetupForQuery(…) - db.SetupForExecuteNonQuery(…) - db.ShouldHaveUpdated("tableName", …) - db.ShouldHaveSelected("tableName", …) - db.ShouldHaveDeleted("tableName", …) - db.Verify( x=>x.CommandText.Matches("Insert [case] .*") && x.Parameters["id"].Value==1 ) - db .ShouldHaveInvoked(cmd => predicate(cmd)) .ShouldHaveParameter("name", value) ``` `RecordingDbConnection` TestBase.Mvc.AspNetCore & TestBase.Mvc for Mvc 4 & Mvc 5 -------------------------------------------------------- ``` ControllerUnderTest.WithControllerContext() .Action() .ShouldbeViewResult() .ShouldHaveModel<TModel>() .ShouldEqualByValue(expected) ControllerUnderTest.Action() .ShouldBeRedirectToRouteResult() .ShouldHaveRouteValue("expectedKey", [Optional] "expectedValue"); ShouldHaveViewDataContaining(), ShouldBeJsonResult() etc. ``` - Test AspNetCore controllers with zero setup using `controllerUnderTest.WithControllerContext(actionUnderTest)` - Test more complex AspNetCore controller/application dependencies using `HostedMvcTestFixtureBase` and specify your MVCApplications `Startup` class. ``` [TestCase("/dummy")] public async Task Put_Should_ReturnA(string url) { var httpClient=GivenClientForRunningServer<Startup>(); GivenRequestHeaders(httpClient, "CustomHeader", "HeaderValue1"); var result = await httpClient.PutAsync(url, json); result.ShouldBe_202Accepted(); } ``` For Mvc4 and Mvc 5, fake your http request &amp; context, and use the `RegisterRoutes` method of your actual application to set up `Controller.Url` ``` ControllerUnderTest .WithHttpContextAndRoutes( RouteConfig.RegisterRoutes, "/incomingurl" ); ApiControllerUnderTest.WithWebApiHttpContext<T>( httpMethod, requestUri, routeTemplate) ``` Testable Logging ``` // Extensions.Logging.ListOfString var log = new List<String>(); ILogger mslogger= new LoggerFactory().AddStringListLogger(log).CreateLogger("Test2"); // Serilog.Sinks.ListOfString Serilog.Logger slogger= new LoggerConfiguration().WriteTo.StringList(log).CreateLogger(); ```

GitHub repositories (12)

Showing the top 5 popular GitHub repositories that depend on FastExpressionCompiler:

Repository Stars
ldqk/Masuit.Tools
全龄段友好的C#万能工具库,码数吐司库,包含一些常用的操作类,大都是静态类,加密解密,反射操作,权重随机筛选算法,分布式短id,表达式树,linq扩展,文件压缩,多线程下载,硬件信息,字符串扩展方法,日期时间扩展操作,中国农历,大文件拷贝,图像裁剪,验证码,断点续传,集合扩展、Excel导出等常用封装。诸多功能集一身,代码量不到2MB!
MapsterMapper/Mapster
A fast, fun and stimulating object to object Mapper
microsoft/RulesEngine
A Json based Rules Engine with extensive Dynamic expression support
JasperFx/wolverine
Next Generation .NET Command and Message Bus
ldqk0/Masuit.Tools
该仓库为 https://github.com/ldqk/Masuit.Tools 的镜像仓库,代码更新存在较大的延迟。建议前往源仓库:https://github.com/ldqk/Masuit.Tools
Version Downloads Last updated
4.1.0 77,490 1/20/2024
4.0.2 194 1/20/2024
4.0.1 95,524 11/23/2023
4.0.0 411,770 11/12/2023
3.4.0-preview-01 2,191 8/19/2023
3.3.4 1,403,878 1/17/2023
3.3.3 1,854,324 7/24/2022
3.3.2 81,954 5/27/2022
3.3.1 23,545 5/25/2022
3.3.0 22,786 4/26/2022
3.2.2 320,142 2/2/2022
3.2.1 1,197,594 7/21/2021
3.2.0 264,376 6/14/2021
3.1.0 116,948 5/3/2021
3.1.0-preview-03 226 5/3/2021
3.1.0-preview-02 238 5/3/2021
3.1.0-preview-01 233 5/2/2021
3.0.6-preview-01 252 4/23/2021
3.0.5 4,027 4/21/2021
3.0.4 6,477 4/6/2021
3.0.3 1,541 4/1/2021
3.0.2 7,021 3/30/2021
3.0.1 503 3/27/2021
3.0.0 1,455 3/17/2021
3.0.0-preview-07 7,514 12/25/2020
3.0.0-preview-06 491 12/1/2020
3.0.0-preview-05 1,287 11/27/2020
3.0.0-preview-04 498 11/3/2020
3.0.0-preview-03 315 11/2/2020
3.0.0-preview-02 4,149 10/23/2020
3.0.0-preview-01 335 10/23/2020
2.0.0 721,875 1/25/2019
2.0.0-preview-03 1,323 11/9/2018
2.0.0-preview-02 1,019 10/25/2018
2.0.0-preview-01 762 10/24/2018
1.10.1 80,231 8/8/2018
1.10.0 1,044 8/3/2018
1.9.0 1,584 7/24/2018
1.8.0 34,349 6/24/2018
1.7.2 11,085 6/7/2018
1.7.1 168,350 3/27/2018
1.7.0 6,993 3/17/2018
1.6.0 46,965 12/3/2017
1.5.0 3,166 11/12/2017
1.4.0 15,959 9/9/2017
1.3.0 1,588 8/28/2017
1.2.2 1,730 8/8/2017
1.2.1 1,304 8/8/2017
1.2.0 1,269 8/8/2017
1.1.1 176,836 7/18/2017
1.1.0 1,166 7/13/2017
1.0.1 2,057 5/26/2017
1.0.0 4,375 4/2/2017
1.0.0-preview-04 1,060 3/31/2017
1.0.0-preview-03 1,597 3/30/2017
1.0.0-preview-02 1,043 3/29/2017
1.0.0-preview-01 1,137 3/23/2017

## v3.1.0 Bug-fix release

- added: #297 Add custom Constant to string output in the ToCSharpString and ToExpressionString
- added: #303 Add CompilerFlags.ThrowOnNotSupportedException and throw NotSupportedExpressionException when the flag is passed to CompileFast
- fixed: #301 Another case of the InvalidOperationException in the Mapster
- fixed: ListInit compilation for the Dictionary

## v3.0.5 Bug-fix release

- fixed: another case in #301 InvalidOperationException in the Mapster
- fixed: multiple problems with the TryCatch C# and Expression string output


## v3.0.4 Bug-fix release

- fixed: #302 Error compiling expression with array access


## v3.0.3 Bug-fix release

- fixed: #301 InvalidOperationException in the Mapster
- fixed: small bugs in the Lambda ToCSharpString output


## v3.0.2 Bug-fix release

- fixed:  #300 Bad label content in ILGenerator in the Mapster benchmark with FEC V3
- fixed: Small issues with the `ToCSharpString()`, specifically in the TryCatch, and the Goto, and the Label expressions


## v3.0.1 Bug-fix release

fixed: #298 LightExpression with the NewExpression of 4 arguments has ArgumentCount = 3


## v3.0.0 - Major feature release

This version contains a lot of fixes and improvements and as-little-as-possible breaking changes.

### **FastExpressionCompiler** and **FastExpressionCompiler.LightExpression**

- Performance and memory consumption are improved, especially for the expressions with the closure and for expressions with the nested lambdas.
- More expression types are supported.
- Many fixes in the IL Emit.
- Added `ToCSharpString()` extension method to output the compile-able C# code described by the expression (tries hard).
- Added `ToExpressionString()` extension method to output the valid expression construction syntax, so given an expression object you'll get e.g. `Lambda(New(...))`.
- Added optional `enum CompilerFlags { Default, NoInvocationLambdaInlining, EnableDelegateDebugInfo}` parameter for the compilation
- `EnableDelegateDebugInfo` adds the diagnostic info into the compiled delegate including its source Expression and C# code. Can be used as following:
```cs
   var f = e.CompileFast(true, CompilerFlags.EnableDelegateDebugInfo);
   var di = f.Target as IDelegateDebugInfo;
   Assert.IsNotNull(di.Expression);
   Assert.IsNotNull(di.ExpressionString);
   Assert.IsNotNull(di.CSharpString);
```

### **FastExpressionCompiler.LightExpression**

- Now includes the `ExpressionVisitor`.
- Improves the compatibility (the drop-in replacement) between the `FastExpressionCompiler.LightExpression.Expression` and the `System.Linq.Expression`.
- Decreasing the memory consumed by the created expressions partially via implementing the `IArgumentProvider` and `IParameterProvider` for some expressions.


### The full list of the closed issues

[Milestone v3.0.0](https://github.com/dadhi/FastExpressionCompiler/milestone/19)