LisaCore 0.0.50

dotnet add package LisaCore --version 0.0.50                
NuGet\Install-Package LisaCore -Version 0.0.50                
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="LisaCore" Version="0.0.50" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add LisaCore --version 0.0.50                
#r "nuget: LisaCore, 0.0.50"                
#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 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.

  1. Use AddNamespace function. This method is persistance and allows you to reference MyApp.Models in all of your scripts.

    codeProcessor.AddNamespace("MyApp.Models");

  2. 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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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