tooling: integrate header service (#793)

* tooling: header service adapted to new structure

Modify header service to support new structure

* tooling: small corrections after review

Remove redundant setup function
Correct argument type in function register
Simplify integration tests

* tooling: fix small error in metamodel

Fix a small error introduced during merge
conflict resolution.

---------

Signed-off-by: Michael Müller <42868757+mmr1909@users.noreply.github.com>

Author: mmr1909

tooling/docs/_tooling/docs.bzl

@@ -143,6 +143,7 @@ def _docs():
             "**/*.html",
             "**/*.css",
             "**/*.puml",
+            "**/*.need",
             # Include the docs tooling itself
             # Note: we don't use py_library here to make it as close as possible to docs:incremental.
             "**/*.py",

tooling/docs/_tooling/extensions/score_header_service/README.md

@@ -0,0 +1,56 @@
+# Automatic Header Generation Service
+
+## Purpose
+The service *header-service* generates a table with review and approver informations.
+It uses the template *header.need* to generate this table.
+
+## Extraction Methods
+This modules can use two different methods to extract the needed information.
+* GitHub data
+* Merge commit log
+
+The used method can be configured as a configuration parameter in *conf.py*.
+
+    header_service_use_github_data = True
+
+GitHub data is used if parameter is not set.
+
+
+## Environment variables
+This module uses the following environment variables if the extraction method **Github data** is configured:
+
+GH_TOKEN: Github access token
+GITHUB_REF_NAME: Github reference name (<pull request no>/merge)
+GITHUB_REPOSITORY: Github repository <org>/<repo>
+
+## Excecution
+The document generation has to be executed as follows:
+
+    GH_TOKEN=$GH_TOKEN bazel run //docs:incremental
+
+Sphinx cannot acess the environment variables when started via bazel build.
+
+If extraction method **Merge commit info** is used the document generation can be executed as follows:
+
+    bazel run //docs:incremental
+
+
+## Usage
+Add the descriptor *header_service* to a RST file to fill out review and approver informations.
+
+.. needservice:: header-service
+
+This generates the following Table:
+
+| Document Identification |                               |
+| ----------------------- | ----------------------------- |
+| Document Type           | Checklist                     |
+| Document ID             | DPX-CONTR-REVIEW-CHECKLIST    |
+| Project Name            | dependix                      |
+| ASIL                    | B                             |
+| Security Classification | CONFIDENTIAL                  |
+| Author                  | [Author of the PR]            |
+| Reviewer                | [List of PR reviewers]        |
+| Approver                | [List of PR approvers]        |
+| Version                 | [Merge commit hash of the PR] |
+| Status                  | RELEASED                      |

tooling/docs/_tooling/extensions/score_header_service/__init__.py

@@ -0,0 +1,27 @@
+# *******************************************************************************
+# Copyright (c) 2025 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+from sphinx.application import Sphinx
+from score_header_service.header_service import register
+
+
+def setup(app: Sphinx) -> dict[str, str | bool]:
+    """Register the header service with the Sphinx application.
+
+    :param app: The Sphinx application instance.
+    """
+    app.connect("env-before-read-docs", register)
+    return {
+        "version": "0.1",
+        "parallel_read_safe": True,
+        "parallel_write_safe": True,
+    }