VoluntasEngine.VEPL.Native 1.1.0

VoluntasEngine.VEPL.Native

VoluntasEngine.VEPL.Native is a native-AOT compiled interop library providing a high-performance lexer and parser for VEPL. It can be called from any .NET or unmanaged application via P/Invoke.

Features

• Native AOT: Pre-compiled to a single native library for maximum startup speed and minimal dependencies.
• Flex + Bison: Combines a Flex lexer and Bison parser for C#-style syntax (namespaces, classes, methods, expressions).
• Managed Interop: Easy P/Invoke signatures for both string- and file-based lexing.
• Safe & Unsafe I/O: Helpers for chunked (“safe”) and direct (“unsafe”) writing of lexemes to disk.

Installation

NuGet

dotnet add package VoluntasEngine.VEPL.Native --version 1.1.0

This will pull down the native runtime library and C# interop shim.

Usage

C# P/Invoke Interop

using System;
using System.Runtime.InteropServices;

class Program
{
    [DllImport("VoluntasEngine.VEPL.Native", CallingConvention = CallingConvention.Cdecl)]
    private static extern IntPtr lex_from_string(string input, out int count);

    [DllImport("VoluntasEngine.VEPL.Native", CallingConvention = CallingConvention.Cdecl)]
    private static extern IntPtr lex_from_file(string path, out int count);

    [DllImport("VoluntasEngine.VEPL.Native", CallingConvention = CallingConvention.Cdecl)]
    private static extern void free_results(IntPtr data, int count);

    static void Main()
    {
        int count;
        IntPtr ptr = lex_from_string("int64 a = 5; namespace N { class C { } }", out count);

        string[] tokens = new string[count];
        for (int i = 0; i < count; i++)
        {
            IntPtr strPtr = Marshal.ReadIntPtr(ptr, i * IntPtr.Size);
            tokens[i] = Marshal.PtrToStringAnsi(strPtr);
        }

        free_results(ptr, count);

        Console.WriteLine("Tokens:");
        Console.WriteLine(string.Join(Environment.NewLine, tokens));
    }
}

Writing Lexemes to Disk

// Safe write (chunks data to avoid memory spikes)
LexerInterop.WriteLexemesToFileSafe(tokens, "output_safe.txt");

// Unsafe write (writes all at once)
LexerInterop.WriteLexemesToFileUnsafe(tokens, "output_unsafe.txt");

License

This library is licensed under the CC BY-NC-SA 4.0 — non-commercial use only, share-alike, with attribution to F000NK.