README

Project Archived: Development Continues with PaskalCPP

This project is now archived and read-only. No further development, updates, or bug fixes are planned.

Over the past year, I've explored various approaches to language and compiler design, particularly my long-term vision of bringing Pascal-style programming and modern C/C++ interoperability together.

Each of these projects has been an important part of that journey, providing valuable experience, ideas, and lessons that have ultimately led to PaskalCPP.

Going forward, PaskalCPP will be my primary focus and long-term language development project. All future development efforts, new features, improvements, and innovations will be concentrated there.

🚀 Follow the Journey

PaskalCPP Programming Language

• GitHub: https://github.com/tinyBigGAMES/PaskalCPP
• Website: https://paskalcpp.org

This repository will remain available for historical reference and for anyone who may find its code, ideas, or approach useful.

The journey continues with PaskalCPP. I hope you'll join me!

© 2026-present tinyBigGAMES LLC

Note: This project is not affiliated with or connected to the RAD Studio Ganymede beta by Embarcadero.

🚀 What is Ganymede?

Ganymede is an embeddable native scripting engine. You give it source code, it compiles to real x64 machine code via JIT — no interpreter, no bytecode VM, no garbage collector pauses. Compiled functions are bare native pointers you can call with zero overhead, exactly like calling a C function. The engine ships as a single Ganymede.dll with a flat C-style API that works from any language that can load a DLL.

module mem fibonacci;

public routine fib(n: int64): int64;
begin
  if n <= 1 then
    return n;
  end;
  return fib(n - 1) + fib(n - 2);
end;

end.

Write scripts. Get native speed. ⚡

💡 Why Ganymede?

• ⚡ Native x64 JIT. Source compiles to real machine code — no interpreter loop, no bytecode dispatch. fib(30) runs at the same speed as hand-written Delphi.
• 📦 Single DLL, zero dependencies. The entire engine is one Ganymede.dll. No runtime, no framework, no package manager.
• 🔧 Flat C API. 39 cdecl exports. Integrate from Delphi, C, C++, or any language that can call a DLL.
• 🔗 Host function binding. Inject your native functions into the script with gny_import_host — scripts call them like built-ins.
• 🎯 Zero-overhead direct calls. gny_get_symbol returns a raw function pointer — cast and call with no marshalling, no boxing, no lookup cost.
• 📝 Rich type system. Records (packed, aligned, inherited), arrays (static + dynamic), pointers, overlays (unions), enums, sets, function pointers, managed strings — all statically typed, all compiled to native code.
• 🧩 Module system. Compile to in-memory JIT (module mem), static libraries (module lib), or standalone DLLs (module dll). Import modules from other modules.
• 🌐 Native FFI. Call any DLL function from script code with external "dllname" — no wrapper needed.
• 🔄 Live recompilation. Load new source, compile again on the same engine. Host imports survive across compilations.
• 🛡️ Three optimization levels. None (debug), basic, and full — per engine instance.

📂 Source Units

💻 System Requirements

⚡ Getting Started

🔷 Delphi

Clone the repo, copy Ganymede.dll and lib\pascal\Ganymede.pas into your project, add Ganymede to your uses clause. No packages, no components, no third-party dependencies.

uses
  Ganymede;

var
  LEngine: TGnyEngine;
  LResult: TGnyValue;
begin
  if not gny_load(PAnsiChar('Ganymede.dll')) then Exit;
  try
    LEngine := gny_create();
    try
      gny_load_from_string(LEngine,
        PAnsiChar(
        'module mem demo;'#10 +
        'public routine add(a: int64; b: int64): int64;'#10 +
        'begin'#10 +
        '  return a + b;'#10 +
        'end;'#10 +
        'end.'),
        PAnsiChar('demo.gny'));

      if gny_compile(LEngine) then
      begin
        gny_arg_push_int64(LEngine, 30);
        gny_arg_push_int64(LEngine, 12);
        LResult := gny_invoke(LEngine, PAnsiChar('add'), GNY_VT_INT64);
        WriteLn('add(30, 12) = ', LResult.AsInt64);  // 42
      end;
    finally
      gny_destroy(LEngine);
    end;
  finally
    gny_unload();
  end;
end;

🔶 C / C++

Copy Ganymede.dll and lib\c\include\Ganymede.h into your project. Define GANYMEDE_IMPLEMENTATION in exactly one .c/.cpp file before including the header. In all other files, include Ganymede.h normally. No build system integration required — just compile and link.

#define GANYMEDE_IMPLEMENTATION
#include "Ganymede.h"
#include <stdio.h>

int main(void) {
    if (!gny_load("Ganymede.dll")) return 1;

    GnyEngine engine = gny_create();
    gny_load_from_string(engine,
        "module mem demo;\n"
        "public routine add(a: int64; b: int64): int64;\n"
        "begin\n"
        "  return a + b;\n"
        "end;\n"
        "end.",
        "demo.gny");

    if (gny_compile(engine)) {
        gny_arg_push_int64(engine, 30);
        gny_arg_push_int64(engine, 12);
        GnyValue result = gny_invoke(engine, "add", GNY_VT_INT64);
        printf("add(30, 12) = %lld\n", (long long)result.as_int64);
    }

    gny_destroy(engine);
    gny_unload();
    return 0;
}

📚 Documentation

🤝 Contributing

Ganymede is an open project. Whether you are fixing a bug, improving documentation, or proposing a feature, contributions are welcome. Report bugs with a minimal reproduction — the smaller the example, the faster the fix. Suggest features by describing the use case first. Submit pull requests for bug fixes, docs, and well-scoped features. Join the Discord to discuss development, ask questions, and share what you are building.

💖 Support the Project

Ganymede is built in the open. If it saves you time or sparks something useful:

• ⭐ Star the repo — costs nothing, helps others find the project
• 🗣️ Spread the word — write a post, mention it in your community
• 💬 Join us on Discord — share what you're building, shape what comes next
• 💖 Become a sponsor — directly funds development and documentation
• 🦋 Follow on Bluesky — stay in the loop on releases

⚖️ License

Ganymede is licensed under the Apache License 2.0. See LICENSE for details. Apache 2.0 is a permissive open source license that lets you use, modify, and distribute Ganymede freely in both open source and commercial projects. You are not required to release your own source code. The license includes an explicit patent grant. Attribution is required — keep the copyright notice and license file in place.

🔗 Links

• 💬 Discord
• 🦋 Bluesky
• 🌐 tinyBigGAMES

Ganymede™ — Embeddable Native Scripting Engine ⚡

Copyright © 2026-present tinyBigGAMES™ LLC
All Rights Reserved.