Add libgodot skeleton project

Author: touilleMan

libgodot/.gitignore

@@ -0,0 +1 @@
+/src

libgodot/README.md

@@ -0,0 +1,82 @@
+#! /usr/bin/env python3
+
+from __future__ import annotations
+import argparse
+from pathlib import Path
+import shutil
+
+
+BASE_DIR = Path(__file__).parent
+ROOT_DIR = BASE_DIR / ".."
+TARGET_DIR = BASE_DIR / "src"
+
+
+def copy_data(build_dir: Path) -> None:
+    output_godot_dir = TARGET_DIR / "godot"
+    output_godot_hazmat_dir = output_godot_dir / "hazmat"
+    output_godot_hazmat_dir.mkdir(parents=True, exist_ok=True)
+
+    shutil.copy(ROOT_DIR / "src/_gdpy_libgodot.pyx", TARGET_DIR)
+    shutil.copy(build_dir / "src/pythonscript_gdextension_ptrs.c", TARGET_DIR)
+
+    shutil.copytree(build_dir / "gdextension_api", TARGET_DIR / "gdextension_api")
+
+    src_godot_dir = ROOT_DIR / "src/godot"
+    shutil.copy(src_godot_dir / "__init__.py", output_godot_dir)
+    shutil.copy(src_godot_dir / "__init__.pyi", output_godot_dir)
+    shutil.copy(src_godot_dir / "_lang.pyx", output_godot_dir)
+    shutil.copy(src_godot_dir / "_lang_resource_format_loader.pxi", output_godot_dir)
+    shutil.copy(src_godot_dir / "_lang_resource_format_saver.pxi", output_godot_dir)
+    shutil.copy(src_godot_dir / "_lang_script_language.pxi", output_godot_dir)
+    shutil.copy(src_godot_dir / "_lang_script.pxi", output_godot_dir)
+    shutil.copy(src_godot_dir / "py.typed", output_godot_dir)
+    shutil.copy(src_godot_dir / "singletons.py", output_godot_dir)
+
+    build_src_godot_dir = build_dir / "src/godot"
+    shutil.copy(build_src_godot_dir / "builtins.pyx", output_godot_dir)
+    shutil.copy(build_src_godot_dir / "builtins.pyi", output_godot_dir)
+    shutil.copy(build_src_godot_dir / "builtins.pxd", output_godot_dir)
+    shutil.copy(build_src_godot_dir / "classes.pyx", output_godot_dir)
+    shutil.copy(build_src_godot_dir / "classes.pyi", output_godot_dir)
+    shutil.copy(build_src_godot_dir / "classes.pxd", output_godot_dir)
+    shutil.copy(build_src_godot_dir / "_version.py", output_godot_dir)
+
+    src_godot_hazmat_dir = src_godot_dir / "hazmat"
+    shutil.copy(src_godot_hazmat_dir / "extension_class.pxd", output_godot_hazmat_dir)
+    shutil.copy(src_godot_hazmat_dir / "extension_class.pyx", output_godot_hazmat_dir)
+    shutil.copy(src_godot_hazmat_dir / "__init__.py", output_godot_hazmat_dir)
+
+    build_src_godot_hazmat_dir = build_src_godot_dir / "hazmat"
+    shutil.copy(build_src_godot_hazmat_dir / "gdapi.pxd", output_godot_hazmat_dir)
+    shutil.copy(build_src_godot_hazmat_dir / "gdextension_interface.pxd", output_godot_hazmat_dir)
+    shutil.copy(build_src_godot_hazmat_dir / "gdptrs.pxd", output_godot_hazmat_dir)
+    shutil.copy(build_src_godot_hazmat_dir / "gdtypes.pxd", output_godot_hazmat_dir)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(
+        description="Generate a Python project embedding LibGodot & Godot-Python bindings"
+    )
+    parser.add_argument(
+        "--input",
+        "-i",
+        required=True,
+        metavar="BUILD_PATH",
+        type=Path,
+        default=BASE_DIR / "../build",
+    )
+    parser.add_argument(
+        "--force",
+        "-f",
+        action="store_true",
+    )
+
+    args = parser.parse_args()
+
+    if TARGET_DIR.exists():
+        if args.force:
+            shutil.rmtree(TARGET_DIR)
+        else:
+            raise RuntimeError(f"{TARGET_DIR} already exists, aborting")
+
+    copy_data(build_dir=args.input)

libgodot/copy_data.py

@@ -0,0 +1,52 @@
+[project]
+name = "godot-python"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = []
+
+[build-system]
+requires = [
+    "setuptools>=80.9.0",
+    "cython~=3.1",
+]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+
+# Do not include files listed in MANIFEST.in to wheels.
+include-package-data = false
+
+[[tool.setuptools.ext-modules]]
+name = "_pythonscript"
+sources = [
+    "src/pythonscript_gdextension_ptrs.c",
+    "src/_gdpy_libgodot.pyx",
+]
+include-dirs = ["./src/gdextension_api/"]
+extra-compile-args = ["-O0"]
+
+[[tool.setuptools.ext-modules]]
+name = "godot.builtins"
+sources = ["./src/godot/builtins.pyx"]
+include-dirs = ["./src/gdextension_api/"]
+extra-compile-args = ["-O0"]
+
+[[tool.setuptools.ext-modules]]
+name = "godot.classes"
+sources = ["./src/godot/classes.pyx"]
+include-dirs = ["./src/gdextension_api/"]
+extra-compile-args = ["-O0"]
+
+[[tool.setuptools.ext-modules]]
+name = "godot._lang"
+sources = ["./src/godot/_lang.pyx"]
+include-dirs = ["./src/gdextension_api/"]
+extra-compile-args = ["-O0"]
+
+[[tool.setuptools.ext-modules]]
+name = "godot.hazmat.extension_class"
+sources = ["src/godot/hazmat/extension_class.pyx"]
+include-dirs = ["./src/gdextension_api/"]
+extra-compile-args = ["-O0"]

