grimoire 0.8.0

A fast, concurrent based scripting language for D

To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:


Grimoire is a simple and fast concurrent programming language that can easily be embedded into another D programs. You can very easily interface your program with Grimoire's scripts.

Hope you have fun with this project !

Documentation here !

There is a VSCode extension for Grimoire available here: grimoire-lang

What it looks like:

//Hello World
event main() {
    "Hello World!":print;
//Invert a string
event main() {
    assert("Hello World !".invert == "! dlroW olleH");

func invert(str: string) (string) {
    let result = str as<list<string>>;
    loop(i, result.size / 2)
        result[i], result[-(i + 1)] = result[-(i + 1)], result[i];
    return result as<string>;
event fib() {
        function(n: int) (int) {
            if(n < 2) return n;
            return self(n - 1) + self(n - 2);
        }(10) == 55);


Use dub to include grimoire in your project (or just dump the files in your project if you want). Open the "test" folder to see how to add Grimoire to your program or copy/paste it.

Grimoire is in 2 parts:

  • The compiler
  • The runtime


To bind functions defined in D and add other types, you can create a GrLibrary which will store primitives and type information. The GrLibrary object can be shared between multiple compilations.

To compile, you need a compiler GrCompiler which will turn your scripts into bytecode with compileFile.

You must add the GrLibrary objects to the compiler before calling compileFile witch addLibrary. If the compilation fails, you can fetch the error with getError().

If it's successful, the compileFile function will returns a GrBytecode that stores the bytecode generated by the compiler, which can be saved into a file or run by the VM.

// Some basic functions are provided by the default library.
GrLibrary stdlib = grLoadStdLibrary(); 

GrCompiler compiler = new GrCompiler;

// We add the default library.

// We compile the file.
GrBytecode bytecode = compiler.compileFile("");

if(bytecode) {
    // Compilation successful
else {
    // Error while compiling
    import std.stdio: writeln;

Debug & Profiling

You can see the generated bytecode with


Which formats the bytecode in a printable way.

Grimoire also provide a basic profiling tool, to use it, to need to specify a flag during compilation to activate debug informations.

compiler.compileFile("", GrOption.Option.profile | GrOption.Option.symbols |;
  • profile adds profiling commands to the bytecode
  • symbols generate debug information into the bytecode
  • safe adds additional checks that can help detect some crashes

The profiling information are accessible on the GrEngine with:


An already formatted version is accessible with:



Then, create the runtime's virtual machine GrEngine, you'll first need to add the same libraries as the compiler and in the same order. Then, load the bytecode.

GrEngine engine = new GrEngine;

You can then spawn any event like this:

GrTask task = engine.callEvent("myEvent", [grString], [GrValue("Hello World!")]);

To run the virtual machine, just call the process function (and check if there's any task(Coroutine) currently running):


The program will run until all tasks are finished, if you want them to run only for one step, replace the while with if.

You can then check if there are any unhandled errors that went through the VM (Caught exceptions won't trigger that).

if(engine.isPanicking) {
    writeln("unhandled exception: " ~ engine.panicMessage);
    foreach (trace; engine.stackTraces) {
        writeln("[", trace.pc, "] in ",, " at ", trace.file,
            "(", trace.line, ",", trace.column, ")");


You can find the language documentation > here ! <


There is a VSCode extension for Grimoire available here: grimoire-lang

  • Enalye
Sub packages:
grimoire:test, grimoire:unittests, grimoire:docgen
0.8.1 2023-Mar-20
0.8.0 2023-Mar-06
0.7.0 2022-Nov-29
0.6.0 2022-Nov-01
0.5.2 2022-Jan-30
Show all 32 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 0 downloads this month

  • 233 downloads total

Short URL: