hara.runtime.basic.impl.process-gdscript

+gdscript-runtime-dir+

Project directory used for Godot oneshot evaluation.

Must be a non-hidden directory inside the user’s home because the Godot snap cannot read paths under dot-directories.

+gdscript-twostep+

+gdscript-twostep-config+

+gdscript-verify+

+gdscript-verify-config+

+program-init+

default-body-transform

added in 4.1

(default-body-transform input mopts)

normalizes and return-formats a sequence of body forms

default-oneshot-in

added in 4.1

(default-oneshot-in body)

writes the generated script to the runtime project and returns its filename

default-oneshot-out

added in 4.1

(default-oneshot-out out)

Godot prints an engine header before script output and the snap wrapper may exit before the engine has finished writing to stdout. The script therefore also writes the JSON payload to a file; this function polls for that file and falls back to stdout parsing.

default-oneshot-wrap

added in 4.1

(default-oneshot-wrap body output-path)

wraps emitted GDScript body in a SceneTree script, lifting top-level function definitions out of OUT_FN so GDScript parses correctly.

ensure-project!

added in 4.1

(ensure-project!)

creates a minimal Godot project in the runtime dir if missing

sh-exec-gdscript

added in 4.1

(sh-exec-gdscript input-args input-body process)

basic function for executing a GDScript process

transform-form-verify

added in 4.0

(transform-form-verify forms opts)

wraps emitted GDScript in a minimal SceneTree script for syntax checking

verify-exec-gdscript

added in 4.0

(verify-exec-gdscript input-args input-body process)

writes the generated GDScript into the runtime project and runs Godot’s headless syntax check, returning the source body on success.

wrap-godot-eval

added in 4.1

(wrap-godot-eval body)

Takes emitted GDScript body (function defs + executable statements) and wraps it in a Node script with a top-level eval() function suitable for the persistent :godot runtime.