libgodot/pyproject.toml

@@ -29,3 +29,8 @@ dev = [
 [tool.ruff]
 line-length = 100
 target-version = "py313"
+
+[tool.uv.workspace]
+members = [
+    "libgodot/",
+]

libgodot/uv.lock

@@ -7,7 +7,17 @@ from godot.classes cimport BaseGDObject
 
 
 # LibGodot API
-cdef extern from "*":
+cdef extern from *:
+    """
+    typedef struct {
+        const char* key;
+        void* val;
+    } LibGodotExtensionParameter;
+
+    GDExtensionObjectPtr libgodot_create_godot_instance(int p_argc, char *p_argv[], GDExtensionInitializationFunction p_init_func, LibGodotExtensionParameter *p_params);
+    void libgodot_destroy_godot_instance(GDExtensionObjectPtr p_godot_instance);
+    """
+
     ctypedef struct LibGodotExtensionParameter:
         const char* key
         void* val
@@ -34,9 +44,10 @@ def create_godot_instance(argv: list[str]):
     if gd_instance == NULL:
         raise RuntimeError("Failed to create Godot instance")
 
+    cdef BaseGDObject instance
     try:
         from godot.classes import GodotInstance
-        cdef BaseGDObject instance = GodotInstance.__new__(GodotInstance)
+        instance = GodotInstance.__new__(GodotInstance)
         _libgodot_instance = instance
 
         _libgodot_init_lock.release()
@@ -45,7 +56,7 @@ def create_godot_instance(argv: list[str]):
 
     finally:
         with _libgodot_init_lock:
-            libgodot_destroy_godot_instance(instance._gd_instance)
+            libgodot_destroy_godot_instance(instance._gd_ptr)
             _libgodot_instance = None
 
 
@@ -59,13 +70,13 @@ cdef GDExtensionObjectPtr _create_godot_instance(argv: list[str]):
     assert c_argv != NULL
     try:
         for i in range(length):
-            c_argv[i] = <const char*>pybytes_argv
+            c_argv[i] = <char*>pybytes_argv
 
         # `c_argv` is ready, now we can initialize Godot instance !
         return libgodot_create_godot_instance(
             len(argv),
             c_argv,
-            pythonscript_init,
+            _pythonscript_init,
             NULL
         )
 
@@ -80,17 +91,21 @@ cdef GDExtensionObjectPtr _create_godot_instance(argv: list[str]):
 
 # Those symbols are defined in `pythonscript_gdextension_ptrs.c` which is
 # going to be compiled together with this file into a single shared library.
-cdef extern from "*":
+cdef extern from *:
+    """
+    void init_pythonscript_gdextension();
+    """
+
     const GDExtensionInterfaceGetProcAddress pythonscript_gdptr_get_proc_address
     const GDExtensionClassLibraryPtr pythonscript_gdptr_library
     void init_pythonscript_gdextension()
 
 
-cdef public GDExtensionBool pythonscript_init(
-    const GDExtensionInterfaceGetProcAddress p_get_proc_address,
-    const GDExtensionClassLibraryPtr p_library,
+cdef GDExtensionBool _pythonscript_init(
+    GDExtensionInterfaceGetProcAddress p_get_proc_address,
+    GDExtensionClassLibraryPtr p_library,
     GDExtensionInitialization *r_initialization
-):
+) noexcept with gil:
     print('[libgodot] pythonscript_init()', flush=True)
 
     # `pythonscript_gdptr_*` must be set as early as possible given it is never
@@ -107,22 +122,22 @@ cdef public GDExtensionBool pythonscript_init(
     # Initialize as early as possible, this way we can have 3rd party plugins written
     # in Python/Cython that can do things at this level
     r_initialization.minimum_initialization_level  = GDEXTENSION_INITIALIZATION_CORE
-	r_initialization.userdata = NULL
+    r_initialization.userdata = NULL
     r_initialization.initialize = _initialize
     r_initialization.deinitialize = _deinitialize
 
 
-cdef void _initialize(void *userdata, GDExtensionInitializationLevel p_level):
+cdef void _initialize(void *userdata, GDExtensionInitializationLevel p_level) noexcept with gil:
     print(f'[libgodot] _initialize({p_level})', flush=True)
 
     import godot._lang
-    pythonscript_initialize = <void(*)(int)>godot._lang.pythonscript_initialize_function_ptr
+    pythonscript_initialize = <void (*)(int)><size_t>godot._lang.pythonscript_initialize_function_ptr
     pythonscript_initialize(p_level);
 
 
-cdef void _deinitialize(void *userdata, GDExtensionInitializationLevel p_level):
+cdef void _deinitialize(void *userdata, GDExtensionInitializationLevel p_level) noexcept with gil:
     print(f'[libgodot] _deinitialize({p_level})', flush=True)
 
     import godot._lang
-    pythonscript_deinitialize = <void(*)(int)>godot._lang.pythonscript_deinitialize_function_ptr
+    pythonscript_deinitialize = <void (*)(int)><size_t>godot._lang.pythonscript_deinitialize_function_ptr
     pythonscript_deinitialize(p_level);