fix!: add alias indirection for gvm toolchain

- fix: add `gvm` toolchain to toolchain config repo
- fix: add aliases from `graalvm` → toolchain targets
- fix: adjust instructions for registering toolchains
- fix: adjust workspace toolchain registration logic

Breaking change:
When registering toolchains in a Bzlmod installation of these rules,
the target `@graalvm//:all` must be changed to two toolchain
registrations, based on the desired functionality:

  Register the Java toolchain:
  register_toolchains("@graalvm//:jvm")

  Register the GVM toolchain:
  register_toolchains("@graalvm//:sdk")

Fixes and closes #66.

Relates-To: #66
Signed-off-by: Sam Gammon <[email protected]>

.github/workflows/module.build.yml

@@ -195,6 +195,46 @@ jobs:
             labs: false
             skip: false
 
+          # Test: Bazel 4
+          - label: Bazel 4
+            target: sample
+            action: build
+            directory: "./example/integration_tests/bazel4"
+            labs: false
+            skip: ${{ contains(inputs.runner, 'windows') }}
+
+          # Test: Bazel 5
+          - label: Bazel 5
+            target: sample
+            action: build
+            directory: "./example/integration_tests/bazel5"
+            labs: false
+            skip: ${{ contains(inputs.runner, 'windows') }}
+
+          # Test: Bazel 6
+          - label: Bazel 6
+            target: sample
+            action: build
+            directory: "./example/integration_tests/bazel6"
+            labs: false
+            skip: false
+
+          # Test: Inert
+          - label: Inert
+            target: sample
+            action: build
+            directory: "./example/integration_tests/inert"
+            labs: false
+            skip: false
+
+          # Test: Inert Workspace
+          - label: Inert Workspace
+            target: sample
+            action: build
+            directory: "./example/integration_tests/inert-workspace"
+            labs: false
+            skip: false
+
           # Test: Legacy Rules
           - label: Legacy Rules
             target: sample
@@ -243,30 +283,6 @@ jobs:
             labs: false
             skip: false
 
-          # Test: Bazel 4
-          - label: Bazel 4
-            target: sample
-            action: build
-            directory: "./example/integration_tests/bazel4"
-            labs: false
-            skip: ${{ contains(inputs.runner, 'windows') }}
-
-          # Test: Bazel 5
-          - label: Bazel 5
-            target: sample
-            action: build
-            directory: "./example/integration_tests/bazel5"
-            labs: false
-            skip: ${{ contains(inputs.runner, 'windows') }}
-
-          # Test: Bazel 6
-          - label: Bazel 6
-            target: sample
-            action: build
-            directory: "./example/integration_tests/bazel6"
-            labs: false
-            skip: false
-
     steps:
       - name: Harden Runner
         uses: step-security/harden-runner@8ca2b8b2ece13480cda6dacd3511b49857a23c09 # v2.5.1

MODULE.bazel

@@ -191,7 +191,11 @@ use_repo(
 )
 
 register_toolchains(
-    "@graalvm//:all",
+    "@graalvm//:jvm",
+    dev_dependency = True,
+)
+register_toolchains(
+    "@graalvm//:sdk",
     dev_dependency = True,
 )
 

README.md

@@ -99,7 +99,8 @@ gvm.graalvm(
     ],
 )
 use_repo(gvm, "graalvm")
-register_toolchains("@graalvm//:all")
+register_toolchains("@graalvm//:jvm")
+register_toolchains("@graalvm//:sdk")
 ```
 
 ## Usage: Java Toolchains
@@ -121,7 +122,8 @@ register_graalvm_toolchains()
 **Via Bzlmod:**
 
 ```starlark
-register_toolchains("@graalvm//:all")
+register_toolchains("@graalvm//:jvm")
+register_toolchains("@graalvm//:sdk")
 ```
 
 **To _use_ the toolchain, add this to your `.bazelrc`:**

docs/index.md

@@ -94,7 +94,8 @@ gvm.graalvm(
     ],
 )
 use_repo(gvm, "graalvm")
-register_toolchains("@graalvm//:all")
+register_toolchains("@graalvm//:jvm")
+register_toolchains("@graalvm//:sdk")
 ```
 
 ## Usage

docs/modern-bazel.md

@@ -17,7 +17,8 @@ load("@rules_graalvm//graalvm:repositories.bzl", "graalvm_repository")
 
 # graalvm_repository(name = "graalvm" ...)
 
-register_toolchains("@graalvm//:all")
+register_toolchains("@graalvm//:jvm")
+register_toolchains("@graalvm//:sdk")
 ```
 
 ### Installation in `WORKSPACE.bazel`

example/integration_tests/bzlmod/MODULE.bazel

@@ -30,4 +30,5 @@ use_repo(
     "graalvm",
 )
 
-register_toolchains("@graalvm//:all")
+register_toolchains("@graalvm//:jvm")
+register_toolchains("@graalvm//:sdk")

example/integration_tests/inert-workspace/.bazelrc

@@ -0,0 +1 @@
+# Nothing at thie time.

example/integration_tests/inert-workspace/.bazelversion

@@ -0,0 +1 @@
+7.0.0-pre.20230816.3

example/integration_tests/inert-workspace/.gitignore

@@ -0,0 +1 @@
+bazel-*

example/integration_tests/inert-workspace/WORKSPACE.bazel

@@ -0,0 +1,19 @@
+workspace(name = "rules_graalvm_sample")
+
+local_repository(
+    name = "rules_graalvm",
+    path = "../../..",
+)
+
+load("@rules_graalvm//graalvm:workspace.bzl", "rules_graalvm_repositories")
+
+rules_graalvm_repositories()
+
+load("@rules_graalvm//graalvm:repositories.bzl", "graalvm_repository")
+
+graalvm_repository(
+    name = "graalvm",
+    distribution = "ce",
+    java_version = "20",
+    version = "20.0.2",
+)

example/integration_tests/inert-workspace/sample/BUILD.bazel

@@ -0,0 +1,17 @@
+java_library(
+    name = "java",
+    srcs = ["Main.java"],
+)
+
+java_binary(
+    name = "main",
+    main_class = "Main",
+    runtime_deps = [
+        ":java",
+    ],
+)
+
+alias(
+    name = "sample",
+    actual = "main",
+)

example/integration_tests/inert-workspace/sample/Main.java

@@ -0,0 +1,5 @@
+public class Main {
+    public static void main(String args[]) {
+        System.out.println("Hello, GraalVM!");
+    }
+}

example/integration_tests/inert/.bazelrc

@@ -0,0 +1 @@
+build --enable_bzlmod

example/integration_tests/inert/.bazelversion

@@ -0,0 +1 @@
+7.0.0-pre.20230816.3

example/integration_tests/inert/MODULE.bazel

@@ -0,0 +1,27 @@
+"Sample bzlmod-style project which uses the GraalVM Rules for Bazel."
+
+module(
+    name = "rules_graalvm_bzlmod_sample",
+    version = "0.0.1",
+)
+
+bazel_dep(
+    name = "rules_java",
+    version = "6.5.0",
+)
+bazel_dep(
+    name = "rules_graalvm",
+    version = "0.0.0",
+)
+local_path_override(
+    module_name = "rules_graalvm",
+    path = "../../..",
+)
+
+gvm = use_extension("@rules_graalvm//:extensions.bzl", "graalvm")
+gvm.graalvm(
+    name = "graalvm",
+    distribution = "ce",
+    java_version = "20",
+    version = "20.0.2",
+)