[module api] Initial version

.bazelrc

@@ -1,2 +1,7 @@
 common --registry=https://raw.githubusercontent.com/eclipse-score/bazel_registry/main/
 common --registry=https://bcr.bazel.build
+
+build --java_language_version=17
+build --tool_java_language_version=17
+build --java_runtime_version=remotejdk_17
+build --tool_java_runtime_version=remotejdk_17

MODULE.bazel

@@ -95,3 +95,13 @@ multitool.hub(
     lockfile = "tools/yamlfmt.lock.json",
 )
 use_repo(multitool, "yamlfmt_hub")
+
+bazel_dep(name = "score_docs_as_code", version = "2.2.0")
+git_override(
+    module_name = "score_docs_as_code",
+    commit = "17cf66e3449f0aa9e9fe22fe3ab1fbbffad733cf",
+    remote = "https://github.com/eclipse-score/docs-as-code.git",
+)
+
+bazel_dep(name = "score_platform", version = "0.5.0")
+bazel_dep(name = "score_process", version = "1.3.2")

README.md

@@ -36,14 +36,15 @@ load("@score_tooling//:defs.bzl", "cli_tool")
 
 ## Upgrading from separate MODULES
 
-If you are still using separate module imports and want to upgrade to the new version. 
+If you are still using separate module imports and want to upgrade to the new version.
 Here are two examples to showcase how to do this.
 
 ```
 load("@score_python_basics//:defs.bzl", "score_py_pytest") => load("@score_tooling//:defs.bzl", "score_py_pytest")
 load("@score_cr_checker//:cr_checker.bzl", "copyright_checker") => load("@score_tooling//:defs.bzl", "copyright_checker")
 ```
-All things inside of 'tooling' can now be imported from `@score_tooling//:defs.bzl`. 
+
+All things inside of 'tooling' can now be imported from `@score_tooling//:defs.bzl`.
 The available import targets are:
 
 - score_virtualenv
@@ -55,6 +56,7 @@ The available import targets are:
 - setup_starpls
 
 ## Format the tooling repository
-```bash 
+
+```bash
 bazel run //:format.fix
 ```

bazel/rules/score_module/BUILD

@@ -0,0 +1,51 @@
+load(
+    "//bazel/rules/score_module:score_module.bzl",
+    "sphinx_module",
+)
+
+exports_files([
+    "templates/conf.template.py",
+    "templates/seooc_index.template.rst",
+])
+
+# HTML merge tool
+py_binary(
+    name = "sphinx_html_merge",
+    srcs = ["src/sphinx_html_merge.py"],
+    main = "src/sphinx_html_merge.py",
+    visibility = ["//visibility:public"],
+)
+
+# Sphinx build binary with all required dependencies
+py_binary(
+    name = "score_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(
+    name = "score_module_doc",
+    srcs = glob(
+        [
+            "docs/**/*.rst",
+            "docs/**/*.puml",
+        ],
+        allow_empty = True,
+    ),
+    index = "docs/index.rst",
+    visibility = ["//visibility:public"],
+    deps = [
+        "@score_process//:score_process_module",
+    ],
+)