EmbeddedScripts library provides unified way to run scripts written on C#, JS or Lua using different scripting engines in your .NET 5 application.

• C#: Roslyn's CSharp.Scripting and CSharpCompilation and Mono Evaluator. Mono Evaluator implements some kind of subset of C# with additional language features and limitations. For more informaion refer the official docs.
• JS: Jint, ChakraCore, ClearScriptV8
• Python: pythonnet
• Lua: Moonsharp

1. Android requires to install additional nuget package System.Runtime.Loader.
2. Pythonnet requires installed python in your environment. To setup runner you have to provide path to python library via PythonNetRunner.PythonDll static field wich is synonim to PythonDLL static field of pythonnet library. More on pythonnet specifity you can read in docs.
3. You have to install native binaries for you operating system. We recommend these binaries for ChakraCore and these for ClearScriptV8.
4. Mono was added as an experimental engine for comparision with Roslyn scripting. It is not thread safe and doesn't provide all features of C#. We don't recommend it for use in production code.

Just create one of runners and call RunCodeAsync method:

var code = @"
let a = 1;
let b = 2;
let c = a + b;
";
var runner = new JintCodeRunner();
await runner.RunCodeAsync(code);

ChakraCoreRunner and ClearScriptV8Runner implement IDisposable interface, so you need to call Dispose method after usage of them or use them inside using scope.

Besides simple script running you can expose some object from .NET to script using Register method

var countOfCalls = 0;
Action func = () => countOfCalls++;

runner.Register<Action>(func, "func");
await runner.RunAsync("func()");
// coutOfCalls will be equal to 1

You can chain registration calls

runner
    .Register<Func<int, int, int>>((a, b) => a + b, "add")
    .Register<Action<string>>(Console.WriteLine, "log");

All runners, except CompiledCodeRunner, supports expression evaluation using Evaluate method.

var sum = await runner.EvaluateAsync<int>(1 + 2);
// sum will be equal to 3

Every runner has its own list of supported .NET types

and marshalling logic.

Not all runners are thread safe, to use some of them with multithreading you have to deal with thread synchronization.

We have written benchmark tests to investigate how fast runners works in some situations such as interoperating calls between .NET and scripting engine, integer and floating point computations. Results of benchmark test you can see here.