LisaCore 0.0.50
dotnet add package LisaCore --version 0.0.50
NuGet\Install-Package LisaCore -Version 0.0.50
<PackageReference Include="LisaCore" Version="0.0.50" />
paket add LisaCore --version 0.0.50
#r "nuget: LisaCore, 0.0.50"
// Install LisaCore as a Cake Addin #addin nuget:?package=LisaCore&version=0.0.50 // Install LisaCore as a Cake Tool #tool nuget:?package=LisaCore&version=0.0.50
LisaCore
1 Code Processor
LisaCore Code Processor .NET library provides a powerful and flexible way to execute C# code at runtime. With the ability to add references, import namespaces, and execute code with optional callbacks, this library is a valuable tool for developers looking to add dynamic code execution capabilities to their applications.
2 Requirements
.NET Core 3.1 or later
3 Getting Started
3.1 Install the library
To use the CodeProcessor library, first, add a reference to the library in your project. Install package from NuGet. https://www.nuget.org/packages/LisaCore
3.2 Initialize CodeProcessor
Create an instance of the CodeProcessor class:
using LisaCore.Interpreter;
var codeProcessor = new CodeProcessor();
3.3 Add references and namespaces
Add the necessary assembly references and namespaces for your code. By default, some common namespaces are already imported. Default assemblies:
LisaCore Code Processor loads all relevant assemblies from your project and
assemblies for default namespaces below.
Default namespaces:
System
System.IO
System.Linq
System.Text
System.Collections.Generic
Microsoft.EntityFrameworkCore
Loading your custom namespaces:
codeProcessor.AddReference(Assembly.Load("MyAssembly"));
codeProcessor.AddNamespace("MyNamespace");
3.4 Execute code
Execute C# code snippets by calling the ExecuteAsync method:
string code = "return 1 = 2;";
var (result, error) = await codeProcessor.ExcecuteAsync(code);
if(error != null)
{
Console.WriteLine($"Error: {error.Message}");
}
else
{
Console.WriteLine($"Result: {result}");
}
4 Advanced Usage
4.1 Callbacks
You can also provide a callback function to return a value during code processing or get the result of the executed code:
async Task MyCallBack(object? result)
{
Console.WriteLine($"Result from callback: {result}");
}
string code = "int a = 1; Callback(a); return a + 3;";
await codeProcessor.ExecuteAsync(code, MyCallBack);
Output:
Result from callback: 1
Result from callback: 4
4.2 Code validation
To check whether a code snippet is valid without executing it, call the IsCodeValid method:
string code = "return 5 - 3;";
bool isValid = codeProcessor.IsCodeValid(code, out var diagnostics);
if (isValid)
{
Console.Writeline("Code is valid.");
}
else
{
Console.WriteLine("Code is not valid. Errors:");
foreach (var diagnostic in diagnostics)
{
Console.WriteLine(diagnostic.ToString());
}
}
4.3 Custom Class
As noted in section 3.3, LisaCore Code Processor loaded all relevant assemblies form your project. However, you need to reference namespaces you want to use in our script. There are two methods to load assembly.
Use AddNamespace function. This method is persistance and allows you to reference MyApp.Models in all of your scripts.
codeProcessor.AddNamespace("MyApp.Models");
Include using statement in your script. The using namespace only apply to current code.
string code =@" using MyApp.Models; var person = new Person { Name = ""John Doe"", Age = 30 }; return person.Name;";
Completed code:
codeProcessor.AddNamespace("MyApp.Models");
string code = @"
var person = new Person { Name = ""John Doe"", Age = 30 };
return person.Name;";
var (result, error) = await codeProcessor.ExecuteAsync(code);
if (error != null)
{
Console.WriteLine($"Error: {error.Message}");
}
else
{
Console.WriteLine($"Result: {result}");
}
4.4 Custom Function
Your Custome Function
// CustomFunctions.cs
namespace MyCustomFunctions
{
public static class MathFunctions
{
public static int Square(int number)
{
return number * number;
}
}
}
Add a reference to the assembly containing the custom function and the namespace in the CodeProcessor:
//Add reference to the assembly containing the custom functions
codeProcessor.AddReference(typeof(MathFunctions).Assembly);
//Add the namespace containing the custom functions
codeProcessor.AddNamespace("MyCustomFunctions");
Your code can reference and use the custom function:
string code = "return MathFunctions.Square(5);";
var (result, error) = await codeProcessor.ExecuteAsync(code);
if (error != null)
{
Console.WriteLine($"Error: {error.Message}");
}
else
{
Console.WriteLine($"Result: {result}");
}
4.5 Using DbContext for database operations
//your EF code
var dbContext = new MyDbContext();
string code = @"
var customers = DbContext.Set<Customer>().ToList();
return customers.Count;";
var (result, error) = await codeProcessor.ExecuteAsync(code, null, dbContext);
if (error != null)
{
Console.WriteLine($"Error: {error.Message}");
}
else
{
Console.WriteLine($"Result: {result}");
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net7.0 is compatible. 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. |
-
net7.0
- BrickSchema.Net (>= 1.3.30)
- Mages (>= 2.0.1)
- MathNet.Numerics (>= 5.0.0)
- Microsoft.CodeAnalysis.CSharp.Scripting (>= 4.6.0)
- Microsoft.CodeAnalysis.Scripting (>= 4.6.0)
- Microsoft.EntityFrameworkCore.Sqlite (>= 7.0.7)
- Microsoft.ML (>= 2.0.1)
- Microsoft.ML.OnnxRuntime (>= 1.15.1)
- Microsoft.ML.OnnxTransformer (>= 2.0.1)
- Microsoft.ML.TimeSeries (>= 2.0.1)
- Microsoft.Recognizers.Text.DateTime (>= 1.8.8)
- UnidecodeSharpCore (>= 2.0.1)
- WeCantSpell.Hunspell (>= 4.0.0)
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 |
---|---|---|
0.0.50 | 306 | 7/14/2023 |
0.0.49 | 228 | 7/14/2023 |
0.0.48 | 222 | 7/14/2023 |
0.0.47 | 220 | 7/13/2023 |
0.0.46 | 203 | 6/19/2023 |
0.0.45 | 218 | 6/19/2023 |
0.0.44 | 239 | 6/19/2023 |
0.0.43 | 230 | 6/15/2023 |
0.0.42 | 234 | 6/15/2023 |
0.0.41 | 220 | 6/15/2023 |
0.0.40 | 243 | 6/8/2023 |
0.0.39 | 251 | 6/8/2023 |
0.0.38 | 240 | 6/8/2023 |
0.0.37 | 220 | 6/8/2023 |
0.0.36 | 229 | 6/8/2023 |
0.0.35 | 254 | 6/8/2023 |
0.0.34 | 240 | 6/8/2023 |
0.0.33 | 242 | 6/7/2023 |
0.0.32 | 217 | 6/7/2023 |
0.0.31 | 223 | 6/6/2023 |
0.0.30 | 242 | 6/2/2023 |
0.0.29 | 234 | 6/2/2023 |
0.0.28 | 205 | 6/1/2023 |
0.0.27 | 229 | 6/1/2023 |
0.0.26 | 178 | 6/1/2023 |
0.0.25 | 171 | 6/1/2023 |
0.0.24 | 204 | 6/1/2023 |
0.0.23 | 237 | 5/31/2023 |
0.0.22 | 212 | 5/31/2023 |
0.0.21 | 202 | 5/31/2023 |
0.0.20 | 198 | 5/23/2023 |
0.0.19 | 192 | 5/22/2023 |
0.0.18 | 206 | 5/22/2023 |
0.0.17 | 210 | 5/22/2023 |
0.0.16 | 197 | 5/22/2023 |
0.0.15 | 189 | 5/22/2023 |
0.0.14 | 213 | 5/18/2023 |
0.0.13 | 207 | 5/17/2023 |
0.0.12 | 195 | 5/12/2023 |
0.0.11 | 229 | 5/11/2023 |
0.0.10 | 223 | 5/11/2023 |
0.0.9 | 194 | 5/10/2023 |
0.0.7 | 197 | 4/25/2023 |
0.0.6 | 190 | 4/25/2023 |
0.0.5 | 185 | 4/24/2023 |
0.0.3 | 199 | 4/21/2023 |
0.0.2 | 219 | 4/6/2023 |
0.0.1 | 206 | 4/4/2023 |
Beta