Introduction of sphinx_toolchain (#116)

* Introduction of sphinx_toolchain

This PR introduces a sphinx_toolchain.
With this changes users can introduce their
own custom toolchain for rules_score.

* Fixed bug

Author: ramceb

.github/workflows/tests.yml

@@ -25,4 +25,5 @@ jobs:
           bazel test //coverage/tests:all
       - name: Run rules_score tests
         run: |
-          bazel test //bazel/rules/rules_score/...
+          cd bazel/rules/rules_score/test
+          bazel test //...

MODULE.bazel

@@ -22,6 +22,7 @@ module(
 ###############################################################################
 bazel_dep(name = "rules_python", version = "1.4.1")
 bazel_dep(name = "aspect_rules_py", version = "1.4.0")
+bazel_dep(name = "platforms", version = "1.0.0")
 bazel_dep(name = "aspect_rules_lint", version = "1.5.3")
 bazel_dep(name = "rules_shell", version = "0.5.0")
 bazel_dep(name = "rules_java", version = "8.15.1")
@@ -94,7 +95,6 @@ multitool.hub(
 )
 use_repo(multitool, "yamlfmt_hub")
 
-bazel_dep(name = "score_docs_as_code", version = "3.0.1", dev_dependency = True)
-
-# bazel_dep(name = "score_platform", version = "0.5.0")
-bazel_dep(name = "score_process", version = "1.3.2")
+register_toolchains(
+    "//bazel/rules/rules_score:sphinx_default_toolchain",
+)

bazel/rules/rules_score/BUILD

@@ -1,3 +1,8 @@
+load("@aspect_rules_py//py:defs.bzl", "py_binary", "py_library")
+load(
+    "@score_tooling//bazel/rules/rules_score:sphinx_toolchain.bzl",
+    "sphinx_toolchain",
+)
 load(
     "//bazel/rules/rules_score:rules_score.bzl",
     "sphinx_module",
@@ -8,8 +13,26 @@ exports_files([
     "templates/seooc_index.template.rst",
     "templates/unit.template.rst",
     "templates/component.template.rst",
+    "src/sphinx_wrapper.py",
+    "src/bazel_sphinx_needs.py",
 ])
 
+sphinx_module(
+    name = "rules_score_doc",
+    srcs = glob(
+        [
+            "docs/**/*.rst",
+            "docs/**/*.puml",
+        ],
+        allow_empty = True,
+    ),
+    index = "docs/index.rst",
+    visibility = ["//visibility:public"],
+    deps = [
+        # "@score_process//:score_process_module",
+    ],
+)
+
 # HTML merge tool
 py_binary(
     name = "sphinx_html_merge",
@@ -18,36 +41,52 @@ py_binary(
     visibility = ["//visibility:public"],
 )
 
+py_library(
+    name = "sphinx_module_ext",
+    srcs = ["src/bazel_sphinx_needs.py"],
+    imports = ["src"],
+    visibility = ["//visibility:public"],
+)
+
 # Sphinx build binary with all required dependencies
 py_binary(
-    name = "score_build",
+    name = "sphinx_build",
     srcs = ["src/sphinx_wrapper.py"],
-    data = [],
-    env = {
-        "SOURCE_DIRECTORY": "",
-        "DATA": "",
-        "ACTION": "check",
-    },
     main = "src/sphinx_wrapper.py",
     visibility = ["//visibility:public"],
     deps = [
-        "@score_docs_as_code//src:plantuml_for_python",
-        "@score_docs_as_code//src/extensions/score_sphinx_bundle",
+        ":sphinx_module_ext",
+        "@pip_tooling//myst_parser",
+        "@pip_tooling//sphinx",
+        "@pip_tooling//sphinx_design",
+        "@pip_tooling//sphinx_needs",
+        "@pip_tooling//sphinx_rtd_theme",
+        "@pip_tooling//sphinxcontrib_plantuml",
     ],
 )
 
-sphinx_module(
-    name = "rules_score_doc",
-    srcs = glob(
-        [
-            "docs/**/*.rst",
-            "docs/**/*.puml",
-        ],
-        allow_empty = True,
-    ),
-    index = "docs/index.rst",
+sphinx_toolchain(
+    name = "default_toolchain",
+    conf_template = "@score_tooling//bazel/rules/rules_score:templates/conf.template.py",
+    html_merge_tool = ":sphinx_html_merge",
+    sphinx = ":sphinx_build",
+)
+
+toolchain_type(
+    name = "toolchain_type",
     visibility = ["//visibility:public"],
-    deps = [
-        "@score_process//:score_process_module",
+)
+
+toolchain(
+    name = "sphinx_default_toolchain",
+    exec_compatible_with = [
+        "@platforms//os:linux",
+        "@platforms//cpu:x86_64",
+    ],
+    target_compatible_with = [
+        "@platforms//os:linux",
+        "@platforms//cpu:x86_64",
     ],
+    toolchain = ":default_toolchain",
+    toolchain_type = ":toolchain_type",
 )