test: support gdvm in check.sh

Allows easily testing against a given version of Godot simply by passing
a version to the -g/--godot-version parameter, assuming that gdvm is
installed. For example:

./check.sh itest -g 4.3.0

Author: adalinesimonian

check.sh

@@ -34,10 +34,13 @@ Commands:
     dok           generate docs and open in browser
 
 Options:
-    -h, --help          print this help text
-    --double            run check with double-precision
-    -f, --filter <arg>  only run integration tests which contain any of the
-                        args (comma-separated). requires itest.
+    -h, --help           print this help text
+    --double             run check with double-precision
+    -f, --filter <arg>   only run integration tests which contain any of the
+                         args (comma-separated). requires itest.
+    -g, --godot-version  (works only if GODOT4_BIN is not set and gdvm is
+                         in path) specify the Godot version to use (e.g. 4.3.0).
+                         Will also use the corresponding API feature.
 
 Examples:
     check.sh fmt clippy
@@ -78,12 +81,27 @@ function findGodot() {
     # $godotBin previously detected.
     if [[ -v godotBin ]]; then
         return
+    fi
+
+    gdvmArgs=()
 
     # User-defined GODOT4_BIN.
-    elif [[ -n "$GODOT4_BIN" ]]; then
+    if [[ -n "$GODOT4_BIN" ]]; then
         log "Using environment variable GODOT4_BIN=$(printf %q "$GODOT4_BIN")"
         godotBin="$GODOT4_BIN"
 
+    # gdvm
+    elif command -v gdvm >/dev/null; then
+        log "Found 'gdvm' executable"
+        godotBin="gdvm"
+        gdvmArgs+=("run")
+
+        if [[ -n "$gdvmGodotVersion" ]]; then
+            gdvmArgs+=("$gdvmGodotVersion" "--force")
+        fi
+
+        gdvmArgs+=("--console" "--")
+
     # Executable in path.
     elif command -v godot4 >/dev/null; then
         log "Found 'godot4' executable"
@@ -95,7 +113,7 @@ function findGodot() {
         log "Found 'godot4.bat' script"
         godotBin="godot4.bat"
 
-    # This should come last: only use this as a last resort as `godot` may refer to a 
+    # This should come last: only use this as a last resort as `godot` may refer to a
     # Godot 3.x installation.
     elif command -v godot >/dev/null; then
         # Check if `godot` actually is Godot 4.x
@@ -157,7 +175,7 @@ function cmd_test() {
 function cmd_itest() {
     findGodot && \
         run cargo build -p itest "${extraCargoArgs[@]}" && \
-        run "$godotBin" --path itest/godot --headless -- "[${extraArgs[@]}]"
+        run "$godotBin" "${gdvmArgs[@]}" --path itest/godot --headless -- "[${extraArgs[@]}]"
 }
 
 function cmd_doc() {
@@ -177,6 +195,7 @@ function cmd_dok() {
 extraCargoArgs=("--no-default-features")
 cmds=()
 nextArgIsFilter=false
+nextArgIsGodotVersion=false
 extraArgs=()
 
 for arg in "$@"; do
@@ -202,10 +221,27 @@ for arg in "$@"; do
                 exit 2
             fi
             ;;
+        -g | --godot-version)
+            nextArgIsGodotVersion=true
+            ;;
         *)
             if $nextArgIsFilter; then
                 extraArgs+=("$arg")
                 nextArgIsFilter=false
+            elif $nextArgIsGodotVersion; then
+                gdvmGodotVersion="$arg"
+                nextArgIsGodotVersion=false
+
+                if [[ ! "$gdvmGodotVersion" =~ ^4\.[0-9]+\.[0-9]+$ ]]; then
+                    log "Invalid Godot version string '$gdvmGodotVersion'."
+                    log "The version string should be in the form 'x.x.x' and the major version should be at least 4."
+                    exit 2
+                fi
+
+                # API version is the same but with periods replaced by hyphens, and a .0 patch version is omitted if present.
+                # E.g. 4.3.0 -> api-4-3, 4.3.1 -> api-4-3-1
+                apiFeature="godot/api-$(echo "$gdvmGodotVersion" | sed 's/\./-/g' | sed 's/-0$//')"
+                extraCargoArgs+=("--features" "$apiFeature")
             else
                 log "Unrecognized argument '$arg'. Use '$0 --help' to see what's available."
                 exit 2