Updating r4 from main@v4.3.0

Bumps [dorny/test-reporter](https://github.com/dorny/test-reporter) from 1 to 2.
- [Release notes](https://github.com/dorny/test-reporter/releases)
- [Changelog](https://github.com/dorny/test-reporter/blob/main/CHANGELOG.md)
- [Commits](https://github.com/dorny/test-reporter/compare/v1...v2)

---
updated-dependencies:
- dependency-name: dorny/test-reporter
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>

.btd.yml

@@ -1,9 +0,0 @@
-input: doc
-output: _build
-requirements: requirements.txt
-target: gh-pages
-formats: [ html ]
-images:
-  base: btdi/sphinx:pytooling
-  latex: btdi/latex
-theme: https://codeload.GitHub.com/buildthedocs/sphinx.theme/tar.gz/v1

.github/dependabot.yml

@@ -10,9 +10,7 @@ updates:
       - Dependencies
     assignees:
       - Paebbels
-      - umarcor
     reviewers:
       - Paebbels
-      - umarcor
     schedule:
       interval: "daily"    # Checks on Monday trough Friday.

.github/pull_request_template.md

@@ -1,16 +1,30 @@
 # New Features
- 
+
+* tbd
 * tbd
 
 # Changes
 
+* tbd
 * tbd
 
 # Bug Fixes
 
+* tbd
 * tbd
 
-----------
-# Related PRs:
+# Documentation
 
 * tbd
+* tbd
+
+# Unit Tests
+
+* tbd
+* tbd
+
+----------
+# Related Issues and Pull-Requests
+
+* tbd
+* tbd

.github/workflows/ApplicationTesting.yml

@@ -89,7 +89,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: 📥 Download artifacts '${{ inputs.wheel }}' from 'Package' job
-        uses: actions/download-artifact@v4
+        uses: pyTooling/download-artifact@v4
         with:
           name: ${{ inputs.wheel }}
           path: install
@@ -124,26 +124,34 @@ jobs:
           requirements = "${{ inputs.requirements }}"
           if requirements.startswith("-r"):
             requirementsFile = Path(requirements[2:].lstrip())
-            dependencies = loadRequirementsFile(requirementsFile)
+            try:
+              dependencies = loadRequirementsFile(requirementsFile)
+            except FileNotFoundError as ex:
+              print(f"::error title=FileNotFoundError::{ex}")
+              exit(1)
           else:
             dependencies = [req.strip() for req in requirements.split(" ")]
 
           packages = {
-            "coverage":    "python-coverage:p",
-            "igraph":      "igraph:p",
-            "jinja2":      "python-markupsafe:p",
-            "lxml":        "python-lxml:p",
-            "numpy":       "python-numpy:p",
-            "markupsafe":  "python-markupsafe:p",
-            "pip":         "python-pip:p",
-            "ruamel.yaml": "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
-            "sphinx":      "python-markupsafe:p",
-            "tomli":       "python-tomli:p",
-            "wheel":       "python-wheel:p",
+            "coverage":            "python-coverage:p",
+            "docstr_coverage":     "python-pyyaml:p",
+            "igraph":              "igraph:p",
+            "jinja2":              "python-markupsafe:p",
+            "lxml":                "python-lxml:p",
+            "numpy":               "python-numpy:p",
+            "markupsafe":          "python-markupsafe:p",
+            "pip":                 "python-pip:p",
+            "pyyaml":              "python-pyyaml:p",
+            "ruamel.yaml":         "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
+            "sphinx":              "python-markupsafe:p",
+            "tomli":               "python-tomli:p",
+            "wheel":               "python-wheel:p",
+            "pyEDAA.ProjectModel": "python-ruamel-yaml:p python-ruamel.yaml.clib:p python-lxml:p",
+            "pyEDAA.Reports":      "python-ruamel-yaml:p python-ruamel.yaml.clib:p python-lxml:p",
           }
           subPackages = {
             "pytooling": {
-              "yaml":      "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
+              "yaml":              "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
             }
           }
 
@@ -180,8 +188,8 @@ jobs:
             f.write(f"pacboy_packages={' '.join(pacboyPackages)}\n")
 
       - name: '🟦 Setup MSYS2 for ${{ matrix.runtime }}'
-        if: matrix.system == 'msys2'
         uses: msys2/setup-msys2@v2
+        if: matrix.system == 'msys2'
         with:
           msystem: ${{ matrix.runtime }}
           update: true
@@ -190,8 +198,8 @@ jobs:
             ${{ inputs.pacboy }}
 
       - name: 🐍 Setup Python ${{ matrix.python }}
-        if: matrix.system != 'msys2'
         uses: actions/setup-python@v5
+        if: matrix.system != 'msys2'
         with:
           python-version: ${{ matrix.python }}
 
@@ -215,7 +223,7 @@ jobs:
           ls -l install
           python -m pip install --disable-pip-version-check -U install/*.whl
 
-      - name: ☑ Run application tests (Ubuntu/macOS)
+      - name: ✅ Run application tests (Ubuntu/macOS)
         if: matrix.system != 'windows'
         run: |
           export ENVIRONMENT_NAME="${{ matrix.envname }}"
@@ -223,14 +231,14 @@ jobs:
           cd "${{ inputs.root_directory || '.' }}"
           [ -n '${{ inputs.apptest_xml_artifact }}' ] && PYTEST_ARGS='--junitxml=report/unit/TestReportSummary.xml' || unset PYTEST_ARGS
           if [ -n '${{ inputs.coverage_config }}' ]; then
-            echo "coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.apptest_directory }}"
+            printf "%s\n" "coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.apptest_directory }}"
             coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.apptest_directory }}
           else
-            echo "python -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.apptest_directory }}"
+            printf "%s\n" "python -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.apptest_directory }}"
             python -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.apptest_directory }}
           fi
 
-      - name: ☑ Run application tests (Windows)
+      - name: ✅ Run application tests (Windows)
         if: matrix.system == 'windows'
         run: |
           $env:ENVIRONMENT_NAME = "${{ matrix.envname }}"
@@ -247,9 +255,10 @@ jobs:
 
       - name: 📤 Upload 'TestReportSummary.xml' artifact
         if: inputs.apptest_xml_artifact != ''
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         with:
           name: ${{ inputs.apptest_xml_artifact }}-${{ matrix.system }}-${{ matrix.runtime }}-${{ matrix.python }}
-          path: report/unit/TestReportSummary.xml
+          working-directory: report/unit
+          path: TestReportSummary.xml
           if-no-files-found: error
           retention-days: 1

.github/workflows/ArtifactCleanUp.yml

@@ -25,6 +25,11 @@ name: ArtifactCleanUp
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       package:
         description: 'Artifacts to be removed on not tagged runs.'
         required: true
@@ -36,23 +41,19 @@ on:
         type: string
 
 jobs:
-
   ArtifactCleanUp:
     name: 🗑️ Artifact Cleanup
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
 
     steps:
-
       - name: 🗑️ Delete package Artifacts
-        if: ${{ ! startsWith(github.ref, 'refs/tags') }}
         uses: geekyeggo/delete-artifact@v5
+        if: ${{ ! startsWith(github.ref, 'refs/tags') }}
         with:
           name: ${{ inputs.package }}
-          token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: 🗑️ Delete remaining Artifacts
-        if: ${{ inputs.remaining != '' }}
         uses: geekyeggo/delete-artifact@v5
+        if: ${{ inputs.remaining != '' }}
         with:
           name: ${{ inputs.remaining }}
-          token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/BuildTheDocs.yml

@@ -34,9 +34,12 @@ on:
 jobs:
   BuildTheDocs:
     name: 📓 Run BuildTheDocs
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
 
     steps:
+      - name: '❗ Deprecation message'
+        run: printf "%s\n" "::warning title=Deprecated::'BuildTheDocs.yml' is not maintained anymore. Please switch to 'SphinxDocumentation.yml', 'LaTeXDocumentation.yml' and 'ExtractConfiguration.yml'."
+
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
 
@@ -46,11 +49,12 @@ jobs:
           skip-deploy: true
 
       - name: 📤 Upload 'documentation' artifacts
+        uses: pyTooling/upload-artifact@v4
         if: inputs.artifact != ''
-        uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.artifact }}
-          path: doc/_build/html
+          working-directory: doc/_build/html
+          path: '*'
           retention-days: 1
 
       - name: '📓 Publish site to GitHub Pages'

.github/workflows/CheckDocumentation.yml

@@ -24,25 +24,30 @@ name: Check Documentation
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       python_version:
         description: 'Python version.'
         required: false
-        default: '3.12'
+        default: '3.13'
         type: string
       directory:
         description: 'Source code directory to check.'
         required: true
         type: string
-#      fail_below:
-#        description: 'Minimum required documentation coverage level'
-#        required: false
-#        default: 75
-#        type: string
+      fail_under:
+        description: 'Minimum required documentation coverage level'
+        required: false
+        default: 80
+        type: string
 
 jobs:
   DocCoverage:
     name: 👀 Check documentation coverage
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
     steps:
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
@@ -54,14 +59,14 @@ jobs:
 
       - name: 🔧 Install wheel,tomli and pip dependencies (native)
         run: |
-          python -m pip install --disable-pip-version-check -U docstr_coverage interrogate
+          python -m pip install --disable-pip-version-check -U docstr_coverage interrogate[png]
 
       - name: Run 'interrogate' Documentation Coverage Check
         continue-on-error: true
         run: |
-          interrogate -c pyproject.toml
+          interrogate -c pyproject.toml --fail-under=${{ inputs.fail_under }} && printf "%s\n" "::error title=interrogate::Insufficient documentation quality (goal: ${{ inputs.fail_under }})"
 
       - name: Run 'docstr_coverage' Documentation Coverage Check
         continue-on-error: true
         run: |
-          docstr_coverage -v ${{ inputs.directory }}
+          docstr-coverage -v 2 --fail-under=${{ inputs.fail_under }} ${{ inputs.directory }} && printf "%s\n" "::error title=docstr-coverage::Insufficient documentation quality (goal: ${{ inputs.fail_under }})"

.github/workflows/CompletePipeline.yml

@@ -0,0 +1,365 @@
+# ==================================================================================================================== #
+# Authors:                                                                                                             #
+#   Patrick Lehmann                                                                                                    #
+#                                                                                                                      #
+# ==================================================================================================================== #
+# Copyright 2020-2024 The pyTooling Authors                                                                            #
+#                                                                                                                      #
+# Licensed under the Apache License, Version 2.0 (the "License");                                                      #
+# you may not use this file except in compliance with the License.                                                     #
+# You may obtain a copy of the License at                                                                              #
+#                                                                                                                      #
+#   http://www.apache.org/licenses/LICENSE-2.0                                                                         #
+#                                                                                                                      #
+# Unless required by applicable law or agreed to in writing, software                                                  #
+# distributed under the License is distributed on an "AS IS" BASIS,                                                    #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.                                             #
+# See the License for the specific language governing permissions and                                                  #
+# limitations under the License.                                                                                       #
+#                                                                                                                      #
+# SPDX-License-Identifier: Apache-2.0                                                                                  #
+# ==================================================================================================================== #
+name: Namespace Package
+
+on:
+  workflow_call:
+    inputs:
+      package_namespace:
+        description: 'Name of the tool''s namespace.'
+        required: false
+        default: ''
+        type: string
+      package_name:
+        description: 'Name of the tool''s package.'
+        required: true
+        type: string
+      unittest_python_version:
+        description: 'Python version.'
+        required: false
+        default: '3.13'
+        type: string
+      unittest_python_version_list:
+        description: 'Space separated list of Python versions to run tests with.'
+        required: false
+        default: '3.9 3.10 3.11 3.12 3.13'
+        type: string
+      unittest_system_list:
+        description: 'Space separated list of systems to run tests on.'
+        required: false
+        default: 'ubuntu windows macos macos-arm mingw64 ucrt64'
+        type: string
+      unittest_include_list:
+        description: 'Space separated list of system:python items to be included into the list of test.'
+        required: false
+        default: ''
+        type: string
+      unittest_exclude_list:
+        description: 'Space separated list of system:python items to be excluded from the list of test.'
+        required: false
+        default: ''
+        type: string
+      unittest_disable_list:
+        description: 'Space separated list of system:python items to be disabled from the list of test.'
+        required: false
+        default: ''
+        type: string
+      apptest_python_version:
+        description: 'Python version.'
+        required: false
+        default: '3.13'
+        type: string
+      apptest_python_version_list:
+        description: 'Space separated list of Python versions to run tests with.'
+        required: false
+        default: ""
+        type: string
+      apptest_system_list:
+        description: 'Space separated list of systems to run tests on.'
+        required: false
+        default: 'ubuntu windows macos macos-arm ucrt64'
+        type: string
+      apptest_include_list:
+        description: 'Space separated list of system:python items to be included into the list of test.'
+        required: false
+        default: ''
+        type: string
+      apptest_exclude_list:
+        description: 'Space separated list of system:python items to be excluded from the list of test.'
+        required: false
+        default: ''
+        type: string
+      apptest_disable_list:
+        description: 'Space separated list of system:python items to be disabled from the list of test.'
+        required: false
+        default: ''
+        type: string
+      codecov:
+        description: 'Publish merged coverage and unittest reports to Codecov.'
+        required: false
+        default: false
+        type: boolean
+      codacy:
+        description: 'Publish merged coverage report to Codacy.'
+        required: false
+        default: false
+        type: boolean
+      dorny:
+        description: 'Publish merged unittest report via Dorny Test-Reporter.'
+        required: false
+        default: false
+        type: boolean
+      cleanup:
+        description: 'Cleanup artifacts afterwards.'
+        required: false
+        default: true
+        type: boolean
+    secrets:
+      PYPI_TOKEN:
+        description: "Token for pushing releases to PyPI."
+        required: false
+      CODECOV_TOKEN:
+        description: "Token for pushing coverage and unittest results to Codecov."
+        required: false
+      CODACY_PROJECT_TOKEN:
+        description: "Token for pushing coverage results to Codacy."
+        required: false
+
+jobs:
+  ConfigParams:
+    uses: pyTooling/Actions/.github/workflows/ExtractConfiguration.yml@r4
+    with:
+      package_namespace: ${{ inputs.package_namespace }}
+      package_name:      ${{ inputs.package_name }}
+
+  UnitTestingParams:
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
+    with:
+      package_namespace:   ${{ inputs.package_namespace }}
+      package_name:        ${{ inputs.package_name }}
+      python_version:      ${{ inputs.unittest_python_version }}
+      python_version_list: ${{ inputs.unittest_python_version_list }}
+      system_list:  ${{ inputs.unittest_system_list }}
+      include_list: ${{ inputs.unittest_include_list }}
+      exclude_list: ${{ inputs.unittest_exclude_list }}
+      disable_list: ${{ inputs.unittest_disable_list }}
+
+  AppTestingParams:
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
+    with:
+      package_namespace:   ${{ inputs.package_namespace }}
+      package_name:        ${{ inputs.package_name }}
+      python_version:      ${{ inputs.apptest_python_version }}
+      python_version_list: ${{ inputs.apptest_python_version_list }}
+      system_list:         ${{ inputs.apptest_system_list }}
+      include_list:        ${{ inputs.apptest_include_list }}
+      exclude_list:        ${{ inputs.apptest_exclude_list }}
+      disable_list:        ${{ inputs.apptest_disable_list }}
+
+  UnitTesting:
+    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+    with:
+      jobs: ${{ needs.UnitTestingParams.outputs.python_jobs }}
+      requirements: "-r tests/unit/requirements.txt"
+#      pacboy: "msys/git python-lxml:p"
+      unittest_report_xml_directory:  ${{ needs.ConfigParams.outputs.unittest_report_xml_directory }}
+      unittest_report_xml_filename:   ${{ needs.ConfigParams.outputs.unittest_report_xml_filename }}
+      coverage_report_html_directory: ${{ needs.ConfigParams.outputs.coverage_report_html_directory }}
+      unittest_xml_artifact:          ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
+      coverage_sqlite_artifact:       ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}
+
+  StaticTypeCheck:
+    uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      commands: |
+        ${{ needs.ConfigParams.outputs.mypy_prepare_command }}
+        mypy --html-report report/typing -p ${{ needs.ConfigParams.outputs.package_fullname }}
+      html_report: 'report/typing'
+      html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
+
+  DocCoverage:
+    uses: pyTooling/Actions/.github/workflows/CheckDocumentation.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      directory:      ${{ inputs.package_namespace }}/${{ inputs.package_name }}
+#      fail_below: 70
+
+  Package:
+    uses: pyTooling/Actions/.github/workflows/Package.yml@r4
+    needs:
+      - UnitTestingParams
+      - UnitTesting
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      artifact:       ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
+
+#  AppTesting:
+#    uses: pyTooling/Actions/.github/workflows/ApplicationTesting.yml@r4
+#    needs:
+#      - AppTestingParams
+#      - UnitTestingParams
+#      - Package
+#    with:
+#      jobs: ${{ needs.AppTestingParams.outputs.python_jobs }}
+#      wheel: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
+#      apptest_xml_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).apptesting_xml }}
+
+  PublishCoverageResults:
+    uses: pyTooling/Actions/.github/workflows/PublishCoverageResults.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+      - UnitTesting
+    with:
+#      coverage_sqlite_artifact:       ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}
+#      coverage_xml_artifact:          ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}
+#      coverage_report_xml_directory:  ${{ needs.ConfigParams.outputs.coverage_report_xml_directory }}
+#      coverage_report_xml_filename:   ${{ needs.ConfigParams.outputs.coverage_report_xml_filename }}
+      coverage_json_artifact:         ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
+      coverage_report_json_directory: ${{ needs.ConfigParams.outputs.coverage_report_json_directory }}
+      coverage_report_json_filename:  ${{ needs.ConfigParams.outputs.coverage_report_json_filename }}
+      coverage_html_artifact:         ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
+      coverage_report_html_directory: ${{ needs.ConfigParams.outputs.coverage_report_html_directory }}
+      codecov:                        ${{ inputs.codecov }}
+      codacy:                         ${{ inputs.codacy }}
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+      CODACY_TOKEN:  ${{ secrets.CODACY_PROJECT_TOKEN }}
+
+  PublishTestResults:
+    uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+      - UnitTesting
+    with:
+      additional_merge_args:  '-d "--pytest=rewrite-dunder-init;reduce-depth:pytest.tests.unit"'
+      testsuite-summary-name: ${{ inputs.package_name }}
+      merged_junit_filename:  ${{ needs.ConfigParams.outputs.unittest_merged_report_xml_filename }}
+      merged_junit_artifact:  ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
+      dorny:                  ${{ inputs.dorny }}
+      codecov:                ${{ inputs.codecov }}
+
+    secrets:
+      CODECOV_TOKEN:          ${{ secrets.CODECOV_TOKEN }}
+
+#  VerifyDocs:
+#    uses: pyTooling/Actions/.github/workflows/VerifyDocs.yml@r4
+#    needs:
+#      - UnitTestingParams
+#    with:
+#      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+
+  Documentation:
+    uses: pyTooling/Actions/.github/workflows/SphinxDocumentation.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+      - PublishTestResults
+      - PublishCoverageResults
+#      - VerifyDocs
+    with:
+      python_version:                 ${{ needs.UnitTestingParams.outputs.python_version }}
+      coverage_report_json_directory: ${{ needs.ConfigParams.outputs.coverage_report_json_directory }}
+      unittest_xml_artifact:          ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
+      coverage_json_artifact:         ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
+      html_artifact:                  ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
+      latex_artifact:                 ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_latex }}
+
+  IntermediateCleanUp:
+    uses: pyTooling/Actions/.github/workflows/IntermediateCleanUp.yml@r4
+    needs:
+      - UnitTestingParams
+      - PublishCoverageResults
+      - PublishTestResults
+      - Documentation
+    if: ${{ inputs.cleanup }}
+    with:
+      sqlite_coverage_artifacts_prefix: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}-
+      xml_unittest_artifacts_prefix:    ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}-
+
+#  PDFDocumentation:
+#    uses: pyTooling/Actions/.github/workflows/LaTeXDocumentation.yml@r4
+#    needs:
+#      - UnitTestingParams
+#      - Documentation
+#    with:
+#      document: pyEDAA.ProjectModel
+#      latex_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_latex }}
+#      pdf_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_pdf }}
+
+  PublishToGitHubPages:
+    uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r4
+    needs:
+      - UnitTestingParams
+      - Documentation
+#      - PDFDocumentation
+      - PublishCoverageResults
+      - StaticTypeCheck
+    with:
+      doc:      ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
+      coverage: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
+      typing:   ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
+
+  ReleasePage:
+    uses: pyTooling/Actions/.github/workflows/Release.yml@r4
+    if: startsWith(github.ref, 'refs/tags')
+    needs:
+      - Package
+#      - AppTesting
+      - PublishToGitHubPages
+
+  PublishOnPyPI:
+    uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@r4
+    if: startsWith(github.ref, 'refs/tags')
+    needs:
+      - UnitTestingParams
+      - ReleasePage
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      requirements: -r dist/requirements.txt
+      artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
+    secrets:
+      PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
+
+  ArtifactCleanUp:
+    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r4
+    needs:
+      - UnitTestingParams
+      - UnitTesting
+      - StaticTypeCheck
+      - Documentation
+#      - PDFDocumentation
+      - PublishTestResults
+      - PublishCoverageResults
+      - PublishToGitHubPages
+#      - PublishOnPyPI
+      - IntermediateCleanUp
+    if: ${{ inputs.cleanup }}
+    with:
+      package: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
+      remaining: |
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_html }}-*
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}-*
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}-*
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}-*
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_html }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_latex }}
+#        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).apptesting_xml }}-*
+#        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_pdf }}

.github/workflows/CoverageCollection.yml

@@ -25,6 +25,11 @@ name: Coverage Collection
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       python_version:
         description: 'Python version.'
         required: false
@@ -63,11 +68,17 @@ jobs:
 
   Coverage:
     name: 📈 Collect Coverage Data using Python ${{ inputs.python_version }}
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
 
     steps:
+      - name: '❗ Deprecation message'
+        run: printf "%s\n" "::warning title=Deprecated::'CoverageCollection.yml' is not maintained anymore. Please switch to 'UnitTesting.yml', 'PublishCoverageResults.yml' and 'PublishTestResults.yml'."
+
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
+        with:
+          lfs: true
+          submodules: true
 
       - name: 🐍 Setup Python ${{ inputs.python_version }}
         uses: actions/setup-python@v5
@@ -102,7 +113,9 @@ jobs:
               htmlDirectory = pyProjectSettings["tool"]["coverage"]["html"]["directory"]
               xmlFile       = pyProjectSettings["tool"]["coverage"]["xml"]["output"]
             else:
-              print(f"File '{pyProjectFile}' not found and no ' .coveragerc' file specified.")
+              print(f"File '{pyProjectFile}' not found.")
+              print(f"::error title=FileNotFoundError::File '{pyProjectFile}' not found.")
+              exit(1)
 
           # Read output paths from '.coveragerc' file
           elif len(coverageRC) > 0:
@@ -115,6 +128,8 @@ jobs:
               xmlFile       = coverageRCSettings["xml"]["output"]
             else:
               print(f"File '{coverageRCFile}' not found.")
+              print(f"::error title=FileNotFoundError::File '{coverageRCFile}' not found.")
+              exit(1)
 
           # Write jobs to special file
           github_output = Path(getenv("GITHUB_OUTPUT"))
@@ -135,7 +150,7 @@ jobs:
           ABSDIR=$(pwd)
           cd "${{ inputs.tests_directory || '.' }}"
           [ -n '${{ inputs.coverage_config }}' ] && PYCOV_ARGS="--cov-config=${ABSDIR}/${{ inputs.coverage_config }}" || unset PYCOV_ARGS
-          echo "python -m pytest -rA --cov=${ABSDIR} ${PYCOV_ARGS} ${{ inputs.unittest_directory }} --color=yes"
+          printf "%s\n" "python -m pytest -rA --cov=${ABSDIR} ${PYCOV_ARGS} ${{ inputs.unittest_directory }} --color=yes"
           python -m pytest -rA --cov=${ABSDIR} $PYCOV_ARGS ${{ inputs.unittest_directory }} --color=yes
 
       - name: Convert to cobertura format
@@ -148,16 +163,17 @@ jobs:
 
       - name: 📤 Upload 'Coverage Report' artifact
         continue-on-error: true
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         with:
           name: ${{ inputs.artifact }}
-          path: ${{ steps.getVariables.outputs.coverage_report_html_directory }}
+          working-directory: ${{ steps.getVariables.outputs.coverage_report_html_directory }}
+          path: '*'
           if-no-files-found: error
           retention-days: 1
 
       - name: 📊 Publish coverage at CodeCov
         continue-on-error: true
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v5
         with:
           files: ${{ steps.getVariables.outputs.coverage_report_xml }}
           flags: unittests

.github/workflows/ExtractConfiguration.yml

@@ -0,0 +1,237 @@
+# ==================================================================================================================== #
+# Authors:                                                                                                             #
+#   Patrick Lehmann                                                                                                    #
+#                                                                                                                      #
+# ==================================================================================================================== #
+# Copyright 2020-2024 The pyTooling Authors                                                                            #
+#                                                                                                                      #
+# Licensed under the Apache License, Version 2.0 (the "License");                                                      #
+# you may not use this file except in compliance with the License.                                                     #
+# You may obtain a copy of the License at                                                                              #
+#                                                                                                                      #
+#   http://www.apache.org/licenses/LICENSE-2.0                                                                         #
+#                                                                                                                      #
+# Unless required by applicable law or agreed to in writing, software                                                  #
+# distributed under the License is distributed on an "AS IS" BASIS,                                                    #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.                                             #
+# See the License for the specific language governing permissions and                                                  #
+# limitations under the License.                                                                                       #
+#                                                                                                                      #
+# SPDX-License-Identifier: Apache-2.0                                                                                  #
+# ==================================================================================================================== #
+name: Extract Configuration
+
+on:
+  workflow_call:
+    inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
+      python_version:
+        description: 'Python version.'
+        required: false
+        default: '3.13'
+        type: string
+      package_namespace:
+        description: 'Name of the tool''s namespace.'
+        required: false
+        default: ''
+        type: string
+      package_name:
+        description: 'Name of the tool''s package.'
+        required: true
+        type: string
+      coverage_config:
+        description: 'Path to the .coveragerc file. Use pyproject.toml by default.'
+        required: false
+        default: 'pyproject.toml'
+        type: string
+
+    outputs:
+      package_fullname:
+        description: ""
+        value: ${{ jobs.Extract.outputs.package_fullname }}
+      package_directory:
+        description: ""
+        value: ${{ jobs.Extract.outputs.package_directory }}
+      mypy_prepare_command:
+        description: ""
+        value: ${{ jobs.Extract.outputs.mypy_prepare_command }}
+      unittest_report_xml_directory:
+        description: ""
+        value: ${{ jobs.Extract.outputs.unittest_report_xml_directory }}
+      unittest_report_xml_filename:
+        description: ""
+        value: ${{ jobs.Extract.outputs.unittest_report_xml_filename }}
+      unittest_report_xml:
+        description: ""
+        value: ${{ jobs.Extract.outputs.unittest_report_xml }}
+      unittest_merged_report_xml_directory:
+        description: ""
+        value: ${{ jobs.Extract.outputs.unittest_merged_report_xml_directory }}
+      unittest_merged_report_xml_filename:
+        description: ""
+        value: ${{ jobs.Extract.outputs.unittest_merged_report_xml_filename }}
+      unittest_merged_report_xml:
+        description: ""
+        value: ${{ jobs.Extract.outputs.unittest_merged_report_xml }}
+      coverage_report_html_directory:
+        description: ""
+        value: ${{ jobs.Extract.outputs.coverage_report_html_directory }}
+      coverage_report_xml_directory:
+        description: ""
+        value: ${{ jobs.Extract.outputs.coverage_report_xml_directory }}
+      coverage_report_xml_filename:
+        description: ""
+        value: ${{ jobs.Extract.outputs.coverage_report_xml_filename }}
+      coverage_report_xml:
+        description: ""
+        value: ${{ jobs.Extract.outputs.coverage_report_xml }}
+      coverage_report_json_directory:
+        description: ""
+        value: ${{ jobs.Extract.outputs.coverage_report_json_directory }}
+      coverage_report_json_filename:
+        description: ""
+        value: ${{ jobs.Extract.outputs.coverage_report_json_filename }}
+      coverage_report_json:
+        description: ""
+        value: ${{ jobs.Extract.outputs.coverage_report_json }}
+
+jobs:
+  Extract:
+    name: 📓 Extract configurations from pyproject.toml
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
+    outputs:
+      package_fullname:                     ${{ steps.getPackageName.outputs.package_fullname }}
+      package_directory:                    ${{ steps.getPackageName.outputs.package_directory }}
+      mypy_prepare_command:                 ${{ steps.getPackageName.outputs.mypy_prepare_command }}
+      unittest_report_xml_directory:        ${{ steps.getVariables.outputs.unittest_report_xml_directory }}
+      unittest_report_xml_filename:         ${{ steps.getVariables.outputs.unittest_report_xml_filename }}
+      unittest_report_xml:                  ${{ steps.getVariables.outputs.unittest_report_xml }}
+      unittest_merged_report_xml_directory: ${{ steps.getVariables.outputs.unittest_merged_report_xml_directory }}
+      unittest_merged_report_xml_filename:  ${{ steps.getVariables.outputs.unittest_merged_report_xml_filename }}
+      unittest_merged_report_xml:           ${{ steps.getVariables.outputs.unittest_merged_report_xml }}
+      coverage_report_html_directory:       ${{ steps.getVariables.outputs.coverage_report_html_directory }}
+      coverage_report_xml_directory:        ${{ steps.getVariables.outputs.coverage_report_xml_directory }}
+      coverage_report_xml_filename:         ${{ steps.getVariables.outputs.coverage_report_xml_filename }}
+      coverage_report_xml:                  ${{ steps.getVariables.outputs.coverage_report_xml }}
+      coverage_report_json_directory:       ${{ steps.getVariables.outputs.coverage_report_json_directory }}
+      coverage_report_json_filename:        ${{ steps.getVariables.outputs.coverage_report_json_filename }}
+      coverage_report_json:                 ${{ steps.getVariables.outputs.coverage_report_json }}
+
+    steps:
+      - name: ⏬ Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 🐍 Setup Python ${{ inputs.python_version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ inputs.python_version }}
+
+      - name: 🔧 Install wheel,tomli and pip dependencies (native)
+        run: |
+          python -m pip install --disable-pip-version-check -U wheel tomli
+
+      - name: 🔁 Full package name and directory
+        id: getPackageName
+        shell: python
+        run: |
+          from os       import getenv
+          from pathlib  import Path
+          from textwrap import dedent
+
+          namespace = "${{ inputs.package_namespace }}".strip()
+          name = "${{ inputs.package_name }}".strip()
+
+          if namespace == "" or namespace == ".":
+            fullname = f"{name}"
+            directory = f"{name}"
+            mypy_prepare_command = ""
+          else:
+            fullname = f"{namespace}.{name}"
+            directory = f"{namespace}/{name}"
+            mypy_prepare_command = f"touch {namespace}/__init__.py"
+
+          github_output = Path(getenv("GITHUB_OUTPUT"))
+          print(f"GITHUB_OUTPUT: {github_output}")
+          with github_output.open("a+", encoding="utf-8") as f:
+            f.write(dedent(f"""\
+              package_fullname={fullname}
+              package_directory={directory}
+              mypy_prepare_command={mypy_prepare_command}
+            """))
+
+      - name: 🔁 Extract configurations from pyproject.toml
+        id: getVariables
+        shell: python
+        run: |
+          from os       import getenv
+          from pathlib  import Path
+          from sys      import version
+          from textwrap import dedent
+
+          print(f"Python: {version}")
+
+          from tomli import load as tomli_load
+
+          unittestXMLFile =       Path("./unittest.xml")
+          coverageHTMLDirectory = Path("htmlcov")
+          coverageXMLFile =       Path("./coverage.xml")
+          coverageJSONFile =      Path("./coverage.json")
+          coverageRC =            "${{ inputs.coverage_config }}".strip()
+
+          # Read output paths from 'pyproject.toml' file
+          if coverageRC == "pyproject.toml":
+            pyProjectFile =  Path("pyproject.toml")
+            if pyProjectFile.exists():
+              with pyProjectFile.open("rb") as file:
+                pyProjectSettings = tomli_load(file)
+
+              unittestXMLFile =       Path(pyProjectSettings["tool"]["pytest"]["junit_xml"])
+              mergedUnittestXMLFile = Path(pyProjectSettings["tool"]["pyedaa-reports"]["junit_xml"])
+              coverageHTMLDirectory = Path(pyProjectSettings["tool"]["coverage"]["html"]["directory"])
+              coverageXMLFile =       Path(pyProjectSettings["tool"]["coverage"]["xml"]["output"])
+              coverageJSONFile=       Path(pyProjectSettings["tool"]["coverage"]["json"]["output"])
+            else:
+              print(f"File '{pyProjectFile}' not found.")
+              print(f"::error title=FileNotFoundError::File '{pyProjectFile}' not found.")
+              exit(1)
+
+          # Read output paths from '.coveragerc' file
+          elif len(coverageRC) > 0:
+            coverageRCFile = Path(coverageRC)
+            if coverageRCFile.exists():
+              with coverageRCFile.open("rb") as file:
+                coverageRCSettings = tomli_load(file)
+
+              coverageHTMLDirectory = Path(coverageRCSettings["html"]["directory"])
+              coverageXMLFile =       Path(coverageRCSettings["xml"]["output"])
+              coverageJSONFile =      Path(coverageRCSettings["json"]["output"])
+            else:
+              print(f"File '{coverageRCFile}' not found.")
+              print(f"::error title=FileNotFoundError::File '{coverageRCFile}' not found.")
+              exit(1)
+
+          # Write jobs to special file
+          github_output = Path(getenv("GITHUB_OUTPUT"))
+          print(f"GITHUB_OUTPUT: {github_output}")
+          with github_output.open("a+", encoding="utf-8") as f:
+            f.write(dedent(f"""\
+              unittest_report_xml_directory={unittestXMLFile.parent.as_posix()}
+              unittest_report_xml_filename={unittestXMLFile.name}
+              unittest_report_xml={unittestXMLFile.as_posix()}
+              unittest_merged_report_xml_directory={mergedUnittestXMLFile.parent.as_posix()}
+              unittest_merged_report_xml_filename={mergedUnittestXMLFile.name}
+              unittest_merged_report_xml={mergedUnittestXMLFile.as_posix()}
+              coverage_report_html_directory={coverageHTMLDirectory.as_posix()}
+              coverage_report_xml_directory={coverageXMLFile.parent.as_posix()}
+              coverage_report_xml_filename={coverageXMLFile.name}
+              coverage_report_xml={coverageXMLFile.as_posix()}
+              coverage_report_json_directory={coverageJSONFile.parent.as_posix()}
+              coverage_report_json_filename={coverageJSONFile.name}
+              coverage_report_json={coverageJSONFile.as_posix()}
+            """))
+
+          print(f"DEBUG:\n  unittest xml:        {unittestXMLFile}\n  merged unittest xml: {mergedUnittestXMLFile}\n  coverage html:       {coverageHTMLDirectory}\n  coverage xml:        {coverageXMLFile}\n  coverage json:       {coverageJSONFile}")

.github/workflows/IntermediateCleanUp.yml

@@ -24,6 +24,11 @@ name: Intermediate Cleanup
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       sqlite_coverage_artifacts_prefix:
         description: 'Prefix for SQLite coverage artifacts'
         required: false
@@ -36,7 +41,7 @@ on:
 jobs:
   IntermediateCleanUp:
     name: 🗑️ Intermediate Artifact Cleanup
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
     steps:
       - name: 🗑️ Delete SQLite coverage artifacts from matrix jobs
         uses: geekyeggo/delete-artifact@v5
@@ -44,12 +49,10 @@ jobs:
         continue-on-error: true
         with:
           name: ${{ inputs.sqlite_coverage_artifacts_prefix }}*
-          token: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: 🗑️ Delete XML coverage artifacts from matrix jobs
+      - name: 🗑️ Delete JUnit XML artifacts from matrix jobs
         uses: geekyeggo/delete-artifact@v5
         if: inputs.xml_unittest_artifacts_prefix != ''
         continue-on-error: true
         with:
           name: ${{ inputs.xml_unittest_artifacts_prefix }}*
-          token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/LaTeXDocumentation.yml

@@ -24,6 +24,11 @@ name: LaTeX Documentation
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       document:
         description: 'LaTeX root document without *.tex extension.'
         required: true
@@ -42,25 +47,36 @@ on:
 jobs:
   PDFDocumentation:
     name: 📓 Converting LaTeX Documentation to PDF
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
     steps:
       - name: 📥 Download artifacts '${{ inputs.latex_artifact }}' from 'SphinxDocumentation' job
-        uses: actions/download-artifact@v4
+        uses: pyTooling/download-artifact@v4
         with:
           name: ${{ inputs.latex_artifact }}
           path: latex
 
-      - name: Compile LaTeX document
-        uses: xu-cheng/latex-action@master
+      - name: Debug
+        run: |
+          tree -pash .
+
+      - name: Build LaTeX document using 'pytooling/miktex:sphinx'
+        uses: addnab/docker-run-action@v3
         with:
-          working_directory: latex
-          root_file: ${{ inputs.document }}.tex
+          image: pytooling/miktex:sphinx
+          options: -v ${{ github.workspace }}/latex:/latex --workdir /latex
+          run: |
+            which pdflatex
+            pwd
+            ls -lAh
+
+            latexmk -xelatex ${{ inputs.document }}.tex
 
       - name: 📤 Upload 'PDF Documentation' artifact
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         if: inputs.pdf_artifact != ''
         with:
           name: ${{ inputs.pdf_artifact }}
+          working-directory: latex
           path: ${{ inputs.document }}.pdf
           if-no-files-found: error
           retention-days: 1

.github/workflows/NightlyRelease.yml

@@ -0,0 +1,530 @@
+# ==================================================================================================================== #
+# Authors:                                                                                                             #
+#   Patrick Lehmann                                                                                                    #
+#                                                                                                                      #
+# ==================================================================================================================== #
+# Copyright 2020-2024 The pyTooling Authors                                                                            #
+#                                                                                                                      #
+# Licensed under the Apache License, Version 2.0 (the "License");                                                      #
+# you may not use this file except in compliance with the License.                                                     #
+# You may obtain a copy of the License at                                                                              #
+#                                                                                                                      #
+#   http://www.apache.org/licenses/LICENSE-2.0                                                                         #
+#                                                                                                                      #
+# Unless required by applicable law or agreed to in writing, software                                                  #
+# distributed under the License is distributed on an "AS IS" BASIS,                                                    #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.                                             #
+# See the License for the specific language governing permissions and                                                  #
+# limitations under the License.                                                                                       #
+#                                                                                                                      #
+# SPDX-License-Identifier: Apache-2.0                                                                                  #
+# ==================================================================================================================== #
+name: Nightly
+
+on:
+  workflow_call:
+    inputs:
+      ubuntu_image:
+        description: 'Name of the Ubuntu image.'
+        required: false
+        default: 'ubuntu-24.04'
+        type: string
+      nightly_name:
+        description: 'Name of the nightly release.'
+        required: false
+        default: 'nightly'
+        type: string
+      nightly_title:
+        description: 'Title of the nightly release.'
+        required: false
+        default: ''
+        type: string
+      nightly_description:
+        description: 'Description of the nightly release.'
+        required: false
+        default: 'Release of artifacts from latest CI pipeline.'
+        type: string
+      draft:
+        description: 'Specify if this is a draft.'
+        required: false
+        default: false
+        type: boolean
+      prerelease:
+        description: 'Specify if this is a pre-release.'
+        required: false
+        default: false
+        type: boolean
+      latest:
+        description: 'Specify if this is the latest release.'
+        required: false
+        default: false
+        type: boolean
+      replacements:
+        description: 'Multi-line string containing search=replace patterns.'
+        required: false
+        default: ''
+        type: string
+      assets:
+        description: 'Multi-line string containing artifact:file:title asset descriptions.'
+        required: true
+        type: string
+      inventory-json:
+        type: string
+        required: false
+        default: ''
+      inventory-version:
+        type: string
+        required: false
+        default: ''
+      inventory-categories:
+        type: string
+        required: false
+        default: ''
+      tarball-name:
+        type: string
+        required: false
+        default: '__pyTooling_upload_artifact__.tar'
+      can-fail:
+        type: boolean
+        required: false
+        default: false
+
+jobs:
+  Release:
+    name: 📝 Update 'Nightly Page' on GitHub
+    runs-on: ${{ inputs.ubuntu_image }}
+    continue-on-error: ${{ inputs.can-fail }}
+    permissions:
+      contents: write
+      actions: write
+#      attestations: write
+
+    steps:
+      - name: ⏬ Checkout repository
+        uses: actions/checkout@v4
+        with:
+          # The command 'git describe' (used for version) needs the history.
+          fetch-depth: 0
+
+      - name: 🔧 Install zstd
+        run: sudo apt-get install -y --no-install-recommends zstd
+
+      - name: 📑 Delete (old) Release Page
+        id: deleteReleasePage
+        run: |
+          set +e
+
+          ANSI_LIGHT_RED=$'\x1b[91m'
+          ANSI_LIGHT_GREEN=$'\x1b[92m'
+          ANSI_LIGHT_YELLOW=$'\x1b[93m'
+          ANSI_NOCOLOR=$'\x1b[0m'
+
+          export GH_TOKEN=${{ github.token }}
+
+          printf "%s" "Deleting release '${{ inputs.nightly_name }}' ... "
+          message="$(gh release delete ${{ inputs.nightly_name }} --yes 2>&1)"
+          if [[ $? -eq 0 ]]; then
+            printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+          elif [[ "${message}" == "release not found" ]]; then
+            printf "%s\n" "${ANSI_LIGHT_YELLOW}[NOT FOUND]${ANSI_NOCOLOR}"
+          else
+            printf "%s\n" "${ANSI_LIGHT_RED}[FAILED]${ANSI_NOCOLOR}"
+            printf "  %s\n" "${ANSI_LIGHT_RED}Couldn't delete release '${{ inputs.nightly_name }}' -> Error: '${message}'.${ANSI_NOCOLOR}"
+            printf "%s\n" "::error title=InternalError::Couldn't delete release '${{ inputs.nightly_name }}' -> Error: '${message}'."
+            exit 1
+          fi
+
+      - name: 📑 (Re)create (new) Release Page
+        id: createReleasePage
+        run: |
+          set +e
+
+          ANSI_LIGHT_RED=$'\x1b[91m'
+          ANSI_LIGHT_GREEN=$'\x1b[92m'
+          ANSI_NOCOLOR=$'\x1b[0m'
+
+          export GH_TOKEN=${{ github.token }}
+
+          addDraft="--draft"
+
+          if [[ "${{ inputs.prerelease }}" == "true" ]]; then
+            addPreRelease="--prerelease"
+          fi
+
+          if [[ "${{ inputs.latest }}" == "false" ]]; then
+            addLatest="--latest=false"
+          fi
+
+          if [[ "${{ inputs.nightly_title }}" != "" ]]; then
+            addTitle=("--title" "${{ inputs.nightly_title }}")
+          fi
+
+          cat <<'EOF' > __NoTeS__.md
+          ${{ inputs.nightly_description }}
+          EOF
+          if [[ -s __NoTeS__.md ]]; then
+            addNotes=("--notes-file" "__NoTeS__.md")
+          fi
+
+          # Apply replacements
+          while IFS=$'\r\n' read -r patternLine; do
+            # skip empty lines
+            [[ "$patternLine" == "" ]] && continue
+
+            pattern="${patternLine%%=*}"
+            replacement="${patternLine#*=}"
+            sed -i -e "s/%$pattern%/$replacement/g" "__NoTeS__.md"
+          done <<<'${{ inputs.replacements }}'
+
+          # Add footer line
+          cat <<EOF >> __NoTeS__.md
+
+          --------
+          Published from [${{ github.workflow }}](https://github.com/Paebbels/ghdl/actions/runs/${{ github.run_id }}) workflow triggered by @${{ github.actor }} on $(date '+%Y-%m-%d %H:%M:%S %Z').
+          EOF
+
+          printf "%s\n" "Creating release '${{ inputs.nightly_name }}' ... "
+          message="$(gh release create "${{ inputs.nightly_name }}" --verify-tag $addDraft $addPreRelease $addLatest "${addTitle[@]}" "${addNotes[@]}" 2>&1)"
+          if [[ $? -eq 0 ]]; then
+            printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+          else
+            printf "%s\n" "${ANSI_LIGHT_RED}[FAILED]${ANSI_NOCOLOR}"
+            printf "  %s\n" "${ANSI_LIGHT_RED}Couldn't create release '${{ inputs.nightly_name }}' -> Error: '${message}'.${ANSI_NOCOLOR}"
+            printf "%s\n" "::error title=InternalError::Couldn't create release '${{ inputs.nightly_name }}' -> Error: '${message}'."
+            exit 1
+          fi
+
+      - name: 📥 Download artifacts and upload as assets
+        id: uploadAssets
+        run: |
+          set +e
+
+          ANSI_LIGHT_RED=$'\x1b[91m'
+          ANSI_LIGHT_GREEN=$'\x1b[92m'
+          ANSI_LIGHT_YELLOW=$'\x1b[93m'
+          ANSI_LIGHT_BLUE=$'\x1b[94m'
+          ANSI_NOCOLOR=$'\x1b[0m'
+
+          export GH_TOKEN=${{ github.token }}
+
+          Replace() {
+            line="$1"
+            while IFS=$'\r\n' read -r patternLine; do
+              # skip empty lines
+              [[ "$patternLine" == "" ]] && continue
+
+              pattern="${patternLine%%=*}"
+              replacement="${patternLine#*=}"
+              line="${line//"%$pattern%"/"$replacement"}"
+            done <<<'${{ inputs.replacements }}'
+            printf "%s\n" "$line"
+          }
+
+          # Create JSON inventory
+          if [[ "${{ inputs.inventory-json }}" != "" ]]; then
+            VERSION="1.0"
+
+            # Split categories by ',' into a Bash array.
+            # See https://stackoverflow.com/a/45201229/3719459
+            if [[ "${{ inputs.inventory-categories }}" != "" ]]; then
+              readarray -td, inventoryCategories <<<"${{ inputs.inventory-categories }},"
+              unset 'inventoryCategories[-1]'
+              declare -p inventoryCategories
+            else
+              inventoryCategories=""
+            fi
+
+            jsonInventory=$(jq -c -n \
+              --arg version "${VERSION}" \
+              --arg date "$(date +"%Y-%m-%dT%H-%M-%S%:z")" \
+              --argjson jsonMeta "$(jq -c -n \
+                --arg tag "${{ inputs.nightly_name }}" \
+                --arg version "${{ inputs.inventory-version }}" \
+                --arg hash "${{ github.sha }}" \
+                --arg repo "${{ github.server_url }}/${{ github.repository }}" \
+                --arg release "${{ github.server_url }}/${{ github.repository }}/releases/download/${{ inputs.nightly_name }}" \
+                --argjson categories "$(jq -c -n \
+                  '$ARGS.positional' \
+                  --args "${inventoryCategories[@]}" \
+                )" \
+                '{"tag": $tag, "version": $version, "git-hash": $hash, "repository-url": $repo, "release-url": $release, "categories": $categories}' \
+              )" \
+              '{"version": 1.0, "timestamp": $date, "meta": $jsonMeta, "files": {}}'
+            )
+          fi
+
+          ERRORS=0
+          # A dictionary of 0/1 to avoid duplicate downloads
+          declare -A downloadedArtifacts
+          # A dictionary to check for duplicate asset files in release
+          declare -A assetFilenames
+          while IFS=$'\r\n' read -r assetLine; do
+            if [[ "${assetLine}" == "" || "${assetLine:0:1}" == "#" ]]; then
+              continue
+            fi
+
+            # split assetLine colon separated triple: artifact:asset:title
+            artifact="${assetLine%%:*}"
+            assetLine="${assetLine#*:}"
+            asset="${assetLine%%:*}"
+            assetLine="${assetLine#*:}"
+            if [[ "${{ inputs.inventory-json }}" == "" ]]; then
+              categories=""
+              title="${assetLine##*:}"
+            else
+              categories="${assetLine%%:*}"
+              title="${assetLine##*:}"
+            fi
+
+            # remove leading whitespace
+            asset="${asset#"${asset%%[![:space:]]*}"}"
+            categories="${categories#"${categories%%[![:space:]]*}"}"
+            title="${title#"${title%%[![:space:]]*}"}"
+
+            # apply replacements
+            asset="$(Replace "${asset}")"
+            title="$(Replace "${title}")"
+
+            printf "%s\n" "Publish asset '${asset}' from artifact '${artifact}' with title '${title}'"
+            printf "  %s" "Checked asset for duplicates ... "
+            if [[ -n "${assetFilenames[$asset]}" ]]; then
+              printf "%s\n" "${ANSI_LIGHT_RED}[ERROR]${ANSI_NOCOLOR}"
+              printf "%s\n" "::error title=DuplicateAsset::Asset '${asset}' from artifact '${artifact}' was already uploaded to release '${{ inputs.nightly_name }}'."
+              ERRORS=$((ERRORS + 1))
+              continue
+            else
+              printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+              assetFilenames[$asset]=1
+            fi
+
+            # Download artifact by artifact name
+            if [[ -n "${downloadedArtifacts[$artifact]}" ]]; then
+              printf "  %s\n" "downloading '${artifact}' ... ${ANSI_LIGHT_YELLOW}[SKIPPED]${ANSI_NOCOLOR}"
+            else
+              echo    "  downloading '${artifact}' ... "
+              printf "    %s" "gh run download $GITHUB_RUN_ID --dir \"${artifact}\" --name \"${artifact}\" "
+              gh run download $GITHUB_RUN_ID --dir "${artifact}" --name "${artifact}"
+              if [[ $? -eq 0 ]]; then
+                printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+              else
+                printf "%s\n" "${ANSI_LIGHT_RED}[ERROR]${ANSI_NOCOLOR}"
+                printf "      %s\n" "${ANSI_LIGHT_RED}Couldn't download artifact '${artifact}'.${ANSI_NOCOLOR}"
+                printf "%s\n" "::error title=ArtifactNotFound::Couldn't download artifact '${artifact}'."
+                ERRORS=$((ERRORS + 1))
+                continue
+              fi
+              downloadedArtifacts[$artifact]=1
+
+              printf "  %s" "Checking for embedded tarball ... "
+              if [[ -f "${artifact}/${{ inputs.tarball-name }}" ]]; then
+                printf "%s\n" "${ANSI_LIGHT_GREEN}[FOUND]${ANSI_NOCOLOR}"
+
+                pushd "${artifact}" > /dev/null
+
+                printf "    %s" "Extracting embedded tarball ... "
+                tar -xf "${{ inputs.tarball-name }}"
+                if [[ $? -ne 0 ]]; then
+                  printf "%s\n" "${ANSI_LIGHT_RED}[FAILED]${ANSI_NOCOLOR}"
+                else
+                  printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+                fi
+
+                printf "    %s" "Removing temporary tarball ... "
+                rm -f "${{ inputs.tarball-name }}"
+                if [[ $? -ne 0 ]]; then
+                  printf "%s\n" "${ANSI_LIGHT_RED}[FAILED]${ANSI_NOCOLOR}"
+                else
+                  printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+                fi
+
+                popd > /dev/null
+              else
+                printf "%s\n" "${ANSI_LIGHT_YELLOW}[SKIPPED]${ANSI_NOCOLOR}"
+              fi
+            fi
+
+            # Check if artifact should be compressed (zip, tgz) or if asset was part of the downloaded artifact.
+            printf "  %s" "checking asset '${artifact}/${asset}' ... "
+            if [[ "${asset}" == !*.zip ]]; then
+              printf "%s\n" "${ANSI_LIGHT_GREEN}[ZIP]${ANSI_NOCOLOR}"
+              asset="${asset##*!}"
+              printf "::group::    %s\n" "Compressing artifact '${artifact}' to '${asset}' ..."
+              (
+                cd "${artifact}" && \
+                zip -r "../${asset}" *
+              )
+              retCode=$?
+              printf "::endgroup::\n"
+              if [[ $retCode -eq 0 ]]; then
+                printf "    %s\n" "Compression ${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+                uploadFile="${asset}"
+              else
+                printf "    %s\n" "Compression ${ANSI_LIGHT_RED}[ERROR]${ANSI_NOCOLOR}"
+                printf "      %s\n" "${ANSI_LIGHT_RED}Couldn't compress '${artifact}' to zip file '${asset}'.${ANSI_NOCOLOR}"
+                printf "%s\n" "::error title=CompressionError::Couldn't compress '${artifact}' to zip file '${asset}'."
+                ERRORS=$((ERRORS + 1))
+                continue
+              fi
+            elif [[ "${asset}" == !*.tgz || "${asset}" == !*.tar.gz || "${asset}" == \$*.tgz || "${asset}" == \$*.tar.gz ]]; then
+              printf "%s\n" "${ANSI_LIGHT_GREEN}[TAR/GZ]${ANSI_NOCOLOR}"
+
+              if [[ "${asset:0:1}" == "\$" ]]; then
+                asset="${asset##*$}"
+                dirName="${asset%.*}"
+                printf "    %s\n" "Compressing artifact '${artifact}' to '${asset}' ..."
+                tar -c --gzip --owner=0 --group=0 --file="${asset}" --directory="${artifact}" --transform "s|^\.|${dirName%.tar}|" .
+                retCode=$?
+              else
+                asset="${asset##*!}"
+                printf "    %s\n" "Compressing artifact '${artifact}' to '${asset}' ..."
+                (
+                  cd "${artifact}" && \
+                  tar -c --gzip --owner=0 --group=0 --file="../${asset}" *
+                )
+                retCode=$?
+              fi
+
+              if [[ $retCode -eq 0 ]]; then
+                printf "    %s\n" "Compression ${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+                uploadFile="${asset}"
+              else
+                printf "    %s\n" "Compression ${ANSI_LIGHT_RED}[ERROR]${ANSI_NOCOLOR}"
+                printf "      %s\n" "${ANSI_LIGHT_RED}Couldn't compress '${artifact}' to tgz file '${asset}'.${ANSI_NOCOLOR}"
+                printf "%s\n" "::error title=CompressionError::Couldn't compress '${artifact}' to tgz file '${asset}'."
+                ERRORS=$((ERRORS + 1))
+                continue
+              fi
+            elif [[ "${asset}" == !*.tzst || "${asset}" == !*.tar.zst || "${asset}" == \$*.tzst || "${asset}" == \$*.tar.zst ]]; then
+              printf "%s\n" "${ANSI_LIGHT_GREEN}[ZST]${ANSI_NOCOLOR}"
+
+              if [[ "${asset:0:1}" == "\$" ]]; then
+                asset="${asset##*$}"
+                dirName="${asset%.*}"
+                printf "    %s\n" "Compressing artifact '${artifact}' to '${asset}' ..."
+                tar -c --zstd --owner=0 --group=0 --file="${asset}" --directory="${artifact}" --transform "s|^\.|${dirName%.tar}|" .
+                retCode=$?
+              else
+                asset="${asset##*!}"
+                printf "    %s\n" "Compressing artifact '${artifact}' to '${asset}' ..."
+                (
+                  cd "${artifact}" && \
+                  tar -c --zstd --owner=0 --group=0 --file="../${asset}" *
+                )
+                retCode=$?
+              fi
+
+              if [[ $retCode -eq 0 ]]; then
+                printf "    %s\n" "Compression ${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+                uploadFile="${asset}"
+              else
+                printf "    %s\n" "Compression ${ANSI_LIGHT_RED}[ERROR]${ANSI_NOCOLOR}"
+                printf "      %s\n" "${ANSI_LIGHT_RED}Couldn't compress '${artifact}' to zst file '${asset}'.${ANSI_NOCOLOR}"
+                printf "%s\n" "::error title=CompressionError::Couldn't compress '${artifact}' to zst file '${asset}'."
+                ERRORS=$((ERRORS + 1))
+                continue
+              fi
+            elif [[ -e "${artifact}/${asset}" ]]; then
+              printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+              uploadFile="${artifact}/${asset}"
+            else
+              printf "%s\n" "${ANSI_LIGHT_RED}[ERROR]${ANSI_NOCOLOR}"
+              printf "    %s\n" "${ANSI_LIGHT_RED}Couldn't find asset '${asset}' in artifact '${artifact}'.${ANSI_NOCOLOR}"
+              printf "%s\n" "::error title=FileNotFound::Couldn't find asset '${asset}' in artifact '${artifact}'."
+              ERRORS=$((ERRORS + 1))
+              continue
+            fi
+
+            # Add asset to JSON inventory
+            if [[ "${{ inputs.inventory-json }}" != "" ]]; then
+              if [[ "${categories}" != "${title}" ]]; then
+                printf "  %s\n" "adding file '${uploadFile#*/}' with '${categories//;/ → }' to JSON inventory ..."
+                category=""
+                jsonEntry=$(jq -c -n \
+                  --arg title "${title}" \
+                  --arg file "${uploadFile#*/}" \
+                  '{"file": $file, "title": $title}' \
+                )
+
+                while [[ "${categories}" != "${category}" ]]; do
+                  category="${categories##*,}"
+                  categories="${categories%,*}"
+                  jsonEntry=$(jq -c -n --arg cat "${category}" --argjson value "${jsonEntry}" '{$cat: $value}')
+                done
+
+                jsonInventory=$(jq -c -n \
+                  --argjson inventory "${jsonInventory}" \
+                  --argjson file "${jsonEntry}" \
+                  '$inventory * {"files": $file}' \
+                )
+              else
+                printf "  %s\n" "adding file '${uploadFile#*/}' to JSON inventory ... ${ANSI_LIGHT_YELLOW}[SKIPPED]${ANSI_NOCOLOR}"
+              fi
+            fi
+
+            # Upload asset to existing release page
+            printf "  %s" "uploading asset '${asset}' from '${uploadFile}' with title '${title}' ... "
+            gh release upload ${{ inputs.nightly_name }} "${uploadFile}#${title}" --clobber
+            if [[ $? -eq 0 ]]; then
+              printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+            else
+              printf "%s\n" "${ANSI_LIGHT_RED}[ERROR]${ANSI_NOCOLOR}"
+              printf "    %s\n" "${ANSI_LIGHT_RED}Couldn't upload asset '${asset}' from '${uploadFile}' to release '${{ inputs.nightly_name }}'.${ANSI_NOCOLOR}"
+              printf "%s\n" "::error title=UploadError::Couldn't upload asset '${asset}' from '${uploadFile}' to release '${{ inputs.nightly_name }}'."
+              ERRORS=$((ERRORS + 1))
+              continue
+            fi
+          done <<<'${{ inputs.assets }}'
+
+          if [[ "${{ inputs.inventory-json }}" != "" ]]; then
+            inventoryTitle="Release Inventory (JSON)"
+
+            printf "%s\n" "Publish asset '${{ inputs.inventory-json }}' with title '${inventoryTitle}'"
+            printf "::group::${ANSI_LIGHT_BLUE}%s${ANSI_NOCOLOR}\n" "Writing JSON inventory to '${{ inputs.inventory-json }}' ...."
+            printf "%s\n" "$(jq -n --argjson inventory "${jsonInventory}" '$inventory')" > "${{ inputs.inventory-json }}"
+            cat "${{ inputs.inventory-json }}"
+            printf "::endgroup::\n"
+
+            # Upload inventory asset to existing release page
+            printf "  %s" "uploading asset '${{ inputs.inventory-json }}' title '${inventoryTitle}' ... "
+            gh release upload ${{ inputs.nightly_name }} "${{ inputs.inventory-json }}#${inventoryTitle}" --clobber
+            if [[ $? -eq 0 ]]; then
+              printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+            else
+              printf "%s\n" "${ANSI_LIGHT_RED}[ERROR]${ANSI_NOCOLOR}"
+              printf "    %s\n" "${ANSI_LIGHT_RED}Couldn't upload asset '${{ inputs.inventory-json }}' to release '${{ inputs.nightly_name }}'.${ANSI_NOCOLOR}"
+              printf "%s\n" "::error title=UploadError::Couldn't upload asset '${{ inputs.inventory-json }}' to release '${{ inputs.nightly_name }}'."
+              ERRORS=$((ERRORS + 1))
+              continue
+            fi
+          fi
+
+          printf "::group::${ANSI_LIGHT_BLUE}%s${ANSI_NOCOLOR}\n" "Inspecting downloaded artifacts ..."
+          tree -pash -L 3 .
+          printf "::endgroup::\n"
+
+          if [[ $ERRORS -ne 0 ]]; then
+            printf "%s\n" "${ANSI_LIGHT_RED}${ERRORS} errors detected in previous steps.${ANSI_NOCOLOR}"
+            exit 1
+          fi
+
+      - name: 📑 Remove draft state from Release Page
+        if: ${{ ! inputs.draft }}
+        run: |
+          set +e
+
+          ANSI_LIGHT_RED=$'\x1b[91m'
+          ANSI_LIGHT_GREEN=$'\x1b[92m'
+          ANSI_NOCOLOR=$'\x1b[0m'
+
+          export GH_TOKEN=${{ github.token }}
+
+          # Remove draft-state from release page
+          printf "%s" "Remove draft-state from release '${title}' ... "
+          gh release edit --draft=false "${{ inputs.nightly_name }}"
+          if [[ $? -eq 0 ]]; then
+            printf "%s\n" "${ANSI_LIGHT_GREEN}[OK]${ANSI_NOCOLOR}"
+          else
+            printf "%s\n" "${ANSI_LIGHT_RED}[ERROR]${ANSI_NOCOLOR}"
+            printf "  %s\n" "${ANSI_LIGHT_RED}Couldn't remove draft-state from release '${{ inputs.nightly_name }}'.${ANSI_NOCOLOR}"
+            printf "%s\n" "::error title=ReleasePage::Couldn't remove draft-state from release '${{ inputs.nightly_name }}'."
+          fi

.github/workflows/Package.yml

@@ -25,10 +25,15 @@ name: Package
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       python_version:
         description: 'Python version.'
         required: false
-        default: '3.12'
+        default: '3.13'
         type: string
       requirements:
         description: 'Python dependencies to be installed through pip; if empty, use pyproject.toml through build.'
@@ -44,11 +49,14 @@ jobs:
 
   Package:
     name: 📦 Package in Source and Wheel Format
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
 
     steps:
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
+        with:
+          lfs: true
+          submodules: true
 
       - name: 🐍 Setup Python ${{ inputs.python_version }}
         uses: actions/setup-python@v5
@@ -98,9 +106,10 @@ jobs:
         run: python setup.py bdist_wheel
 
       - name: 📤 Upload wheel artifact
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         with:
           name: ${{ inputs.artifact }}
-          path: dist/
+          working-directory: dist
+          path: '*'
           if-no-files-found: error
           retention-days: 1

.github/workflows/Parameters.yml

@@ -25,24 +25,40 @@ name: Parameters
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       name:
         description: 'Name of the tool.'
-        required: true
+        required: false
+        default: ''
+        type: string
+      package_namespace:
+        description: 'Name of the tool''s namespace.'
+        required: false
+        default: ''
+        type: string
+      package_name:
+        description: 'Name of the tool''s package.'
+        required: false
+        default: ''
         type: string
       python_version:
         description: 'Python version.'
         required: false
-        default: '3.12'
+        default: '3.13'
         type: string
       python_version_list:
         description: 'Space separated list of Python versions to run tests with.'
         required: false
-        default: '3.8 3.9 3.10 3.11 3.12'
+        default: '3.9 3.10 3.11 3.12 3.13'
         type: string
       system_list:
         description: 'Space separated list of systems to run tests on.'
         required: false
-        default: 'ubuntu windows macos mingw64 ucrt64'
+        default: 'ubuntu windows macos macos-arm mingw64 ucrt64'
         type: string
       include_list:
         description: 'Space separated list of system:python items to be included into the list of test.'
@@ -59,6 +75,26 @@ on:
         required: false
         default: ''
         type: string
+      ubuntu_image:
+        description: 'The used GitHub Action image for Ubuntu based jobs.'
+        required: false
+        default: 'ubuntu-24.04'
+        type: string
+      windows_image:
+        description: 'The used GitHub Action image for Windows based jobs.'
+        required: false
+        default: 'windows-2022'
+        type: string
+      macos_intel_image:
+        description: 'The used GitHub Action image for macOS (Intel x86-64) based jobs.'
+        required: false
+        default: 'macos-13'
+        type: string
+      macos_arm_image:
+        description: 'The used GitHub Action image for macOS (ARM aarch64) based jobs.'
+        required: false
+        default: 'macos-14'
+        type: string
 
     outputs:
       python_version:
@@ -76,7 +112,8 @@ on:
 
 jobs:
   Parameters:
-    runs-on: ubuntu-latest
+    name: ✎ Generate pipeline parameters
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
     outputs:
       python_version:   ${{ steps.params.outputs.python_version }}
       python_jobs:      ${{ steps.params.outputs.python_jobs }}
@@ -91,10 +128,12 @@ jobs:
           from json import dumps as json_dumps
           from os import getenv
           from pathlib import Path
-          from pprint import pprint
           from textwrap import dedent
+          from typing import Iterable
 
-          name =           "${{ inputs.name }}".strip()
+          package_namespace = "${{ inputs.package_namespace }}".strip()
+          package_name =      "${{ inputs.package_name }}".strip()
+          name =              "${{ inputs.name }}".strip()
           python_version = "${{ inputs.python_version }}".strip()
           systems =        "${{ inputs.system_list }}".strip()
           versions =       "${{ inputs.python_version_list }}".strip()
@@ -102,9 +141,15 @@ jobs:
           exclude_list =   "${{ inputs.exclude_list }}".strip()
           disable_list =   "${{ inputs.disable_list }}".strip()
 
-          currentMSYS2Version = "3.11"
-          currentAlphaVersion = "3.13"
-          currentAlphaRelease = "3.13.0-alpha.1"
+          if name == "":
+            if package_namespace == "" or package_namespace == ".":
+              name = f"{package_name}"
+            else:
+              name = f"{package_namespace}.{package_name}"
+
+          currentMSYS2Version = "3.12"
+          currentAlphaVersion = "3.14"
+          currentAlphaRelease = "3.14.0-alpha.1"
 
           if systems == "":
             print("::error title=Parameter::system_list is empty.")
@@ -131,36 +176,38 @@ jobs:
           else:
             disabled = [disable.strip() for disable in disable_list.split(" ")]
 
-          if "3.7" in versions:
-            print("::warning title=Deprecated::Support for Python 3.7 ended in 2023.06.27.")
+          if "3.8" in versions:
+            print("::warning title=Deprecated::Support for Python 3.8 ended in 2024.10.")
           if "msys2" in systems:
             print("::warning title=Deprecated::System 'msys2' will be replaced by 'mingw64'.")
           if currentAlphaVersion in versions:
             print(f"::notice title=Experimental::Python {currentAlphaVersion} ({currentAlphaRelease}) is a pre-release.")
           for disable in disabled:
-            print(f"::warning title=Disabled Python Job::System '{disable}' temporary disabled.")
+            print(f"::warning title=Disabled Python Job::System '{disable}' temporarily disabled.")
 
           # see https://raw.githubusercontent.com/actions/python-versions/main/versions-manifest.json
           data = {
             # Python and PyPy versions supported by "setup-python" action
             "python": {
-              "3.7":       { "icon": "⚫",  "until": "2023.06.27" },
-              "3.8":       { "icon": "🔴",  "until": "2024.10" },
-              "3.9":       { "icon": "🟠",  "until": "2025.10" },
-              "3.10":      { "icon": "🟡",  "until": "2026.10" },
-              "3.11":      { "icon": "🟢",  "until": "2027.10" },
+              "3.8":       { "icon": "⚫",  "until": "2024.10" },
+              "3.9":       { "icon": "🔴",  "until": "2025.10" },
+              "3.10":      { "icon": "🟠",  "until": "2026.10" },
+              "3.11":      { "icon": "🟡",  "until": "2027.10" },
               "3.12":      { "icon": "🟢",  "until": "2028.10" },
-            #  "3.13":      { "icon": "🟣",  "until": "2028.10" },
+              "3.13":      { "icon": "🟢",  "until": "2029.10" },
+              "3.14":      { "icon": "🟣",  "until": "2030.10" },
               "pypy-3.7":  { "icon": "⟲⚫", "until": "????.??" },
-              "pypy-3.8":  { "icon": "⟲🔴", "until": "????.??" },
-              "pypy-3.9":  { "icon": "⟲🟠", "until": "????.??" },
-              "pypy-3.10": { "icon": "⟲🟡", "until": "????.??" },
+              "pypy-3.8":  { "icon": "⟲⚫", "until": "????.??" },
+              "pypy-3.9":  { "icon": "⟲🔴", "until": "????.??" },
+              "pypy-3.10": { "icon": "⟲🟠", "until": "????.??" },
+              "pypy-3.11": { "icon": "⟲🟡", "until": "????.??" },
             },
             # Runner systems (runner images) supported by GitHub Actions
             "sys": {
-              "ubuntu":  { "icon": "🐧", "runs-on": "ubuntu-latest",  "shell": "bash", "name": "Linux (x86-64)",   "minPy": (3,  7)},
-              "windows": { "icon": "🪟", "runs-on": "windows-latest", "shell": "pwsh", "name": "Windows (x86-64)", "minPy": (3,  7)},
-              "macos":   { "icon": "🍎", "runs-on": "macos-latest",   "shell": "bash", "name": "MacOS (x86-64)",   "minPy": (3, 10)},
+              "ubuntu":    { "icon": "🐧", "runs-on": "${{ inputs.ubuntu_image }}",      "shell": "bash", "name": "Linux (x86-64)"   },
+              "windows":   { "icon": "🪟", "runs-on": "${{ inputs.windows_image }}",     "shell": "pwsh", "name": "Windows (x86-64)" },
+              "macos":     { "icon": "🍎", "runs-on": "${{ inputs.macos_intel_image }}", "shell": "bash", "name": "macOS (x86-64)"   },
+              "macos-arm": { "icon": "🍏", "runs-on": "${{ inputs.macos_arm_image }}",   "shell": "bash", "name": "macOS (aarch64)"  },
             },
             # Runtimes provided by MSYS2
             "runtime": {
@@ -183,9 +230,23 @@ jobs:
           for disable in disabled:
             print(f"- {disable}")
 
-          def toVersion(value):
-            major, minor = value.split(".")
-            return int(major[-1]), int(minor)
+          def match(combination: str, pattern: str) -> bool:
+              system, version = combination.split(":")
+              sys, ver = pattern.split(":")
+
+              if sys == "*":
+                  return (ver == "*") or (version == ver)
+              elif system == sys:
+                  return (ver == "*") or (version == ver)
+              else:
+                  return False
+
+          def notIn(combination: str, patterns: Iterable[str]) -> bool:
+              for pattern in patterns:
+                  if match(combination, pattern):
+                      return False
+
+              return True
 
           combinations = [
             (system, version)
@@ -193,22 +254,20 @@ jobs:
               if system in data["sys"]
             for version in versions
               if version in data["python"]
-              and toVersion(version) >= data["sys"][system]["minPy"]
-              and f"{system}:{version}" not in excludes
-              and f"{system}:{version}" not in disabled
+              and notIn(f"{system}:{version}", excludes)
+              and notIn(f"{system}:{version}", disabled)
           ] + [
             (system, currentMSYS2Version)
             for system in systems
               if system in data["runtime"]
-              and f"{system}:{currentMSYS2Version}" not in excludes
-              and f"{system}:{currentMSYS2Version}" not in disabled
+              and notIn(f"{system}:{currentMSYS2Version}", excludes)
+              and notIn(f"{system}:{currentMSYS2Version}", disabled)
           ] + [
             (system, version)
             for system, version in includes
               if system in data["sys"]
               and version in data["python"]
-              and toVersion(version) >= data["sys"][system]["minPy"]
-              and f"{system}:{version}" not in disabled
+              and notIn(f"{system}:{version}", disabled)
           ]
           print(f"Combinations ({len(combinations)}):")
           for system, version in combinations:
@@ -257,18 +316,6 @@ jobs:
             "documentation_pdf":   f"{name}-Documentation-PDF",
           }
 
-          # Deprecated structure
-          params = {
-            "python_version": python_version,
-            "artifacts": {
-              "unittesting": f"{artifact_names['unittesting_xml']}",
-              "coverage":    f"{artifact_names['codecoverage_html']}",
-              "typing":      f"{artifact_names['statictyping_html']}",
-              "package":     f"{artifact_names['package_all']}",
-              "doc":         f"{artifact_names['documentation_html']}",
-            }
-          }
-
           print("Parameters:")
           print(f"  python_version: {python_version}")
           print(f"  python_jobs ({len(jobs)}):\n" +
@@ -286,13 +333,12 @@ jobs:
               python_version={python_version}
               python_jobs={json_dumps(jobs)}
               artifact_names={json_dumps(artifact_names)}
-              params={json_dumps(params)}
           """))
 
       - name: Verify out parameters
         id: verify
         run: |
-          echo 'python_version: ${{ steps.params.outputs.python_version }}'
-          echo 'python_jobs: ${{ steps.params.outputs.python_jobs }}'
-          echo 'artifact_names: ${{ steps.params.outputs.artifact_names }}'
-          echo 'params: ${{ steps.params.outputs.params }}'
+          printf "python_version: %s\n" '${{ steps.params.outputs.python_version }}'
+          printf "python_jobs:    %s\n" '${{ steps.params.outputs.python_jobs }}'
+          printf "artifact_names: %s\n" '${{ steps.params.outputs.artifact_names }}'
+          printf "params:         %s\n" '${{ steps.params.outputs.params }}'

.github/workflows/PublishCoverageResults.yml

@@ -24,6 +24,15 @@ name: Publish Code Coverage Results
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
+      coverage_artifacts_pattern:
+        required: false
+        default: '*-CodeCoverage-SQLite-*'
+        type: string
       coverage_config:
         description: 'Path to the .coveragerc file. Use pyproject.toml by default.'
         required: false
@@ -39,101 +48,91 @@ on:
         required: false
         default: ''
         type: string
+      coverage_report_xml_directory:
+        description: 'Directory containing the XML coverage report file.'
+        required: false
+        default: 'report/coverage'
+        type: string
+      coverage_report_xml_filename:
+        description: 'Filename of the XML coverage report file.'
+        required: false
+        default: 'coverage.xml'
+        type: string
       coverage_json_artifact:
         description: 'Name of the JSON coverage artifact.'
         required: false
         default: ''
         type: string
+      coverage_report_json_directory:
+        description: 'Directory containing the JSON coverage report file.'
+        required: false
+        default: 'report/coverage'
+        type: string
+      coverage_report_json_filename:
+        description: 'Filename of the JSON coverage report file.'
+        required: false
+        default: 'coverage.json'
+        type: string
       coverage_html_artifact:
         description: 'Name of the HTML coverage artifact.'
         required: false
         default: ''
         type: string
+      coverage_report_html_directory:
+        description: 'HTML root directory of the generated coverage report.'
+        required: false
+        default: 'report/coverage/html'
+        type: string
+      codecov:
+        description: 'Publish merged coverage report to Codecov.'
+        required: false
+        default: false
+        type: boolean
+      codacy:
+        description: 'Publish merged coverage report to Codacy.'
+        required: false
+        default: false
+        type: boolean
     secrets:
-      codacy_token:
-        description: 'Token to push result to codacy.'
+      CODECOV_TOKEN:
+        description: 'Token to push result to Codecov.'
+        required: true
+      CODACY_TOKEN:
+        description: 'Token to push result to Codacy.'
         required: true
 
 jobs:
   PublishCoverageResults:
     name: 📊 Publish Code Coverage Results
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
     if: always()
 
     steps:
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
-
-      - name: Download Artifacts
-        uses: actions/download-artifact@v4
         with:
+          lfs: true
+          submodules: true
+
+      - name: 📥 Download Artifacts
+        uses: pyTooling/download-artifact@v4
+        with:
+          pattern: ${{ inputs.coverage_artifacts_pattern }}
           path: artifacts
 
+      - name: 🔎 Inspect extracted artifact (tarball)
+        run: |
+          tree -pash artifacts
+
       - name: 🔧 Install coverage and tomli
         run: |
-          python -m pip install --disable-pip-version-check -U coverage[toml] tomli
+          python -m pip install -U --disable-pip-version-check --break-system-packages coverage[toml] tomli
 
-      - name: 🔁 Extract configurations from pyproject.toml
-        id: getVariables
-        shell: python
-        run: |
-          from os       import getenv
-          from pathlib  import Path
-          from sys      import version
-          from textwrap import dedent
-
-          print(f"Python: {version}")
-
-          from tomli import load as tomli_load
-
-          htmlDirectory = Path("htmlcov")
-          xmlFile =  Path("./coverage.xml")
-          jsonFile = Path("./coverage.json")
-          coverageRC = "${{ inputs.coverage_config }}".strip()
-
-          # Read output paths from 'pyproject.toml' file
-          if coverageRC == "pyproject.toml":
-            pyProjectFile =  Path("pyproject.toml")
-            if pyProjectFile.exists():
-              with pyProjectFile.open("rb") as file:
-                pyProjectSettings = tomli_load(file)
-
-              htmlDirectory = Path(pyProjectSettings["tool"]["coverage"]["html"]["directory"])
-              xmlFile       = Path(pyProjectSettings["tool"]["coverage"]["xml"]["output"])
-              jsonFile      = Path(pyProjectSettings["tool"]["coverage"]["json"]["output"])
-            else:
-              print(f"File '{pyProjectFile}' not found and no '.coveragerc' file specified.")
-
-          # Read output paths from '.coveragerc' file
-          elif len(coverageRC) > 0:
-            coverageRCFile = Path(coverageRC)
-            if coverageRCFile.exists():
-              with coverageRCFile.open("rb") as file:
-                coverageRCSettings = tomli_load(file)
-
-              htmlDirectory = Path(coverageRCSettings["html"]["directory"])
-              xmlFile       = Path(coverageRCSettings["xml"]["output"])
-              jsonFile      = Path(coverageRCSettings["json"]["output"])
-            else:
-              print(f"File '{coverageRCFile}' not found.")
-
-          # Write jobs to special file
-          github_output = Path(getenv("GITHUB_OUTPUT"))
-          print(f"GITHUB_OUTPUT: {github_output}")
-          with github_output.open("a+", encoding="utf-8") as f:
-            f.write(dedent(f"""\
-              coverage_report_html_directory={htmlDirectory.as_posix()}
-              coverage_report_xml={xmlFile}
-              coverage_report_json={jsonFile}
-            """))
-
-          print(f"DEBUG:\n  html={htmlDirectory}\n  xml={xmlFile}\n  json={jsonFile}")
-
-      - name: Rename .coverage files and collect them all to coverage/
+      - name: Rename .coverage files and move them all into 'coverage/'
         run: |
           mkdir -p coverage
-          find . -type f -path "*artifacts*SQLite*.coverage" -exec sh -c 'cp -v $0 "coverage/$(basename $0).$(basename $(dirname $0))"' {} ';'
-          tree -a coverage
+          find artifacts/ -type f -path "*SQLite*.coverage" -exec sh -c 'cp -v $0 "coverage/$(basename $0).$(basename $(dirname $0))"' {} ';'
+          tree -pash coverage
 
       - name: Combine SQLite files (using Coverage.py)
         run: coverage combine --data-file=.coverage coverage/
@@ -142,7 +141,7 @@ jobs:
         run: coverage report --rcfile=pyproject.toml --data-file=.coverage
 
       - name: Convert to XML format (Cobertura)
-        if: inputs.coverage_xml_artifact != ''
+        if: inputs.coverage_xml_artifact != '' || inputs.codecov || inputs.codacy
         run: coverage xml --data-file=.coverage
 
       - name: Convert to JSON format
@@ -154,12 +153,12 @@ jobs:
         run: |
           coverage html --data-file=.coverage -d report/coverage/html
           rm report/coverage/html/.gitignore
-          tree -a report/coverage/html
+          tree -pash report/coverage/html
 
       - name: 📤 Upload 'Coverage SQLite Database' artifact
+        uses: pyTooling/upload-artifact@v4
         if: inputs.coverage_sqlite_artifact != ''
         continue-on-error: true
-        uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.coverage_sqlite_artifact }}
           path: .coverage
@@ -167,48 +166,54 @@ jobs:
           retention-days: 1
 
       - name: 📤 Upload 'Coverage XML Report' artifact
+        uses: pyTooling/upload-artifact@v4
         if: inputs.coverage_xml_artifact != ''
         continue-on-error: true
-        uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.coverage_xml_artifact }}
-          path: ${{ steps.getVariables.outputs.coverage_report_xml }}
+          working-directory: ${{ inputs.coverage_report_xml_directory }}
+          path: ${{ inputs.coverage_report_xml_filename }}
           if-no-files-found: error
           retention-days: 1
 
       - name: 📤 Upload 'Coverage JSON Report' artifact
+        uses: pyTooling/upload-artifact@v4
         if: inputs.coverage_json_artifact != ''
         continue-on-error: true
-        uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.coverage_json_artifact }}
-          path: ${{ steps.getVariables.outputs.coverage_report_json }}
+          working-directory: ${{ inputs.coverage_report_json_directory }}
+          path: ${{ inputs.coverage_report_json_filename }}
           if-no-files-found: error
           retention-days: 1
 
       - name: 📤 Upload 'Coverage HTML Report' artifact
+        uses: pyTooling/upload-artifact@v4
         if: inputs.coverage_html_artifact != ''
         continue-on-error: true
-        uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.coverage_html_artifact }}
-          path: ${{ steps.getVariables.outputs.coverage_report_html_directory }}
+          working-directory: ${{ inputs.coverage_report_html_directory }}
+          path: '*'
           if-no-files-found: error
           retention-days: 1
 
       - name: 📊 Publish code coverage at CodeCov
-        if: inputs.CodeCov == true
+        uses: codecov/codecov-action@v5
+        if: inputs.codecov
         continue-on-error: true
-        uses: codecov/codecov-action@v4
         with:
-          files: ${{ steps.getVariables.outputs.coverage_report_xml }}
+          token: ${{ secrets.CODECOV_TOKEN }}
+          disable_search: true
+          files: ${{ inputs.coverage_report_xml_directory }}/${{ inputs.coverage_report_xml_filename }}
           flags: unittests
           env_vars: PYTHON
+          fail_ci_if_error: true
 
       - name: 📉 Publish code coverage at Codacy
-        if: inputs.Codacy == true
-        continue-on-error: true
         uses: codacy/codacy-coverage-reporter-action@v1
+        if: inputs.codacy
+        continue-on-error: true
         with:
-          project-token: ${{ secrets.codacy_token }}
-          coverage-reports: ${{ steps.getVariables.outputs.coverage_report_xml }}
+          project-token: ${{ secrets.CODACY_TOKEN }}
+          coverage-reports: ${{ inputs.coverage_report_xml_directory }}/${{ inputs.coverage_report_xml_filename }}

.github/workflows/PublishOnPyPI.yml

@@ -25,10 +25,15 @@ name: Publish on PyPI
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       python_version:
         description: 'Python version.'
         required: false
-        default: '3.12'
+        default: '3.13'
         type: string
       requirements:
         description: 'Python dependencies to be installed through pip.'
@@ -48,14 +53,14 @@ jobs:
 
   PublishOnPyPI:
     name: 🚀 Publish to PyPI
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
 
     steps:
       - name: 📥 Download artifacts '${{ inputs.artifact }}' from 'Package' job
-        uses: actions/download-artifact@v4
+        uses: pyTooling/download-artifact@v4
         with:
           name: ${{ inputs.artifact }}
-          path: dist/
+          path: dist
 
       - name: 🐍 Setup Python ${{ inputs.python_version }}
         uses: actions/setup-python@v5

.github/workflows/PublishTestResults.yml

@@ -25,65 +25,119 @@ name: Publish Unit Test Results
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
+      unittest_artifacts_pattern:
+        required: false
+        default: '*-UnitTestReportSummary-XML-*'
+        type: string
+      merged_junit_filename:
+        description: 'Filename of the merged JUnit Test Summary.'
+        required: false
+        default: 'Unittesting.xml'
+        type: string
       merged_junit_artifact:
         description: 'Name of the merged JUnit Test Summary artifact.'
         required: false
         default: ''
         type: string
+      additional_merge_args:
+        description: 'Additional merging arguments.'
+        required: false
+        default: '"--pytest=rewrite-dunder-init;reduce-depth:pytest.tests.unit"'
+        type: string
+      testsuite-summary-name:
+        description: 'Set TestsuiteSummary name.'
+        required: false
+        default: ''
+        type: string
+      publish:
+        description: 'Publish test report summary via Dorny Test-Reporter'
+        required: false
+        default: true
+        type: boolean
+      report_title:
+        description: 'Title of the summary report in the pipeline''s sidebar'
+        required: false
+        default: 'Unit Test Results'
+        type: string
+      dorny:
+        description: 'Publish merged unittest results via Dorny Test-Reporter.'
+        required: false
+        default: true
+        type: boolean
+      codecov:
+        description: 'Publish merged unittest results to Codecov.'
+        required: false
+        default: true
+        type: boolean
+    secrets:
+      CODECOV_TOKEN:
+        description: 'Token to push result to Codecov.'
+        required: true
 
 jobs:
   PublishTestResults:
     name: 📊 Publish Test Results
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
     if: always()
 
     steps:
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
 
-      - name: Download Artifacts
-        uses: actions/download-artifact@v4
+      - name: 📥 Download Artifacts
+        uses: pyTooling/download-artifact@v4
         with:
-          path: artifacts
+          pattern: ${{ inputs.unittest_artifacts_pattern }}
+          path:    artifacts
 
-      - name: 🔧 Install junitparser
+      - name: 🔎 Inspect extracted artifact (tarball)
         run: |
-          python -m pip install --disable-pip-version-check -U junitparser
+          tree -pash artifacts
 
-      - name: Move JUnit files and collect them all to junit/
+      - name: 🔧 Install pyEDAA.Reports (JUunit Parser and Merger)
+        run: |
+          python -m pip install --disable-pip-version-check --break-system-packages -U pyEDAA.Reports
+
+      - name: Rename JUnit files and move them all into 'junit/'
         run: |
           mkdir -p junit
-          find . -type f -path "*artifacts*UnitTestReportSummary*.xml" -exec sh -c 'cp -v $0 "junit/$(basename $(dirname $0)).$(basename $0)"' {} ';'
-          tree -a junit
+          find artifacts/ -type f -path "*.xml" -exec sh -c 'cp -v $0 "junit/$(basename $(dirname $0)).$(basename $0)"' {} ';'
+          tree -pash junit
 
       - name: 🔁 Merge JUnit Unit Test Summaries
-        shell: python
         run: |
-          from pathlib     import Path
-          from junitparser import JUnitXml
-
-          junitDirectory = Path("junit")
-          junitXml = None
-          for file in junitDirectory.iterdir():
-            if junitXml is None:
-              junitXml = JUnitXml.fromfile(file)
-            else:
-              junitXml += JUnitXml.fromfile(file)
-
-          junitXml.write(junitDirectory / "merged.xml")
+          pyedaa-reports -v unittest "--name=${{ inputs.testsuite-summary-name }}" "--merge=pyTest-JUnit:junit/*.xml" ${{ inputs.additional_merge_args }} "--output=pyTest-JUnit:${{ inputs.merged_junit_filename }}"
+          printf "%s\n" "cat ${{ inputs.merged_junit_filename }}"
+          cat ${{ inputs.merged_junit_filename }}
 
       - name: 📊 Publish Unit Test Results
-        uses: dorny/test-reporter@v1
+        uses: dorny/test-reporter@v2
+        if: (inputs.dorny || inputs.publish) && inputs.report_title != ''
         with:
-          name: Unit Test Results
-          path: junit/merged.xml
+          name: ${{ inputs.report_title }}
+          path: ${{ inputs.merged_junit_filename }}
           reporter: java-junit
 
+      - name: 📊 Publish unittest results at CodeCov
+        uses: codecov/test-results-action@v1
+        if: inputs.codecov
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          disable_search: true
+          files: ${{ inputs.merged_junit_filename }}
+          fail_ci_if_error: true
+
       - name: 📤 Upload merged 'JUnit Test Summary' artifact
+        uses: pyTooling/upload-artifact@v4
         if: inputs.merged_junit_artifact != ''
-        uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.merged_junit_artifact }}
-          path: junit/merged.xml
+          path: ${{ inputs.merged_junit_filename }}
           if-no-files-found: error
           retention-days: 1
+          investigate: true

.github/workflows/PublishToGitHubPages.yml

@@ -25,6 +25,11 @@ name: Publish to GitHub Pages
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       doc:
         description: 'Name of the documentation artifact.'
         required: true
@@ -44,28 +49,28 @@ jobs:
 
   PublishToGitHubPages:
     name: 📚 Publish to GH-Pages
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
 
     steps:
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
 
-      - name: 📥 Download artifacts '${{ inputs.doc }}' from 'BuildTheDocs' job
-        uses: actions/download-artifact@v4
+      - name: 📥 Download artifacts '${{ inputs.doc }}' from 'SphinxDocumentation' job
+        uses: pyTooling/download-artifact@v4
         with:
           name: ${{ inputs.doc }}
           path: public
 
       - name: 📥 Download artifacts '${{ inputs.coverage }}' from 'Coverage' job
+        uses: pyTooling/download-artifact@v4
         if: ${{ inputs.coverage != '' }}
-        uses: actions/download-artifact@v4
         with:
           name: ${{ inputs.coverage }}
           path: public/coverage
 
       - name: 📥 Download artifacts '${{ inputs.typing }}' from 'StaticTypeCheck' job
+        uses: pyTooling/download-artifact@v4
         if: ${{ inputs.typing != '' }}
-        uses: actions/download-artifact@v4
         with:
           name: ${{ inputs.typing }}
           path: public/typing

.github/workflows/Release.yml

@@ -24,12 +24,17 @@ name: Release
 
 on:
   workflow_call:
+    inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
 
 jobs:
-
   Release:
     name: 📝 Create 'Release Page' on GitHub
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
 
     steps:
       - name: 🔁 Extract Git tag from GITHUB_REF
@@ -39,13 +44,13 @@ jobs:
           RELEASE_VERSION=${GIT_TAG#v}
           RELEASE_DATETIME="$(date --utc '+%d.%m.%Y - %H:%M:%S')"
           # write to step outputs
-          echo "gitTag=${GIT_TAG}" >> $GITHUB_OUTPUT
-          echo "version=${RELEASE_VERSION}" >> $GITHUB_OUTPUT
-          echo "datetime=${RELEASE_DATETIME}" >> $GITHUB_OUTPUT
+          printf "%s\n" "gitTag=${GIT_TAG}" >> $GITHUB_OUTPUT
+          printf "%s\n" "version=${RELEASE_VERSION}" >> $GITHUB_OUTPUT
+          printf "%s\n" "datetime=${RELEASE_DATETIME}" >> $GITHUB_OUTPUT
 
       - name: 📑 Create Release Page
-        id: createReleasePage
         uses: actions/create-release@v1
+        id: createReleasePage
         env:
           GITHUB_TOKEN: ${{ github.token }}
         with:
@@ -55,12 +60,34 @@ jobs:
             **Automated Release created on: ${{ steps.getVariables.outputs.datetime }}**
 
             # New Features
+
+            * tbd
             * tbd
 
             # Changes
+
+            * tbd
             * tbd
 
             # Bug Fixes
+
             * tbd
-          draft: false
+            * tbd
+
+            # Documentation
+
+            * tbd
+            * tbd
+
+            # Unit Tests
+
+            * tbd
+            * tbd
+
+            ----------
+            # Related Issues and Pull-Requests
+
+            * tbd
+            * tbd
+          draft: true
           prerelease: false

.github/workflows/SphinxDocumentation.yml

@@ -24,26 +24,30 @@ name: Documentation
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       python_version:
         description: 'Python version.'
         required: false
-        default: '3.12'
+        default: '3.13'
         type: string
       requirements:
         description: 'Python dependencies to be installed through pip.'
         required: false
         default: '-r doc/requirements.txt'
         type: string
-      coverage_config:
-        description: 'Path to the .coveragerc file. Use pyproject.toml by default.'
-        required: false
-        default: 'pyproject.toml'
-        type: string
       doc_directory:
         description: 'Path to the directory containing documentation (Sphinx working directory).'
         required: false
         default: 'doc'
         type: string
+      coverage_report_json_directory:
+        description: ''
+        required: false
+        type: string
       coverage_json_artifact:
         description: 'Name of the coverage JSON artifact.'
         required: false
@@ -71,13 +75,16 @@ on:
         type: string
 
 jobs:
-  Sphinx:
-    name: 📓 Documentation generation using Sphinx and Python ${{ inputs.python_version }}
-    runs-on: ubuntu-latest
+  Sphinx-HTML:
+    name: 📓 HTML Documentation using Sphinx and Python ${{ inputs.python_version }}
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
 
     steps:
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
+        with:
+          lfs: true
+          submodules: true
 
       - name: 🔧 Install graphviz
         run: sudo apt-get install -y --no-install-recommends graphviz
@@ -89,80 +96,24 @@ jobs:
 
       - name: 🔧 Install wheel,tomli and pip dependencies (native)
         run: |
-          python -m pip install --disable-pip-version-check -U wheel tomli
+          python -m pip install --disable-pip-version-check -U wheel
           python -m pip install --disable-pip-version-check ${{ inputs.requirements }}
 
-      - name: 🔁 Extract configurations from pyproject.toml
-        id: getVariables
-        shell: python
-        run: |
-          from os       import getenv
-          from pathlib  import Path
-          from sys      import version
-          from textwrap import dedent
-
-          print(f"Python: {version}")
-
-          from tomli import load as tomli_load
-
-          htmlDirectory = Path("htmlcov")
-          xmlFile =  Path("./coverage.xml")
-          jsonFile = Path("./coverage.json")
-          coverageRC = "${{ inputs.coverage_config }}".strip()
-
-          # Read output paths from 'pyproject.toml' file
-          if coverageRC == "pyproject.toml":
-            pyProjectFile =  Path("pyproject.toml")
-            if pyProjectFile.exists():
-              with pyProjectFile.open("rb") as file:
-                pyProjectSettings = tomli_load(file)
-
-              htmlDirectory = Path(pyProjectSettings["tool"]["coverage"]["html"]["directory"])
-              xmlFile       = Path(pyProjectSettings["tool"]["coverage"]["xml"]["output"])
-              jsonFile      = Path(pyProjectSettings["tool"]["coverage"]["json"]["output"])
-            else:
-              print(f"File '{pyProjectFile}' not found and no '.coveragerc' file specified.")
-
-          # Read output paths from '.coveragerc' file
-          elif len(coverageRC) > 0:
-            coverageRCFile = Path(coverageRC)
-            if coverageRCFile.exists():
-              with coverageRCFile.open("rb") as file:
-                coverageRCSettings = tomli_load(file)
-
-              htmlDirectory = Path(coverageRCSettings["html"]["directory"])
-              xmlFile       = Path(coverageRCSettings["xml"]["output"])
-              jsonFile      = Path(coverageRCSettings["json"]["output"])
-            else:
-              print(f"File '{coverageRCFile}' not found.")
-
-          # Write jobs to special file
-          github_output = Path(getenv("GITHUB_OUTPUT"))
-          print(f"GITHUB_OUTPUT: {github_output}")
-          with github_output.open("a+", encoding="utf-8") as f:
-            f.write(dedent(f"""\
-              coverage_report_html_directory={htmlDirectory.as_posix()}
-              coverage_report_xml_directory={xmlFile.parent.as_posix()}
-              coverage_report_xml={xmlFile.as_posix()}
-              coverage_report_json_directory={jsonFile.parent.as_posix()}
-              coverage_report_json={jsonFile.as_posix()}
-            """))
-
-          print(f"DEBUG:\n  html={htmlDirectory}\n  xml={xmlFile}\n  json={jsonFile}")
-
       - name: 📥 Download artifacts '${{ inputs.unittest_xml_artifact }}' from 'Unittesting' job
+        uses: pyTooling/download-artifact@v4
         if: inputs.unittest_xml_artifact != ''
-        uses: actions/download-artifact@v4
         with:
           name: ${{ inputs.unittest_xml_artifact }}
           path: ${{ inputs.unittest_xml_directory }}
+          investigate: true
 
       - name: 📥 Download artifacts '${{ inputs.coverage_json_artifact }}' from 'PublishCoverageResults' job
+        uses: pyTooling/download-artifact@v4
         if: inputs.coverage_json_artifact != ''
-        uses: actions/download-artifact@v4
         with:
           name: ${{ inputs.coverage_json_artifact }}
-          path: ${{ steps.getVariables.outputs.coverage_report_json_directory }}
+          path: ${{ inputs.coverage_report_json_directory }}
+          investigate: true
 
       - name: ☑ Generate HTML documentation
         if: inputs.html_artifact != ''
@@ -172,6 +123,57 @@ jobs:
           cd "${{ inputs.doc_directory || '.' }}"
           sphinx-build -v -n -b html -d _build/doctrees -j $(nproc) -w _build/html.log . _build/html
 
+      - name: 📤 Upload 'HTML Documentation' artifact
+        uses: pyTooling/upload-artifact@v4
+        if: inputs.html_artifact != ''
+        continue-on-error: true
+        with:
+          name: ${{ inputs.html_artifact }}
+          working-directory: ${{ inputs.doc_directory }}/_build/html
+          path: '*'
+          if-no-files-found: error
+          retention-days: 1
+
+  Sphinx-LaTeX:
+    name: 📓 LaTeX Documentation using Sphinx and Python ${{ inputs.python_version }}
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
+
+    steps:
+      - name: ⏬ Checkout repository
+        uses: actions/checkout@v4
+        with:
+          lfs: true
+          submodules: true
+
+      - name: 🔧 Install graphviz
+        run: sudo apt-get install -y --no-install-recommends graphviz
+
+      - name: 🐍 Setup Python ${{ inputs.python_version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ inputs.python_version }}
+
+      - name: 🔧 Install wheel,tomli and pip dependencies (native)
+        run: |
+          python -m pip install --disable-pip-version-check -U wheel
+          python -m pip install --disable-pip-version-check ${{ inputs.requirements }}
+
+      - name: 📥 Download artifacts '${{ inputs.unittest_xml_artifact }}' from 'Unittesting' job
+        uses: pyTooling/download-artifact@v4
+        if: inputs.unittest_xml_artifact != ''
+        with:
+          name: ${{ inputs.unittest_xml_artifact }}
+          path: ${{ inputs.unittest_xml_directory }}
+          investigate: true
+
+      - name: 📥 Download artifacts '${{ inputs.coverage_json_artifact }}' from 'PublishCoverageResults' job
+        uses: pyTooling/download-artifact@v4
+        if: inputs.coverage_json_artifact != ''
+        with:
+          name: ${{ inputs.coverage_json_artifact }}
+          path: ${{ inputs.coverage_report_json_directory }}
+          investigate: true
+
       - name: ☑ Generate LaTeX documentation
         if: inputs.latex_artifact != ''
 #        continue-on-error: true
@@ -182,22 +184,95 @@ jobs:
           sphinx-build -v -n -b latex -d _build/doctrees -j $(nproc) -w _build/latex.log . _build/latex
 #           --builder html --doctree-dir _build/doctrees --verbose --fresh-env --write-all --nitpicky --warning-file _build/html.log . _build/html
 
-      - name: 📤 Upload 'HTML Documentation' artifact
-        if: inputs.html_artifact != ''
-        continue-on-error: true
-        uses: actions/upload-artifact@v4
-        with:
-          name: ${{ inputs.html_artifact }}
-          path: ${{ inputs.doc_directory }}/_build/html
-          if-no-files-found: error
-          retention-days: 1
+      - name: Workaround I - https://github.com/sphinx-doc/sphinx/issues/13190
+        if: inputs.latex_artifact != ''
+        run: |
+          printf "Changing directory to '${{ inputs.doc_directory || '.' }}/_build/latex' ...\n"
+          cd ${{ inputs.doc_directory || '.' }}/_build/latex
+
+          MIMETYPE_EXTENSIONS=(
+            "image/png:png"
+            "image/jpeg:jpg"
+            "image/svg+xml:svg"
+          )
+
+          printf "Changing file extension according to MIME type ...\n"
+          while IFS=$'\n' read -r file; do
+            printf "  Checking '%s' ... " "${file}"
+            mime="$(file --mime-type -b "${file}")"
+            printf "[%s]\n" "${mime}"
+
+            found=0
+            for MIME in "${MIMETYPE_EXTENSIONS[@]}"; do
+              mimetype="${MIME%%:*}"
+              extension="${MIME#*:}"
+
+              if [[ "${mime}" == "${mimetype}" && "${file##*.}" != "${extension}" ]]; then
+                printf "    Rename file to '%s' " "${file}.${extension}"
+                mv "${file}" "${file}.${extension}"
+                if [[ $? -eq 0 ]]; then
+                  printf "[OK]\n"
+                else
+                  printf "[FAILED]\n"
+                fi
+
+                printf "    Patching LaTeX file for '%s' " "${file}"
+                sed -i "s:{{${file%.*}}\.${file##*.}}:{{${file}}.${extension}}:g" *.tex
+                if [[ $? -eq 0 ]]; then
+                  printf "[OK]\n"
+                else
+                  printf "[FAILED]\n"
+                fi
+
+                found=1
+                break
+              fi
+            done
+            if [[ $found -eq 0 ]]; then
+              printf "[SKIPPED]\n"
+            fi
+          done < <(find . -type f -not -iname "*.cls" -not -iname "*.sty" -not -iname "*.xdy" -not -iname "*.svg" -not -iname "*.png" -not -iname "*.jpg" | sed 's:./::')
+
+      - name: Workaround II - https://github.com/sphinx-doc/sphinx/issues/13189
+        if: inputs.latex_artifact != ''
+        run: |
+          printf "Changing directory to '${{ inputs.doc_directory || '.' }}/_build/latex' ...\n"
+          cd ${{ inputs.doc_directory || '.' }}/_build/latex
+
+          printf "Searching for downloaded images, that need normalization ...\n"
+          for imageExt in png svg jpg jpeg; do
+            printf "  Processing '%s' ...\n" "${imageExt}"
+            while IFS=$'\n' read -r imageFile; do
+              newFile="${imageFile//%/_}";
+
+              printf "    %s\n" "$imageFile";
+              if [[ "${imageFile}" != "${newFile}" ]]; then
+                printf "      Rename file to '%s' " "${newFile}"
+                mv "${imageFile}" "${newFile}"
+                if [[ $? -eq 0 ]]; then
+                  printf "[OK]\n"
+                else
+                  printf "[FAILED]\n"
+                fi
+
+                printf "      Patching LaTeX file for '%s' " "${newFile}"
+                sed -i "s:{{${imageFile%.*}}\.${imageFile##*.}}:{{${newFile%.*}}.${newFile##*.}}:g" *.tex
+                if [[ $? -eq 0 ]]; then
+                  printf "[OK]\n"
+                else
+                  printf "[FAILED]\n"
+                fi
+              fi
+            done < <(find . -type f -iname "*.$imageExt" | sed 's:./::')
+          done
 
       - name: 📤 Upload 'LaTeX Documentation' artifact
+        uses: pyTooling/upload-artifact@v4
         if: inputs.latex_artifact != ''
         continue-on-error: true
-        uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.latex_artifact }}
-          path: ${{ inputs.doc_directory }}/_build/latex
+          working-directory: ${{ inputs.doc_directory }}/_build/latex
+          path: '*'
           if-no-files-found: error
           retention-days: 1

.github/workflows/StaticTypeCheck.yml

@@ -25,10 +25,15 @@ name: Static Type Check
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       python_version:
         description: 'Python version.'
         required: false
-        default: '3.12'
+        default: '3.13'
         type: string
       requirements:
         description: 'Python dependencies to be installed through pip.'
@@ -63,7 +68,7 @@ jobs:
 
   StaticTypeCheck:
     name: 👀 Check Static Typing using Python ${{ inputs.python_version }}
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
 
     steps:
       - name: ⏬ Checkout repository
@@ -82,19 +87,20 @@ jobs:
         run: ${{ inputs.commands }}
 
       - name: 📤 Upload 'Static Typing Report' HTML artifact
+        uses: pyTooling/upload-artifact@v4
         if: ${{ inputs.html_artifact != '' }}
         continue-on-error: true
-        uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.html_artifact }}
-          path: ${{ inputs.html_report }}
+          working-directory: ${{ inputs.html_report }}
+          path: '*'
           if-no-files-found: error
           retention-days: 1
 
       - name: 📤 Upload 'Static Typing Report' JUnit artifact
+        uses: pyTooling/upload-artifact@v4
         if: ${{ inputs.junit_artifact != '' }}
         continue-on-error: true
-        uses: actions/upload-artifact@v4
         with:
           name: ${{ inputs.junit_artifact }}
           path: ${{ inputs.junit_report }}

.github/workflows/TestReleaser.yml

@@ -41,7 +41,7 @@ jobs:
 
 
   Image:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     env:
       DOCKER_BUILDKIT: 1
     steps:
@@ -60,11 +60,11 @@ jobs:
 
 
   Composite:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4
 
-    - run: echo "Build some tool and generate some (versioned) artifacts" > artifact-$(date -u +"%Y-%m-%dT%H-%M-%SZ").txt
+    - run: printf "%s\n" "Build some tool and generate some (versioned) artifacts" > artifact-$(date -u +"%Y-%m-%dT%H-%M-%SZ").txt
 
     - name: Single
       uses: ./releaser/composite
@@ -84,7 +84,7 @@ jobs:
     - name: Add artifacts/*.txt
       run: |
         mkdir artifacts
-        echo "Build some tool and generate some artifacts" > artifacts/artifact.txt
+        printf "%s\n" "Build some tool and generate some artifacts" > artifacts/artifact.txt
         touch artifacts/empty_file.txt
 
     - name: Single in subdir
@@ -95,8 +95,8 @@ jobs:
 
     - name: Add artifacts/*.md
       run: |
-        echo "releaser hello" > artifacts/hello.md
-        echo "releaser world" > artifacts/world.md
+        printf "%s\n" "releaser hello" > artifacts/hello.md
+        printf "%s\n" "releaser world" > artifacts/world.md
 
     - name: Directory wildcard
       uses: ./releaser/composite
@@ -107,7 +107,7 @@ jobs:
     - name: Add artifacts/subdir
       run: |
         mkdir artifacts/subdir
-        echo "Test recursive glob" > artifacts/subdir/deep_file.txt
+        printf "%s\n" "Test recursive glob" > artifacts/subdir/deep_file.txt
 
     - name: Directory wildcard (recursive)
       uses: ./releaser/composite
@@ -120,11 +120,11 @@ jobs:
     needs:
       - Image
       - Composite
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4
 
-    - run: echo "Build some tool and generate some (versioned) artifacts" > artifact-$(date -u +"%Y-%m-%dT%H-%M-%SZ").txt
+    - run: printf "%s\n" "Build some tool and generate some (versioned) artifacts" > artifact-$(date -u +"%Y-%m-%dT%H-%M-%SZ").txt
 
     - name: Single
       uses: ./releaser
@@ -144,7 +144,7 @@ jobs:
     - name: Add artifacts/*.txt
       run: |
         mkdir artifacts
-        echo "Build some tool and generate some artifacts" > artifacts/artifact.txt
+        printf "%s\n" "Build some tool and generate some artifacts" > artifacts/artifact.txt
         touch artifacts/empty_file.txt
 
     - name: Single in subdir
@@ -155,8 +155,8 @@ jobs:
 
     - name: Add artifacts/*.md
       run: |
-        echo "releaser hello" > artifacts/hello.md
-        echo "releaser world" > artifacts/world.md
+        printf "%s\n" "releaser hello" > artifacts/hello.md
+        printf "%s\n" "releaser world" > artifacts/world.md
 
     - name: Directory wildcard
       uses: ./releaser
@@ -167,7 +167,7 @@ jobs:
     - name: Add artifacts/subdir
       run: |
         mkdir artifacts/subdir
-        echo "Test recursive glob" > artifacts/subdir/deep_file.txt
+        printf "%s\n" "Test recursive glob" > artifacts/subdir/deep_file.txt
 
     - name: Directory wildcard (recursive)
       uses: ./releaser

.github/workflows/UnitTesting.yml

@@ -29,21 +29,56 @@ on:
         description: 'JSON list with environment fields, telling the system and Python versions to run tests with.'
         required: true
         type: string
+      apt:
+        description: 'Ubuntu dependencies to be installed through apt.'
+        required: false
+        default: ''
+        type: string
+      brew:
+        description: 'macOS dependencies to be installed through brew.'
+        required: false
+        default: ''
+        type: string
+      pacboy:
+        description: 'MSYS2 dependencies to be installed through pacboy (pacman).'
+        required: false
+        default: ''
+        type: string
       requirements:
         description: 'Python dependencies to be installed through pip.'
         required: false
         default: '-r tests/requirements.txt'
         type: string
-      pacboy:
-        description: 'MSYS2 dependencies to be installed through pacboy (pacman).'
-        required: false
-        default: ""
-        type: string
       mingw_requirements:
         description: 'Override Python dependencies to be installed through pip on MSYS2 (MINGW64) only.'
         required: false
         default: ''
         type: string
+      macos_before_script:
+        description: 'Scripts to execute before pytest on macOS (Intel).'
+        required: false
+        default: ''
+        type: string
+      macos_arm_before_script:
+        description: 'Scripts to execute before pytest on macOS (ARM).'
+        required: false
+        default: ''
+        type: string
+      ubuntu_before_script:
+        description: 'Scripts to execute before pytest on Ubuntu.'
+        required: false
+        default: ''
+        type: string
+      mingw64_before_script:
+        description: 'Scripts to execute before pytest on Windows within MSYS2 MinGW64.'
+        required: false
+        default: ''
+        type: string
+      ucrt64_before_script:
+        description: 'Scripts to execute before pytest on Windows within MSYS2 UCRT64.'
+        required: false
+        default: ''
+        type: string
       root_directory:
         description: 'Working directory for running tests.'
         required: false
@@ -59,11 +94,26 @@ on:
         required: false
         default: 'unit'
         type: string
+      unittest_report_xml_directory:
+        description: 'Path where to save the unittest summary report XML.'
+        required: false
+        default: 'report/unit'
+        type: string
+      unittest_report_xml_filename:
+        description: 'Filename of the unittest summary report XML.'
+        required: false
+        default: 'TestReportSummary.xml'
+        type: string
       coverage_config:
         description: 'Path to the .coveragerc file. Use pyproject.toml by default.'
         required: false
         default: 'pyproject.toml'
         type: string
+      coverage_report_html_directory:
+        description: ''
+        required: false
+        default: 'report/coverage/html'
+        type: string
       unittest_xml_artifact:
         description: "Generate unit test report with junitxml and upload results as an artifact."
         required: false
@@ -112,6 +162,22 @@ jobs:
     steps:
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
+        with:
+          lfs: true
+          submodules: true
+
+# Package Manager steps
+      - name: 🔧 Install homebrew dependencies on macOS
+        if: ( matrix.system == 'macos' || matrix.system == 'macos-arm' ) && inputs.brew != ''
+        run: brew install ${{ inputs.brew }}
+
+      - name: 🔧 Install apt dependencies on Ubuntu
+        if: matrix.system == 'ubuntu' && inputs.apt != ''
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends ${{ inputs.apt }}
+
+# Compute Dependencies for MSYS2 steps
 
       - name: 🔧 Install dependencies (system Python for Python shell)
         if: matrix.system == 'msys2'
@@ -149,28 +215,35 @@ jobs:
           requirements = "${{ inputs.requirements }}"
           if requirements.startswith("-r"):
             requirementsFile = Path(requirements[2:].lstrip())
-            dependencies = loadRequirementsFile(requirementsFile)
+            try:
+              dependencies = loadRequirementsFile(requirementsFile)
+            except FileNotFoundError as ex:
+              print(f"::error title=FileNotFoundError::{ex}")
+              exit(1)
           else:
             dependencies = [req.strip() for req in requirements.split(" ")]
 
           packages = {
-            "coverage":    "python-coverage:p",
-            "igraph":      "igraph:p",
-            "jinja2":      "python-markupsafe:p",
-            "lxml":        "python-lxml:p",
-            "numpy":       "python-numpy:p",
-            "markupsafe":  "python-markupsafe:p",
-            "pip":         "python-pip:p",
-            "ruamel.yaml": "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
-            "sphinx":      "python-markupsafe:p",
-            "tomli":       "python-tomli:p",
-            "wheel":       "python-wheel:p",
-            "pyEDAA.ProjectModel": "python-ruamel-yaml:p python-ruamel.yaml.clib:p python-lxml:p",
-            "pyEDAA.Reports":      "python-ruamel-yaml:p python-ruamel.yaml.clib:p python-lxml:p",
+            "coverage":            "python-coverage:p",
+            "docstr_coverage":     "python-pyaml:p",
+            "igraph":              "igraph:p",
+            "jinja2":              "python-markupsafe:p",
+            "lxml":                "python-lxml:p",
+            "numpy":               "python-numpy:p",
+            "markupsafe":          "python-markupsafe:p",
+            "pip":                 "python-pip:p",
+            "pyyaml":              "python-pyyaml:p",
+            "ruamel.yaml":         "python-ruamel-yaml:p",
+          #  "ruamel.yaml":         "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
+            "sphinx":              "python-markupsafe:p",
+            "tomli":               "python-tomli:p",
+            "wheel":               "python-wheel:p",
+            "pyedaa.projectmodel": "python-ruamel-yaml:p python-ruamel.yaml.clib:p python-lxml:p",
+            "pyedaa.reports":      "python-ruamel-yaml:p python-ruamel.yaml.clib:p python-lxml:p",
           }
           subPackages = {
             "pytooling": {
-              "yaml":      "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
+              "yaml":              "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
             },
           }
 
@@ -206,9 +279,11 @@ jobs:
           with github_output.open("a+") as f:
             f.write(f"pacboy_packages={' '.join(pacboyPackages)}\n")
 
+# Python setup
+
       - name: '🟦 Setup MSYS2 for ${{ matrix.runtime }}'
-        if: matrix.system == 'msys2'
         uses: msys2/setup-msys2@v2
+        if: matrix.system == 'msys2'
         with:
           msystem: ${{ matrix.runtime }}
           update: true
@@ -217,11 +292,13 @@ jobs:
             ${{ inputs.pacboy }}
 
       - name: 🐍 Setup Python ${{ matrix.python }}
-        if: matrix.system != 'msys2'
         uses: actions/setup-python@v5
+        if: matrix.system != 'msys2'
         with:
           python-version: ${{ matrix.python }}
 
+# Python Dependency steps
+
       - name: 🔧 Install wheel,tomli and pip dependencies (native)
         if: matrix.system != 'msys2'
         run: |
@@ -237,87 +314,57 @@ jobs:
             python -m pip install --disable-pip-version-check ${{ inputs.requirements }}
           fi
 
-      - name: 🔁 Extract configurations from pyproject.toml
-        id: getVariables
-        shell: python
-        run: |
-          from os       import getenv
-          from pathlib  import Path
-          from sys      import version
-          from textwrap import dedent
+# Before scripts
 
-          print(f"Python: {version}")
+      - name: 🍎 macOS (Intel) before scripts
+        if: matrix.system == 'macos' && inputs.macos_before_script != ''
+        run: ${{ inputs.macos_before_script }}
 
-          from tomli import load as tomli_load
+      - name: 🍏 macOS (ARM) before scripts
+        if: matrix.system == 'macos-arm' && inputs.macos_arm_before_script != ''
+        run: ${{ inputs.macos_arm_before_script }}
 
-          htmlDirectory = Path("htmlcov")
-          xmlFile =  Path("./coverage.xml")
-          jsonFile = Path("./coverage.json")
-          coverageRC = "${{ inputs.coverage_config }}".strip()
+      - name: 🐧 Ubuntu before scripts
+        if: matrix.system == 'ubuntu' && inputs.ubuntu_before_script != ''
+        run: ${{ inputs.ubuntu_before_script }}
 
-          # Read output paths from 'pyproject.toml' file
-          if coverageRC == "pyproject.toml":
-            pyProjectFile =  Path("pyproject.toml")
-            if pyProjectFile.exists():
-              with pyProjectFile.open("rb") as file:
-                pyProjectSettings = tomli_load(file)
+      # Windows before script
 
-              htmlDirectory = Path(pyProjectSettings["tool"]["coverage"]["html"]["directory"])
-              xmlFile       = Path(pyProjectSettings["tool"]["coverage"]["xml"]["output"])
-              jsonFile      = Path(pyProjectSettings["tool"]["coverage"]["json"]["output"])
-            else:
-              print(f"File '{pyProjectFile}' not found and no '.coveragerc' file specified.")
+      - name: 🪟🟦 MinGW64 before scripts
+        if: matrix.system == 'msys2' && matrix.runtime == 'MINGW64' && inputs.mingw64_before_script != ''
+        run: ${{ inputs.mingw64_before_script }}
 
-          # Read output paths from '.coveragerc' file
-          elif len(coverageRC) > 0:
-            coverageRCFile = Path(coverageRC)
-            if coverageRCFile.exists():
-              with coverageRCFile.open("rb") as file:
-                coverageRCSettings = tomli_load(file)
+      - name: 🪟🟨 UCRT64 before scripts
+        if: matrix.system == 'msys2' && matrix.runtime == 'UCRT64' && inputs.ucrt64_before_script != ''
+        run: ${{ inputs.ucrt64_before_script }}
 
-              htmlDirectory = Path(coverageRCSettings["html"]["directory"])
-              xmlFile       = Path(coverageRCSettings["xml"]["output"])
-              jsonFile      = Path(coverageRCSettings["json"]["output"])
-            else:
-              print(f"File '{coverageRCFile}' not found.")
+# Run pytests
 
-          # Write jobs to special file
-          github_output = Path(getenv("GITHUB_OUTPUT"))
-          print(f"GITHUB_OUTPUT: {github_output}")
-          with github_output.open("a+", encoding="utf-8") as f:
-            f.write(dedent(f"""\
-              unittest_report_html_directory={htmlDirectory}
-              coverage_report_html_directory={htmlDirectory.as_posix()}
-              coverage_report_xml={xmlFile}
-              coverage_report_json={jsonFile}
-            """))
-
-          print(f"DEBUG:\n  html={htmlDirectory}\n  xml={xmlFile}\n  json={jsonFile}")
-
-      - name: ☑ Run unit tests (Ubuntu/macOS)
+      - name: ✅ Run unit tests (Ubuntu/macOS)
         if: matrix.system != 'windows'
         run: |
           export ENVIRONMENT_NAME="${{ matrix.envname }}"
           export PYTHONPATH=$(pwd)
 
           cd "${{ inputs.root_directory || '.' }}"
-          [ -n '${{ inputs.unittest_xml_artifact }}' ] && PYTEST_ARGS='--junitxml=report/unit/TestReportSummary.xml' || unset PYTEST_ARGS
+          [ -n '${{ inputs.unittest_xml_artifact }}' ] && PYTEST_ARGS='--junitxml=${{ inputs.unittest_report_xml_directory }}/${{ inputs.unittest_report_xml_filename }}' || unset PYTEST_ARGS
           if [ -n '${{ inputs.coverage_config }}' ]; then
-            echo "coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.unittest_directory }}"
+            printf "%s\n" "coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.unittest_directory }}"
             coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.unittest_directory }}
           else
-            echo "python -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.unittest_directory }}"
+            printf "%s\n" "python -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.unittest_directory }}"
             python -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.unittest_directory }}
           fi
 
-      - name: ☑ Run unit tests (Windows)
+      - name: ✅ Run unit tests (Windows)
         if: matrix.system == 'windows'
+        continue-on-error: true
         run: |
           $env:ENVIRONMENT_NAME = "${{ matrix.envname }}"
           $env:PYTHONPATH = (Get-Location).ToString()
 
           cd "${{ inputs.root_directory || '.' }}"
-          $PYTEST_ARGS = if ("${{ inputs.unittest_xml_artifact }}") { "--junitxml=report/unit/TestReportSummary.xml" } else { "" }
+          $PYTEST_ARGS = if ("${{ inputs.unittest_xml_artifact }}") { "--junitxml=${{ inputs.unittest_report_xml_directory }}/${{ inputs.unittest_report_xml_filename }}" } else { "" }
           if ("${{ inputs.coverage_config }}") {
             Write-Host "coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -raP --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.unittest_directory }}"
             coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -raP $PYTEST_ARGS --color=yes ${{ inputs.tests_directory || '.' }}/${{ inputs.unittest_directory }}
@@ -328,31 +375,38 @@ jobs:
 
       - name: Convert coverage to XML format (Cobertura)
         if: inputs.coverage_xml_artifact != ''
+        continue-on-error: true
         run: coverage xml --data-file=.coverage
 
       - name: Convert coverage to JSON format
         if: inputs.coverage_json_artifact != ''
+        continue-on-error: true
         run: coverage json --data-file=.coverage
 
       - name: Convert coverage to HTML format
         if: inputs.coverage_html_artifact != ''
+        continue-on-error: true
         run: |
-          coverage html --data-file=.coverage -d ${{ steps.getVariables.outputs.coverage_report_html_directory }}
-          rm ${{ steps.getVariables.outputs.coverage_report_html_directory }}/.gitignore
+          coverage html --data-file=.coverage -d ${{ inputs.coverage_report_html_directory }}
+          rm ${{ inputs.coverage_report_html_directory }}/.gitignore
 
-      - name: 📤 Upload 'TestReportSummary.xml' artifact
+# Upload artifacts
+
+      - name: 📤 Upload '${{ inputs.unittest_report_xml_filename }}' artifact
+        uses: pyTooling/upload-artifact@v4
         if: inputs.unittest_xml_artifact != ''
-        uses: actions/upload-artifact@v4
+        continue-on-error: true
         with:
           name: ${{ inputs.unittest_xml_artifact }}-${{ matrix.system }}-${{ matrix.runtime }}-${{ matrix.python }}
-          path: report/unit/TestReportSummary.xml
+          working-directory: ${{ inputs.unittest_report_xml_directory }}
+          path: ${{ inputs.unittest_report_xml_filename }}
           if-no-files-found: error
           retention-days: 1
 
 #      - name: 📤 Upload 'Unit Tests HTML Report' artifact
 #        if: inputs.unittest_html_artifact != ''
 #        continue-on-error: true
-#        uses: actions/upload-artifact@v4
+#        uses: pyTooling/upload-artifact@v4
 #        with:
 #          name: ${{ inputs.unittest_html_artifact }}-${{ matrix.system }}-${{ matrix.runtime }}-${{ matrix.python }}
 #          path: ${{ steps.getVariables.outputs.unittest_report_html_directory }}
@@ -362,17 +416,18 @@ jobs:
       - name: 📤 Upload 'Coverage SQLite Database' artifact
         if: inputs.coverage_sqlite_artifact != ''
         continue-on-error: true
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         with:
           name: ${{ inputs.coverage_sqlite_artifact }}-${{ matrix.system }}-${{ matrix.runtime }}-${{ matrix.python }}
           path: .coverage
+          include-hidden-files: true
           if-no-files-found: error
           retention-days: 1
 
       - name: 📤 Upload 'Coverage XML Report' artifact
         if: inputs.coverage_xml_artifact != ''
         continue-on-error: true
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         with:
           name: ${{ inputs.coverage_xml_artifact }}-${{ matrix.system }}-${{ matrix.runtime }}-${{ matrix.python }}
           path: ${{ steps.getVariables.outputs.coverage_report_xml }}
@@ -382,7 +437,7 @@ jobs:
       - name: 📤 Upload 'Coverage JSON Report' artifact
         if: inputs.coverage_json_artifact != ''
         continue-on-error: true
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         with:
           name: ${{ inputs.coverage_json_artifact }}-${{ matrix.system }}-${{ matrix.runtime }}-${{ matrix.python }}
           path: ${{ steps.getVariables.outputs.coverage_report_json }}
@@ -392,9 +447,10 @@ jobs:
       - name: 📤 Upload 'Coverage HTML Report' artifact
         if: inputs.coverage_html_artifact != ''
         continue-on-error: true
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         with:
           name: ${{ inputs.coverage_html_artifact }}-${{ matrix.system }}-${{ matrix.runtime }}-${{ matrix.python }}
-          path: ${{ steps.getVariables.outputs.coverage_report_html_directory }}
+          working-directory: ${{ steps.getVariables.outputs.coverage_report_html_directory }}
+          path: '*'
           if-no-files-found: error
           retention-days: 1

.github/workflows/VerifyDocs.yml

@@ -25,17 +25,22 @@ name: Verify examples
 on:
   workflow_call:
     inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
       python_version:
         description: 'Python version.'
         required: false
-        default: '3.12'
+        default: '3.13'
         type: string
 
 jobs:
 
   VerifyDocs:
     name: 👍 Verify example snippets using Python ${{ inputs.python_version }}
-    runs-on: ubuntu-latest
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
 
     steps:
       - name: ⏬ Checkout repository
@@ -72,7 +77,7 @@ jobs:
       - name: Print example.py
         run: cat tests/docs/example.py
 
-      - name: ☑ Run example snippet
+      - name: ✅ Run example snippet
         working-directory: tests/docs
         run: |
           python3 example.py

.github/workflows/_Checking_ArtifactCleanup.yml

@@ -6,10 +6,10 @@ on:
 
 jobs:
   Params:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
     with:
       name: Example
-      python_version_list: "3.10 3.11"
+      python_version_list: "3.12 3.13"
       system_list: "ubuntu windows"
 
   Testing:
@@ -22,10 +22,10 @@ jobs:
         include: ${{ fromJson(needs.Params.outputs.python_jobs) }}
     steps:
       - name: Content creation for ${{ matrix.system }}-${{ matrix.python }}
-        run: echo "${{ matrix.runs-on }}-${{ matrix.python }}" >> artifact.txt
+        run: printf "%s\n" "${{ matrix.runs-on }}-${{ matrix.python }}" >> artifact.txt
 
       - name: 📤 Upload artifact for ${{ matrix.system }}-${{ matrix.python }}
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         with:
           name: ${{ fromJson(needs.Params.outputs.artifact_names).unittesting_xml }}-${{ matrix.system }}-${{ matrix.python }}
           path: artifact.txt
@@ -36,13 +36,13 @@ jobs:
     name: Package generation
     needs:
       - Params
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - name: Package creation
-        run: echo "Package" >> package.txt
+        run: printf "%s\n" "Package" >> package.txt
 
       - name: 📤 Upload artifact for ${{ matrix.system }}-${{ matrix.python }}
-        uses: actions/upload-artifact@v4
+        uses: pyTooling/upload-artifact@v4
         with:
           name: ${{ fromJson(needs.Params.outputs.artifact_names).package_all }}
           path: package.txt
@@ -50,7 +50,7 @@ jobs:
           retention-days: 1
 
   ArtifactCleanUp:
-    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r1
+    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r4
     needs:
       - Params
       - Testing

.github/workflows/_Checking_JobTemplates.yml

@@ -0,0 +1,251 @@
+name: Verification of Job Templates
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  ConfigParams:
+    uses: pyTooling/Actions/.github/workflows/ExtractConfiguration.yml@r4
+    with:
+      package_name: pyDummy
+
+  UnitTestingParams:
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
+    with:
+      name: pyDummy
+      python_version_list: "3.9 3.10 3.11 3.12 3.13 pypy-3.9 pypy-3.10"
+#      disable_list: "windows:pypy-3.10"
+
+  PlatformTestingParams:
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
+    with:
+      name: Platform
+      python_version_list: ""
+      system_list: "ubuntu windows macos mingw64 clang64 ucrt64"
+
+  UnitTesting:
+    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+    with:
+      jobs:                           ${{ needs.UnitTestingParams.outputs.python_jobs }}
+      unittest_report_xml_directory:  ${{ needs.ConfigParams.outputs.unittest_report_xml_directory }}
+      unittest_report_xml_filename:   ${{ needs.ConfigParams.outputs.unittest_report_xml_filename }}
+      coverage_report_html_directory: ${{ needs.ConfigParams.outputs.coverage_report_html_directory }}
+      unittest_xml_artifact:          ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
+      unittest_html_artifact:         ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_html }}
+      coverage_sqlite_artifact:       ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}
+#      coverage_xml_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}
+#      coverage_json_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
+#      coverage_html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
+
+  PlatformTesting:
+    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r4
+    needs:
+      - ConfigParams
+      - PlatformTestingParams
+    with:
+      jobs:                           ${{ needs.PlatformTestingParams.outputs.python_jobs }}
+#      tests_directory: ""
+      unittest_directory:             platform
+      unittest_report_xml_directory:  ${{ needs.ConfigParams.outputs.unittest_report_xml_directory }}
+      unittest_report_xml_filename:   ${{ needs.ConfigParams.outputs.unittest_report_xml_filename }}
+      coverage_report_html_directory: ${{ needs.ConfigParams.outputs.coverage_report_html_directory }}
+      unittest_xml_artifact:          ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).unittesting_xml }}
+      unittest_html_artifact:         ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).unittesting_html }}
+      coverage_sqlite_artifact:       ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_sqlite }}
+      coverage_xml_artifact:          ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_xml }}
+      coverage_json_artifact:         ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_json }}
+      coverage_html_artifact:         ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_html }}
+
+  StaticTypeCheck:
+    uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      commands: |
+        ${{ needs.ConfigParams.outputs.mypy_prepare_command }}
+        mypy --html-report htmlmypy -p ${{ needs.ConfigParams.outputs.package_fullname }}
+      html_report:   'htmlmypy'
+      html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
+
+  DocCoverage:
+    uses: pyTooling/Actions/.github/workflows/CheckDocumentation.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      directory     : ${{ needs.ConfigParams.outputs.package_directors }}
+#      fail_below: 70
+
+  Package:
+    uses: pyTooling/Actions/.github/workflows/Package.yml@r4
+    needs:
+      - UnitTestingParams
+      - UnitTesting
+      - PlatformTesting
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      artifact:       ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
+
+  PublishCoverageResults:
+    uses: pyTooling/Actions/.github/workflows/PublishCoverageResults.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+      - UnitTesting
+      - PlatformTesting
+    with:
+      coverage_sqlite_artifact:       ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}
+      coverage_xml_artifact:          ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}
+      coverage_report_xml_directory:  ${{ needs.ConfigParams.outputs.coverage_report_xml_directory }}
+      coverage_report_xml_filename:   ${{ needs.ConfigParams.outputs.coverage_report_xml_filename }}
+      coverage_json_artifact:         ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
+      coverage_report_json_directory: ${{ needs.ConfigParams.outputs.coverage_report_json_directory }}
+      coverage_report_json_filename:  ${{ needs.ConfigParams.outputs.coverage_report_json_filename }}
+      coverage_html_artifact:         ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
+      coverage_report_html_directory: ${{ needs.ConfigParams.outputs.coverage_report_html_directory }}
+      codecov:                        true
+      codacy:                         true
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+      CODACY_TOKEN:  ${{ secrets.CODACY_PROJECT_TOKEN }}
+
+  PublishTestResults:
+    uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+      - UnitTesting
+      - PlatformTesting
+    with:
+      additional_merge_args:  '-d "--pytest=rewrite-dunder-init;reduce-depth:pytest.tests.unit;reduce-depth:pytest.tests.platform"'
+      testsuite-summary-name: ${{ needs.ConfigParams.outputs.package_fullname }}
+      merged_junit_artifact:  ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
+      codecov:                true
+      dorny:                  true
+    secrets:
+      CODECOV_TOKEN:          ${{ secrets.CODECOV_TOKEN }}
+
+#  VerifyDocs:
+#    uses: pyTooling/Actions/.github/workflows/VerifyDocs.yml@r4
+#    needs:
+#      - UnitTestingParams
+#    with:
+#      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+
+  Documentation:
+    uses: pyTooling/Actions/.github/workflows/SphinxDocumentation.yml@r4
+    needs:
+      - ConfigParams
+      - UnitTestingParams
+      - PublishTestResults
+      - PublishCoverageResults
+#      - VerifyDocs
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      coverage_report_json_directory: ${{ needs.ConfigParams.outputs.coverage_report_json_directory }}
+      unittest_xml_artifact:  ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
+      coverage_json_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
+      html_artifact:  ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
+      latex_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_latex }}
+
+  IntermediateCleanUp:
+    uses: pyTooling/Actions/.github/workflows/IntermediateCleanUp.yml@r4
+    needs:
+      - UnitTestingParams
+      - PublishCoverageResults
+      - PublishTestResults
+      - Documentation
+    with:
+      sqlite_coverage_artifacts_prefix: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}-
+      xml_unittest_artifacts_prefix:    ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}-
+
+  PDFDocumentation:
+    uses: pyTooling/Actions/.github/workflows/LaTeXDocumentation.yml@r4
+    needs:
+      - UnitTestingParams
+      - Documentation
+    with:
+      document: Actions
+      latex_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_latex }}
+      pdf_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_pdf }}
+
+  PublishToGitHubPages:
+    uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r4
+    needs:
+      - UnitTestingParams
+      - Documentation
+      - PDFDocumentation
+      - PublishCoverageResults
+      - StaticTypeCheck
+    with:
+      doc: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
+      coverage: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
+      typing: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
+
+  ReleasePage:
+    uses: pyTooling/Actions/.github/workflows/Release.yml@r4
+    if: startsWith(github.ref, 'refs/tags')
+    needs:
+      - UnitTesting
+      - PlatformTesting
+#      - StaticTypeCheck
+      - Package
+      - PublishToGitHubPages
+
+  PublishOnPyPI:
+    uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@r4
+    if: startsWith(github.ref, 'refs/tags')
+    needs:
+      - UnitTestingParams
+      - ReleasePage
+#      - Package
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      requirements: -r dist/requirements.txt
+      artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
+    secrets:
+      PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
+
+  ArtifactCleanUp:
+    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r4
+    needs:
+      - UnitTestingParams
+      - PlatformTestingParams
+      - UnitTesting
+      - StaticTypeCheck
+      - PlatformTesting
+      - Documentation
+      - PDFDocumentation
+      - PublishTestResults
+      - PublishCoverageResults
+      - PublishToGitHubPages
+      - IntermediateCleanUp
+    with:
+      package: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
+      remaining: |
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}-*
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_html }}-*
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}-*
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}-*
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}-*
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_html }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
+        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_latex }}
+        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).unittesting_xml }}-*
+        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).unittesting_html }}-*
+        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_xml }}-*
+        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_json }}-*
+        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_html }}-*

.github/workflows/_Checking_NamespacePackage_Pipeline.yml

@@ -0,0 +1,19 @@
+name: Verification of Pipeline Templates (Namespace Package)
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  NamespacePackage:
+    uses: pyTooling/Actions/.github/workflows/CompletePipeline.yml@r4
+    with:
+      package_namespace: pyExamples
+      package_name:      Extensions
+      codecov:           true
+      codacy:            true
+      dorny:             true
+    secrets:
+      PYPI_TOKEN:           ${{ secrets.PYPI_TOKEN }}
+      CODECOV_TOKEN:        ${{ secrets.CODECOV_TOKEN }}
+      CODACY_PROJECT_TOKEN: ${{ secrets.CODACY_PROJECT_TOKEN }}

.github/workflows/_Checking_Nightly.yml

@@ -0,0 +1,123 @@
+name: Verification of Nightly Releases
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  Build:
+    name: Build something
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: 🖉 Build 1
+        run: |
+          printf "%s\n" "Document 1 $(date --utc '+%d.%m.%Y - %H:%M:%S')"   > document1.txt
+          printf "%s\n" "Analysis log $(date --utc '+%d.%m.%Y - %H:%M:%S')" > analysis.log
+          printf "%s\n" "Build log $(date --utc '+%d.%m.%Y - %H:%M:%S')"    > build.log
+
+      - name: 📤 Upload artifact
+        uses: pyTooling/upload-artifact@v4
+        with:
+          name: document
+          path: |
+            document1.txt
+            *.log
+          if-no-files-found: error
+          retention-days: 1
+
+      - name: 🖉 Program
+        run: |
+          printf "%s\n" "Document other $(date --utc '+%d.%m.%Y - %H:%M:%S')" > document1.txt
+          printf "%s\n" "Program $(date --utc '+%d.%m.%Y - %H:%M:%S')"        > program.py
+
+      - name: 📤 Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: other
+          path: |
+            *.txt
+            *.py
+          if-no-files-found: error
+          retention-days: 1
+
+  NightlyPage:
+    uses: pyTooling/Actions/.github/workflows/NightlyRelease.yml@r4
+    needs:
+      - Build
+    secrets: inherit
+    permissions:
+      contents: write
+      actions: write
+#      attestations: write
+    with:
+      can-fail: true
+      prerelease: true
+      replacements: |
+        version=4.2.0
+        tool=myTool
+        prog=program
+      nightly_title: "Nightly Test Release"
+      nightly_description: |
+        This *nightly* release contains all latest and important artifacts created by %tool%'s CI pipeline.
+
+        # %tool% %version%
+
+        * %prog%
+      assets: |
+        document: document1.txt:   Documentation
+        document: build.log:       Logfile - %tool% - %tool%
+        other:    document1.txt:   SBOM - %version%
+        other:    %prog%.py:       Application - %tool% - %version%
+        document:!archive1.zip:    Archive 1 - zip
+        document:!archive2.tgz:    Archive 2 - tgz
+        document:!archive3.tar.gz: Archive 3 - tar.gz
+        document:!archive4.tzst:   Archive 4 - tzst
+        document:!archive5.tar.zst:Archive 5 - tar.zst
+        document:$archive6.tgz:    Archive 6 - tgz + dir
+        document:$archive7.tar.gz: Archive 7 - tar.gz + dir
+        document:$archive8.tzst:   Archive 8 - tzst + dir
+        document:$archive9.tar.zst:Archive 9 - tar.zst + dir
+
+  NightlyPageWithInventory:
+    uses: ./.github/workflows/NightlyRelease.yml
+    needs:
+      - Build
+    secrets: inherit
+    permissions:
+      contents: write
+      actions: write
+#      attestations: write
+    with:
+      can-fail: true
+      replacements: |
+        version=4.2.0
+        tool=myTool
+        prog=program
+      nightly_name: inventory
+      nightly_title: "Nightly Test Release with Inventory"
+      nightly_description: |
+        This *nightly* release contains all latest and important artifacts created by %tool%'s CI pipeline.
+
+        # %tool% %version%
+
+        * %prog%
+        * iventory.json
+      inventory-json: "inventory.json"
+      inventory-version: 4.2.5
+      inventory-categories: "kind1,kind2"
+      assets: |
+        # artifact: file:          labels:    asset title
+        document: document1.txt:   doc,html:  Documentation
+        document: build.log:       build,log: Logfile - %tool% - %tool%
+        other:    document1.txt:   build,SBOM:SBOM - %version%
+        other:    %prog%.py:       app,binary:Application - %tool% - %version%
+        document:!archive1.zip:               Archive 1 - zip
+        document:!archive2.tgz:               Archive 2 - tgz
+        document:!archive3.tar.gz:            Archive 3 - tar.gz
+        document:!archive4.tzst:              Archive 4 - tzst
+        document:!archive5.tar.zst:           Archive 5 - tar.zst
+        document:$archive6.tgz:               Archive 6 - tgz + dir
+        document:$archive7.tar.gz:            Archive 7 - tar.gz + dir
+        document:$archive8.tzst:              Archive 8 - tzst + dir
+        document:$archive9.tar.zst:           Archive 9 - tar.zst + dir

.github/workflows/_Checking_Parameters.yml

@@ -6,54 +6,54 @@ on:
 
 jobs:
   Params_Default:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
     with:
       name: Example
 
   Params_PythonVersions:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
     with:
       name: Example
-      python_version_list: "3.9 3.10 pypy-3.8 pypy-3.9"
+      python_version_list: "3.11 3.12 pypy-3.9 pypy-3.10"
 
   Params_Systems:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
     with:
       name: Example
       system_list: "windows mingw32 mingw64"
 
   Params_Include:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
     with:
       name: Example
-      python_version_list: "3.10"
-      system_list: "ubuntu windows macos"
-      include_list: "ubuntu:3.11 ubuntu:3.12"
+      python_version_list: "3.11"
+      system_list: "ubuntu windows macos macos-arm"
+      include_list: "ubuntu:3.12 ubuntu:3.13"
 
   Params_Exclude:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
     with:
       name: Example
-      python_version_list: "3.10"
-      system_list: "ubuntu windows macos"
-      exclude_list: "windows:3.10 windows:3.11"
+      python_version_list: "3.12"
+      system_list: "ubuntu windows macos macos-arm"
+      exclude_list: "windows:3.12 windows:3.13"
 
   Params_Disable:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
     with:
       name: Example
-      python_version_list: "3.10"
-      system_list: "ubuntu windows macos"
-      disable_list: "windows:3.10 windows:3.11"
+      python_version_list: "3.12"
+      system_list: "ubuntu windows macos macos-arm"
+      disable_list: "windows:3.12 windows:3.13"
 
   Params_All:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
     with:
       name: Example
-      python_version_list: "3.10 3.11"
-      system_list: "ubuntu windows macos"
-      include_list: "windows:3.8 windows:3.9 windows:3.12"
-      exclude_list: "macos:3.10 macos:3.11"
+      python_version_list: "3.12 3.13"
+      system_list: "ubuntu windows macos macos-arm"
+      include_list: "windows:3.10 windows:3.11 windows:3.13"
+      exclude_list: "macos:3.12 macos:3.13"
 
   Params_Check:
     needs:
@@ -64,14 +64,14 @@ jobs:
       - Params_Exclude
       - Params_Disable
       - Params_All
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     defaults:
       run:
         shell: python
     steps:
       - name: Install dependencies
         shell: bash
-        run: pip install pyTooling
+        run: pip install --disable-pip-version-check --break-system-packages pyTooling
       # Params_Default
       - name: Checking results from 'Params_Default'
         run: |
@@ -80,10 +80,10 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.8", "3.9", "3.10", "3.11", "3.12"]
-          expectedSystems = ["ubuntu", "windows", "macos"]
-          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["mingw64:3.11", "ucrt64:3.11"]
+          expectedPythonVersion = "3.13"
+          expectedPythons = ["3.9", "3.10", "3.11", "3.12", "3.13"]
+          expectedSystems = ["ubuntu", "windows", "macos", "macos-arm"]
+          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["mingw64:3.12", "ucrt64:3.11"]
           expectedName =    "Example"
           expectedArtifacts = {
             "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
@@ -112,8 +112,15 @@ jobs:
             errors += 1
           if len(actualPythonJobs) != len(expectedJobs):
             print(f"Number of 'python_jobs' does not match: {len(actualPythonJobs)} != {len(expectedJobs)}.")
+            print("Actual jobs:")
             for job in actualPythonJobs:
-              print(f"  {job['system']}:{job['python']}")
+              if job['system'] == "msys2":
+                print(f"  {job['runtime'].lower()}:{job['python']}")
+              else:
+                print(f"  {job['system']}:{job['python']}")
+            print("Expected jobs:")
+            for job in expectedJobs:
+              print(f"  {job}")
             errors += 1
           if len(actualArtifactNames) != len(expectedArtifacts):
             print(f"Number of 'artifact_names' does not match: {len(actualArtifactNames)} != {len(expectedArtifacts)}.")
@@ -136,10 +143,10 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.9", "3.10", "pypy-3.8", "pypy-3.9"]
-          expectedSystems = ["ubuntu", "windows", "macos"]
-          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["mingw64:3.11", "ucrt64:3.11"]
+          expectedPythonVersion = "3.13"
+          expectedPythons = ["3.11", "3.12", "pypy-3.9", "pypy-3.10"]
+          expectedSystems = ["ubuntu", "windows", "macos", "macos-arm"]
+          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["mingw64:3.12", "ucrt64:3.11"]
           expectedName =    "Example"
           expectedArtifacts = {
             "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
@@ -168,8 +175,15 @@ jobs:
             errors += 1
           if len(actualPythonJobs) != len(expectedJobs):
             print(f"Number of 'python_jobs' does not match: {len(actualPythonJobs)} != {len(expectedJobs)}.")
+            print("Actual jobs:")
             for job in actualPythonJobs:
-              print(f"  {job['system']}:{job['python']}")
+              if job['system'] == "msys2":
+                print(f"  {job['runtime'].lower()}:{job['python']}")
+              else:
+                print(f"  {job['system']}:{job['python']}")
+            print("Expected jobs:")
+            for job in expectedJobs:
+              print(f"  {job}")
             errors += 1
           if len(actualArtifactNames) != len(expectedArtifacts):
             print(f"Number of 'artifact_names' does not match: {len(actualArtifactNames)} != {len(expectedArtifacts)}.")
@@ -192,10 +206,10 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.8", "3.9", "3.10", "3.11", "3.12"]
+          expectedPythonVersion = "3.13"
+          expectedPythons = ["3.9", "3.10", "3.11", "3.12", "3.13"]
           expectedSystems = ["windows"]
-          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["mingw32:3.11", "mingw64:3.11"]
+          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["mingw32:3.12", "mingw64:3.11"]
           expectedName =    "Example"
           expectedArtifacts = {
             "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
@@ -224,8 +238,15 @@ jobs:
             errors += 1
           if len(actualPythonJobs) != len(expectedJobs):
             print(f"Number of 'python_jobs' does not match: {len(actualPythonJobs)} != {len(expectedJobs)}.")
+            print("Actual jobs:")
             for job in actualPythonJobs:
-              print(f"  {job['system']}:{job['python']}")
+              if job['system'] == "msys2":
+                print(f"  {job['runtime'].lower()}:{job['python']}")
+              else:
+                print(f"  {job['system']}:{job['python']}")
+            print("Expected jobs:")
+            for job in expectedJobs:
+              print(f"  {job}")
             errors += 1
           if len(actualArtifactNames) != len(expectedArtifacts):
             print(f"Number of 'artifact_names' does not match: {len(actualArtifactNames)} != {len(expectedArtifacts)}.")
@@ -248,9 +269,9 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.10"]
-          expectedSystems = ["ubuntu", "windows", "macos"]
+          expectedPythonVersion = "3.13"
+          expectedPythons = ["3.12"]
+          expectedSystems = ["ubuntu", "windows", "macos", "macos-arm"]
           expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["ubuntu:3.11", "ubuntu:3.12"]
           expectedName =    "Example"
           expectedArtifacts = {
@@ -280,8 +301,15 @@ jobs:
             errors += 1
           if len(actualPythonJobs) != len(expectedJobs):
             print(f"Number of 'python_jobs' does not match: {len(actualPythonJobs)} != {len(expectedJobs)}.")
+            print("Actual jobs:")
             for job in actualPythonJobs:
-              print(f"  {job['system']}:{job['python']}")
+              if job['system'] == "msys2":
+                print(f"  {job['runtime'].lower()}:{job['python']}")
+              else:
+                print(f"  {job['system']}:{job['python']}")
+            print("Expected jobs:")
+            for job in expectedJobs:
+              print(f"  {job}")
             errors += 1
           if len(actualArtifactNames) != len(expectedArtifacts):
             print(f"Number of 'artifact_names' does not match: {len(actualArtifactNames)} != {len(expectedArtifacts)}.")
@@ -304,9 +332,9 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.10"]
-          expectedSystems = ["ubuntu", "macos"]
+          expectedPythonVersion = "3.13"
+          expectedPythons = ["3.12"]
+          expectedSystems = ["ubuntu", "macos", "macos-arm"]
           expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons]
           expectedName =    "Example"
           expectedArtifacts = {
@@ -336,8 +364,15 @@ jobs:
             errors += 1
           if len(actualPythonJobs) != len(expectedJobs):
             print(f"Number of 'python_jobs' does not match: {len(actualPythonJobs)} != {len(expectedJobs)}.")
+            print("Actual jobs:")
             for job in actualPythonJobs:
-              print(f"  {job['system']}:{job['python']}")
+              if job['system'] == "msys2":
+                print(f"  {job['runtime'].lower()}:{job['python']}")
+              else:
+                print(f"  {job['system']}:{job['python']}")
+            print("Expected jobs:")
+            for job in expectedJobs:
+              print(f"  {job}")
             errors += 1
           if len(actualArtifactNames) != len(expectedArtifacts):
             print(f"Number of 'artifact_names' does not match: {len(actualArtifactNames)} != {len(expectedArtifacts)}.")
@@ -360,9 +395,9 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.10"]
-          expectedSystems = ["ubuntu", "macos"]
+          expectedPythonVersion = "3.13"
+          expectedPythons = ["3.12"]
+          expectedSystems = ["ubuntu", "macos", "macos-arm"]
           expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons]
           expectedName =    "Example"
           expectedArtifacts = {
@@ -392,8 +427,15 @@ jobs:
             errors += 1
           if len(actualPythonJobs) != len(expectedJobs):
             print(f"Number of 'python_jobs' does not match: {len(actualPythonJobs)} != {len(expectedJobs)}.")
+            print("Actual jobs:")
             for job in actualPythonJobs:
-              print(f"  {job['system']}:{job['python']}")
+              if job['system'] == "msys2":
+                print(f"  {job['runtime'].lower()}:{job['python']}")
+              else:
+                print(f"  {job['system']}:{job['python']}")
+            print("Expected jobs:")
+            for job in expectedJobs:
+              print(f"  {job}")
             errors += 1
           if len(actualArtifactNames) != len(expectedArtifacts):
             print(f"Number of 'artifact_names' does not match: {len(actualArtifactNames)} != {len(expectedArtifacts)}.")
@@ -416,10 +458,10 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.10", "3.11"]
-          expectedSystems = ["ubuntu", "windows"]
-          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["windows:3.8", "windows:3.9", "windows:3.12"]
+          expectedPythonVersion = "3.13"
+          expectedPythons = ["3.12", "3.13"]
+          expectedSystems = ["ubuntu", "macos-arm", "windows"]
+          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["windows:3.10", "windows:3.11", "windows:3.13"]
           expectedName =    "Example"
           expectedArtifacts = {
             "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
@@ -448,8 +490,15 @@ jobs:
             errors += 1
           if len(actualPythonJobs) != len(expectedJobs):
             print(f"Number of 'python_jobs' does not match: {len(actualPythonJobs)} != {len(expectedJobs)}.")
+            print("Actual jobs:")
             for job in actualPythonJobs:
-              print(f"  {job['system']}:{job['python']}")
+              if job['system'] == "msys2":
+                print(f"  {job['runtime'].lower()}:{job['python']}")
+              else:
+                print(f"  {job['system']}:{job['python']}")
+            print("Expected jobs:")
+            for job in expectedJobs:
+              print(f"  {job}")
             errors += 1
           if len(actualArtifactNames) != len(expectedArtifacts):
             print(f"Number of 'artifact_names' does not match: {len(actualArtifactNames)} != {len(expectedArtifacts)}.")

.github/workflows/_Checking_Pipeline.yml

@@ -1,191 +0,0 @@
-name: Verification of Complete Pipeline
-
-on:
-  push:
-  workflow_dispatch:
-
-jobs:
-  UnitTestingParams:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
-    with:
-      name: pyDummy
-      python_version_list: "3.8 3.9 3.10 3.11 3.12 pypy-3.8 pypy-3.9 pypy-3.10"
-      disable_list: "windows:pypy-3.10"
-
-  PlatformTestingParams:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
-    with:
-      name: Platform
-      python_version_list: ""
-      system_list: "ubuntu windows macos mingw32 mingw64 clang64 ucrt64"
-
-  UnitTesting:
-    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r1
-    needs:
-      - UnitTestingParams
-    with:
-      jobs: ${{ needs.UnitTestingParams.outputs.python_jobs }}
-      unittest_xml_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
-      unittest_html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_html }}
-#      coverage_sqlite_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}
-#      coverage_xml_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}
-#      coverage_json_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
-#      coverage_html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
-
-  PlatformTesting:
-    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r1
-    needs:
-      - PlatformTestingParams
-    with:
-      jobs: ${{ needs.PlatformTestingParams.outputs.python_jobs }}
-#      tests_directory: ""
-      unittest_directory: platform
-      unittest_xml_artifact: ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).unittesting_xml }}
-      unittest_html_artifact: ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).unittesting_html }}
-      coverage_sqlite_artifact: ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_sqlite }}
-      coverage_xml_artifact: ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_xml }}
-      coverage_json_artifact: ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_json }}
-      coverage_html_artifact: ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_html }}
-
-#  Coverage:
-#    uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r1
-#    needs:
-#      - UnitTestingParams
-#    with:
-#      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
-#      artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
-#    secrets:
-#      codacy_token: ${{ secrets.CODACY_PROJECT_TOKEN }}
-
-  StaticTypeCheck:
-    uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@r1
-    needs:
-      - UnitTestingParams
-    with:
-      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
-      commands: |
-        mypy --html-report htmlmypy -p pyDummy
-      html_report: 'htmlmypy'
-      html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
-
-  PublishCoverageResults:
-    uses: pyTooling/Actions/.github/workflows/PublishCoverageResults.yml@r1
-    needs:
-      - UnitTestingParams
-      - UnitTesting
-      - PlatformTesting
-#      - Coverage
-    with:
-      coverage_sqlite_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}
-      coverage_xml_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}
-      coverage_json_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
-      coverage_html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
-    secrets:
-      codacy_token: ${{ secrets.CODACY_PROJECT_TOKEN }}
-
-  PublishTestResults:
-    uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@r1
-    needs:
-      - UnitTesting
-      - PlatformTesting
-
-  Package:
-    uses: pyTooling/Actions/.github/workflows/Package.yml@r1
-    needs:
-      - UnitTestingParams
-      - UnitTesting
-#      - Coverage
-      - PlatformTesting
-    with:
-      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
-      artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
-
-#  VerifyDocs:
-#    uses: pyTooling/Actions/.github/workflows/VerifyDocs.yml@r1
-#    needs:
-#      - UnitTestingParams
-#    with:
-#      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
-
-  BuildTheDocs:
-    uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r1
-    needs:
-      - UnitTestingParams
-#      - VerifyDocs
-    with:
-      artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
-
-  PublishToGitHubPages:
-    uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r1
-    needs:
-      - UnitTestingParams
-      - BuildTheDocs
-#      - Coverage
-      - PublishCoverageResults
-      - StaticTypeCheck
-    with:
-      doc: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
-      coverage: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
-      typing: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
-
-  ReleasePage:
-    uses: pyTooling/Actions/.github/workflows/Release.yml@r1
-    if: startsWith(github.ref, 'refs/tags')
-    needs:
-      - UnitTesting
-      - PlatformTesting
-#      - Coverage
-#      - StaticTypeCheck
-      - Package
-      - PublishToGitHubPages
-
-  PublishOnPyPI:
-    uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@r1
-    if: startsWith(github.ref, 'refs/tags')
-    needs:
-      - UnitTestingParams
-      - ReleasePage
-#      - Package
-    with:
-      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
-      requirements: -r dist/requirements.txt
-      artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
-    secrets:
-      PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
-
-  ArtifactCleanUp:
-    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r1
-    needs:
-      - UnitTestingParams
-      - PlatformTestingParams
-      - UnitTesting
-      - PlatformTesting
-#      - Coverage
-      - StaticTypeCheck
-#      - BuildTheDocs
-      - PublishToGitHubPages
-      - PublishCoverageResults
-      - PublishTestResults
-    with:
-      package: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
-      remaining: |
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}-*
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_html }}-*
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}-*
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}-*
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}-*
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}-*
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_html }}
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_sqlite }}
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_xml }}
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_json }}
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
-        ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
-        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).unittesting_xml }}-*
-        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).unittesting_html }}-*
-        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_sqlite }}-*
-        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_xml }}-*
-        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_json }}-*
-        ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_html }}-*

.github/workflows/_Checking_SimplePackage_Pipeline.yml

@@ -0,0 +1,19 @@
+name: Verification of Pipeline Templates (Simple Package)
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  SimplePackage:
+    uses: pyTooling/Actions/.github/workflows/CompletePipeline.yml@r4
+    with:
+      package_name: pyDummy
+      codecov: true
+      codacy:  true
+      dorny:   true
+      cleanup: false
+    secrets:
+      PYPI_TOKEN:           ${{ secrets.PYPI_TOKEN }}
+      CODECOV_TOKEN:        ${{ secrets.CODECOV_TOKEN }}
+      CODACY_PROJECT_TOKEN: ${{ secrets.CODACY_PROJECT_TOKEN }}

.gitignore

@@ -13,6 +13,7 @@ coverage.xml
 
 # pytest
 /report/unit
+/tests/*.github
 
 # setuptools
 /build/**/*.*
@@ -30,7 +31,7 @@ doc/pyDummy/**/*.*
 # BuildTheDocs
 doc/_theme/**/*.*
 
-# IntelliJ project files
+# PyCharm project files
 /.idea/workspace.xml
 
 # Git files

.idea/Actions.iml

@@ -2,7 +2,7 @@
 <module type="PYTHON_MODULE" version="4">
   <component name="NewModuleRootManager">
     <content url="file://$MODULE_DIR$" />
-    <orderEntry type="inheritedJdk" />
+    <orderEntry type="jdk" jdkName="Python 3.13" jdkType="Python SDK" />
     <orderEntry type="sourceFolder" forTests="false" />
   </component>
 </module>

ExamplePipeline.yml

@@ -1,178 +0,0 @@
-# ==================================================================================================================== #
-# Authors:                                                                                                             #
-#   Patrick Lehmann                                                                                                    #
-#   Unai Martinez-Corral                                                                                               #
-#                                                                                                                      #
-# ==================================================================================================================== #
-# Copyright 2020-2024 The pyTooling Authors                                                                            #
-#                                                                                                                      #
-# Licensed under the Apache License, Version 2.0 (the "License");                                                      #
-# you may not use this file except in compliance with the License.                                                     #
-# You may obtain a copy of the License at                                                                              #
-#                                                                                                                      #
-#   http://www.apache.org/licenses/LICENSE-2.0                                                                         #
-#                                                                                                                      #
-# Unless required by applicable law or agreed to in writing, software                                                  #
-# distributed under the License is distributed on an "AS IS" BASIS,                                                    #
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.                                             #
-# See the License for the specific language governing permissions and                                                  #
-# limitations under the License.                                                                                       #
-#                                                                                                                      #
-# SPDX-License-Identifier: Apache-2.0                                                                                  #
-# ==================================================================================================================== #
-name: Pipeline
-
-on:
-  workflow_dispatch:
-
-jobs:
-
-  # This job is a workaround for global variables
-  # See https://github.com/actions/runner/issues/480
-  Params:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@main
-    with:
-      name: ToolName
-      # Optional
-      system_list: 'ubuntu windows msys2 macos'
-      python_version: '3.10'
-      python_version_list: '3.8 3.9 3.10'
-
-  UnitTesting:
-    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@main
-    needs:
-      - Params
-    with:
-      jobs: ${{ needs.Params.outputs.python_jobs }}
-      # Optional
-      requirements: '-r tests/requirements.txt'
-      pacboy: >-
-        python-pip:p
-        python-wheel:p
-        python-coverage:p
-        python-lxml:p
-      mingw_requirements: '-r tests/requirements.mingw.txt'
-      tests_directory: 'tests'
-      unittest_directory: 'unit'
-      artifact: ${{ fromJson(needs.Params.outputs.artifact_names).unittesting_xml }}
-
-  Coverage:
-    uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@main
-    needs:
-      - Params
-    with:
-      artifact: ${{ fromJson(needs.Params.outputs.artifact_names).codecoverage_html }}
-      # Optional
-      python_version: ${{ needs..Params.outputs.python_version }}
-      requirements: '-r tests/requirements.txt'
-      tests_directory: 'tests'
-      unittest_directory: 'unit'
-    secrets:
-      codacy_token: ${{ secrets.CODACY_PROJECT_TOKEN }}
-
-  StaticTypeCheck:
-    uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@main
-    needs:
-      - Params
-    with:
-      commands: |
-        mypy --junit-xml StaticTypingSummary.xml --html-report htmlmypy -p ToolName
-      html_artifact: ${{ fromJson(needs.Params.outputs.artifact_names).statictyping_html }}
-      junit_artifact: ${{ fromJson(needs.Params.outputs.artifact_names).statictyping_junit }}
-      # Optional
-      python_version: ${{ needs..Params.outputs.python_version }}
-      requirements: '-r tests/requirements.txt'
-      html_report: 'htmlmypy'
-      junit_report: 'StaticTypingSummary.xml'
-      allow_failure: true
-
-  PublishTestResults:
-    uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@main
-    needs:
-      - UnitTesting
-      - StaticTypeCheck
-    with:
-      # Optional
-      report_files: artifacts/**/*.xml
-
-  Package:
-    uses: pyTooling/Actions/.github/workflows/Package.yml@main
-    needs:
-      - Params
-      - Coverage
-    with:
-      artifact: ${{ fromJson(needs.Params.outputs.artifact_names).package_all }}
-      # Optional
-      python_version: ${{ needs..Params.outputs.python_version }}
-      requirements: 'wheel'
-
-  Release:
-    uses: pyTooling/Actions/.github/workflows/Release.yml@main
-    if: startsWith(github.ref, 'refs/tags')
-    needs:
-      - UnitTesting
-      - Coverage
-      - StaticTypeCheck
-      - Package
-
-  PublishOnPyPI:
-    uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@main
-    if: startsWith(github.ref, 'refs/tags')
-    needs:
-      - Params
-      - Release
-      - Package
-    with:
-      artifact: ${{ fromJson(needs.Params.outputs.artifact_names).package_all }}
-      # Optional
-      python_version: ${{ needs..Params.outputs.python_version }}
-      requirements: 'wheel twine'
-    secrets:
-      PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
-
-  VerifyDocs:
-    uses: pyTooling/Actions/.github/workflows/VerifyDocs.yml@main
-    needs:
-      - Params
-    with:
-      # Optional
-      python_version: ${{ needs..Params.outputs.python_version }}
-
-  BuildTheDocs:
-    uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@main
-    needs:
-      - Params
-      - VerifyDocs
-    with:
-      artifact: ${{ fromJson(needs.Params.outputs.artifact_names).documentation_html }}
-
-  PublishToGitHubPages:
-    uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@main
-    needs:
-      - Params
-      - BuildTheDocs
-      - Coverage
-      - StaticTypeCheck
-    with:
-      doc: ${{ fromJson(needs.Params.outputs.artifact_names).documentation_html }}
-      # Optional
-      coverage: ${{ fromJson(needs.Params.outputs.artifact_names).codecoverage_html }}
-      typing: ${{ fromJson(needs.Params.outputs.artifact_names).statictyping_html }}
-
-  ArtifactCleanUp:
-    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@main
-    needs:
-      - Params
-      - PublishTestResults
-      - Coverage
-      - StaticTypeCheck
-      - BuildTheDocs
-      - PublishToGitHubPages
-    with:
-      package: ${{ fromJson(needs.Params.outputs.artifact_names).package_all }}
-      remaining: |
-        ${{ fromJson(needs.Params.outputs.artifact_names).unittesting_xml }}-*
-        ${{ fromJson(needs.Params.outputs.artifact_names).codecoverage_html }}
-        ${{ fromJson(needs.Params.outputs.artifact_names).statictyping_html }}
-        ${{ fromJson(needs.Params.outputs.artifact_names).statictyping_junit }}
-        ${{ fromJson(needs.Params.outputs.artifact_names).documentation_html }}

README.md

@@ -10,52 +10,97 @@ This repository gathers reusable CI tooling for testing, packaging and distribut
 See [GitHub Actions and GitHub Reusable Workflows](https://pytooling.github.io/Actions/Background.html) for more
 background information.
 
-## Reusable workflows
+## Reusable Actions
+
+- **Artifacts:**  
+  [**pyTooling/upload-artifact**](https://github.com/pyTooling/upload-artifact): The upload-artifact action will
+  preserve file attributes like permissions.
+
+  [**pyTooling/download-artifact**](https://github.com/pyTooling/download-artifact): The download-artifact action will
+  preserve file attributes like permissions.
+
+## Predefined Docker Images
+
+- **Documentation:**  
+  [**MikTeX**](https://github.com/pyTooling/MikTeX): A predefined MikTeX image based on Debian Bookworm + Python 3.13
+  with specific tools for documentation generation using e.g. Sphinx and related extensions.
+
+## Reusable Workflows
 
 This repository provides 10+ *Reusable Workflows* based on the CI pipelines of the repos in this GitHub organisation,
 [EDA²](https://github.com/edaa-org), [VHDL](https://github.com/vhdl), and others. By combining them, Python packages can
 be continuously tested and released along with Sphinx documentation sites, to GitHub Releases, GitHub Pages and PyPI.
 Optionally, coverage and static type check reports can be gathered and integrated into the online documentation.
 
-[![](ExamplePipeline_dark.png)](ExamplePipeline_dark.png)
-
-[![](ExamplePipeline_light.png)](ExamplePipeline_light.png)
+[![](doc/_static/pyTooling-Actions-SimplePackage.png)](doc/_static/pyTooling-Actions-SimplePackage.png)
 
 As shown in the screenshots above, the expected order is:
 
-- Global:
-  - [Parameters](.github/workflows/Parameters.yml): a workaround for the limitations to handle global variables in
-    GitHub Actions workflows (see [actions/runner#480](https://github.com/actions/runner/issues/480)).
-    It generates outputs with artifact names and job matrices to be used in later running jobs.
-- Code testing/analysis:
-  - [UnitTesting](.github/workflows/UnitTesting.yml): run unit test with `pytest` using multiple versions of Python, and
-    optionally upload results as XML reports. Configuration options to `pytest` should be given via section
-   `[tool.pytest.ini_options]` in a `pyproject.toml` file.
-  - [CoverageCollection](.github/workflows/CoverageCollection.yml): collect code coverage data (incl. branch coverage)
-    with `pytest`/`pytest-cov`/`coverage.py` using a single version of Python (latest). It generates HTML and Cobertura
-    (XML)reports, upload the HTML report as an artifact, and upload the test results to Codecov and Codacy. Configuration
-    options to `pytest` and `coverage.py` should be given via section `[tool.pytest.ini_options]` and `[tool.coverage.*]`
-    in a `pyproject.toml` file.
-  - [StaticTypeCheck](.github/workflows/StaticTypeCheck.yml): collect static type check result with `mypy`, and
-    optionally upload results as an HTML report.
-    Example `commands`:
+- **Global:**  
+  [**Parameters**](.github/workflows/Parameters.yml): It generates output parameters with artifact names and job matrices
+  to be used in later running jobs.  
+  It's a workaround for the limitations to handle global variables in GitHub Actions workflows (see
+  [actions/runner#480](https://github.com/actions/runner/issues/480)).
+  
+  [**ExtractConfiguration**](.github/workflows/ExtractConfiguration.yml): extracts configuration values from
+  `pyproject.toml` and exposes configured paths and filenames as job output parameters.
+- **Predefined pipelines:**  
+  [**CompletePipeline**](.github/workflows/CompletePipeline.yml): is a predefined pipeline for typical Python projects
+  using all predefined job templates of pyTooling at once: (unit testing, code coverage, static typing, documentation
+  report generation and publishing, packaging, releasing, ...)
+- **Code testing/analysis:**  
+  [**ApplicationTesting**](.github/workflows/ApplicationTesting.yml): like UnitTesting, but running tests using an
+  installed Python package.
+  
+  [**UnitTesting**](.github/workflows/UnitTesting.yml): run unit test with `pytest` using multiple versions of Python, and
+  optionally upload results as XML reports. Configuration options to `pytest` should be given via section
+  `[tool.pytest.ini_options]` in a `pyproject.toml` file.  
+  Besides test results, also code coverage data (incl. branch coverage) can be collected using
+  `pytest`/`pytest-cov`/`coverage.py`. Configuration options to `coverage.py` should be given via section
+  `[tool.coverage.*]` in a `pyproject.toml` file.  
+  While multiple report formats can be created in the job, it's recommended to use `PublishTestResults` and/or
+  `PublishCoverageResults` to merge results from matrix runs and then generate final reports as XML, JSON or HTML.  
+  Finally, reports can be published to GitHub Pages or cloud services like Codecov and Codacy.
+  
+  [**StaticTypeCheck**](.github/workflows/StaticTypeCheck.yml): collect static type check result with `mypy`, and
+  optionally upload results as an HTML report.
+  
+  [**VerifyDocs**](.github/workflows/VerifyDocs.yml): extract code examples from the README and test these code snippets.
+- **Packaging and releasing:**  
+  [**Package**](.github/workflows/Package.yml): generate source and wheel packages, and upload them as an artifact.
+
+  [**PublishOnPyPI**](.github/workflows/PublishOnPyPI.yml): publish source and wheel packages to PyPI.
+
+  [**PublishTestResults**](.github/workflows/PublishTestResults.yml): publish unit test results through GH action `dorny/test-reporter`.
+
+  [**PublishCoverageResults**](.github/workflows/PublishCoverageResults.yml): publish ucode coverage results.
+
+  [**NightlyRelease**](.github/workflows/NightlyRelease.yml): publish GitHub Release.
+
+  [**Release**](.github/workflows/Release.yml): publish GitHub Release.
+- **Documentation:**  
+  [**SphinxDocumentation**](.github/workflows/PublishCoverageResults.yml): create HTML and LaTeX documentation using
+  Sphinx.
+  
+  [**LaTeXDocumentation**](.github/workflows/LaTeXDocumentation.yml): compile LaTeX documentation to a PDF file using
+  MikTeX.
+  
+  [**PublishToGitHubPages**](.github/workflows/PublishToGitHubPages.yml): publish HTML documentation to GitHub Pages.
+- **Cleanup:**  
+  [**IntermediateCleanUp**](.github/workflows/IntermediateCleanUp.yml): delete intermediate artifacts.
+  
+  [**ArtifactCleanUp**](.github/workflows/ArtifactCleanUp.yml): delete artifacts.
+- **⚠ Deprecated ⚠:**  
+  [**CoverageCollection**](.github/workflows/CoverageCollection.yml): Use `UnitTesting`, because is can collect code
+  coverage too. This avoids code duplication in job templates.
+  
+  [**BuildTheDocs**](.github/workflows/BuildTheDocs.yml): Use `SphinxDocumentation`, `LaTeXDocumentation` and
+  `PublishToGitHubPages`. BuildTheDocs isn't maintained anymore.
 
-  - [VerifyDocs](.github/workflows/VerifyDocs.yml): extract code examples from the README and test these code snippets.
-- Packaging and releasing:
-  - [Release](.github/workflows/Release.yml): publish GitHub Release.
-  - [Package](.github/workflows/Package.yml): generate source and wheel packages, and upload them as an artifact.
-  - [PublishOnPyPI](.github/workflows/PublishOnPyPI.yml): publish source and wheel packages to PyPI.
-  - [PublishTestResults](.github/workflows/PublishTestResults.yml): publish unit test results through GH action `dorny/test-reporter`.
-- Documentation:
-  - [BuildTheDocs](.github/workflows/BuildTheDocs.yml): build Sphinx documentation with BuildTheDocs, and upload HTML as
-    an artifact.
-  - [PublishToGitHubPages](.github/workflows/PublishToGitHubPages.yml): publish HTML documentation to GitHub Pages.
-- Cleanup:
-  - [ArtifactCleanUp](.github/workflows/ArtifactCleanUp.yml): delete artifacts.
 
 ### Example pipeline
 
-[ExamplePipeline.yml](ExamplePipeline.yml) is an example Workflow which uses all of the Reusable Workflows.
+ExamplePipeline.yml is an example Workflow which uses all of the Reusable Workflows.
 Python package/tool developers can copy it into their repos, in order to use al the reusable workflows straightaway.
 Minimal required modifications are the following:
 

dist/requirements.txt

@@ -0,0 +1,2 @@
+wheel ~= 0.45
+twine ~= 6.1

doc/Action/Releaser.rst

@@ -81,7 +81,7 @@ The following block shows a minimal YAML workflow file:
 
    jobs:
      mwe:
-       runs-on: ubuntu-latest
+       runs-on: ubuntu-24.04
        steps:
 
        # Clone repository
@@ -95,7 +95,7 @@ The following block shows a minimal YAML workflow file:
        # Update tag and pre-release
        # - Update (force-push) tag to the commit that is used in the workflow.
        # - Upload artifacts defined by the user.
-       - uses: pyTooling/Actions/releaser@r0
+       - uses: pyTooling/Actions/releaser@r4
          with:
            token: ${{ secrets.GITHUB_TOKEN }}
            files: |
@@ -171,7 +171,7 @@ For prototyping purposes, the following job might be useful:
 
    Release:
      name: '📦 Release'
-     runs-on: ubuntu-latest
+     runs-on: ubuntu-24.04
      needs:
        - ...
      if: github.event_name != 'pull_request' && (github.ref == 'refs/heads/master' || contains(github.ref, 'refs/tags/'>`__)

doc/Instantiation.rst

@@ -60,12 +60,12 @@ Documentation Only (Sphinx)
 
    jobs:
      BuildTheDocs:
-       uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r0
+       uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r4
        with:
          artifact: Documentation
 
      PublishToGitHubPages:
-       uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r0
+       uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r4
        needs:
          - BuildTheDocs
        with:
@@ -76,7 +76,7 @@ Documentation Only (Sphinx)
        needs:
          - BuildTheDocs
          - PublishToGitHubPages
-       runs-on: ubuntu-latest
+       runs-on: ubuntu-24.04
 
        steps:
          - name: 🗑️ Delete artifacts

doc/JobTemplate/ArtifactCleanUp.rst

@@ -27,7 +27,7 @@ The simplest variant just uses the artifact name for the package.
 
    jobs:
      ArtifactCleanUp:
-       uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r0
+       uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r4
        with:
          package: Package
 
@@ -39,7 +39,7 @@ Complex Example
 
    jobs:
      ArtifactCleanUp:
-       uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r0
+       uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r4
        needs:
          - Params
          - UnitTesting

doc/JobTemplate/BuildTheDocs.rst

@@ -30,7 +30,7 @@ Simple Example
 
    jobs:
      BuildTheDocs:
-       uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r0
+       uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r4
 
 
 Complex Example
@@ -40,7 +40,7 @@ Complex Example
 
    jobs:
      BuildTheDocs:
-       uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r0
+       uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r4
        needs:
          - Params
        with:

doc/JobTemplate/CoverageCollection.rst

@@ -52,7 +52,7 @@ Simple Example
 
    jobs:
      Coverage:
-       uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r0
+       uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r4
        with:
          artifact: Coverage
        secrets:
@@ -65,7 +65,7 @@ Complex Example
 
    jobs:
      Coverage:
-       uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r0
+       uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r4
        needs:
          - Params
        with:

doc/JobTemplate/Package.rst

@@ -33,7 +33,7 @@ Simple Example
 
    jobs:
      Package:
-       uses: pyTooling/Actions/.github/workflows/Package.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Package.yml@r4
        with:
          artifact: Package
 
@@ -45,7 +45,7 @@ Complex Example
 
    jobs:
      Package:
-       uses: pyTooling/Actions/.github/workflows/Package.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Package.yml@r4
        needs:
          - Params
          - Coverage

doc/JobTemplate/Parameters.rst

@@ -35,7 +35,7 @@ requires a `name` parameter to create the artifact names.
 
    jobs:
      Params:
-       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
        with:
          name: pyTooling
 
@@ -44,7 +44,7 @@ Complex Example
 
 The following instantiation example creates 3 jobs from the same template, but with differing input parameters. The
 first job `UnitTestingParams` might be used to create a job matrix of unit tests. It creates the cross of default
-systems (Windows, Ubuntu, MacOS, MinGW64, UCRT64) and the given list of Python versions including some mypy versions. In
+systems (Windows, Ubuntu, macOS, MinGW64, UCRT64) and the given list of Python versions including some mypy versions. In
 addition a list of excludes (marked as :deletion:`deletions`) and includes (marked as :addition:`additions`) is handed
 over resulting in the following combinations:
 
@@ -55,7 +55,7 @@ over resulting in the following combinations:
 +------------+-------------+-------------+--------------+--------------+-------------------------+------------+-------------+------------------------------+-------------------------------+
 | Ubuntu 🐧  | ubuntu:3.8  | ubuntu:3.9  | ubuntu:3.10  | ubuntu:3.11  | :addition:`ubuntu:3.12` |            |             | ubuntu:pypy-3.9              | ubuntu:pypy-3.10              |
 +------------+-------------+-------------+--------------+--------------+-------------------------+------------+-------------+------------------------------+-------------------------------+
-| MacOS 🍎   | macos:3.8   | macos:3.9   | macos:3.10   | macos:3.11   | :addition:`macos:3.12`  |            |             | macos:pypy-3.9               | macos:pypy-3.10               |
+| macOS 🍎   | macos:3.8   | macos:3.9   | macos:3.10   | macos:3.11   | :addition:`macos:3.12`  |            |             | macos:pypy-3.9               | macos:pypy-3.10               |
 +------------+-------------+-------------+--------------+--------------+-------------------------+------------+-------------+------------------------------+-------------------------------+
 | MSYS 🟪    |             |             |              |              |                         |            |             |                              |                               |
 +------------+-------------+-------------+--------------+--------------+-------------------------+------------+-------------+------------------------------+-------------------------------+
@@ -81,7 +81,7 @@ over resulting in the following combinations:
 
    jobs:
      UnitTestingParams:
-       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
        with:
          name: pyTooling
          python_version_list: "3.8 3.9 3.10 3.11 pypy-3.9 pypy-3.10"
@@ -89,14 +89,14 @@ over resulting in the following combinations:
          exclude_list: "windows:pypy-3.9 windows:pypy-3.10"
 
      PerformanceTestingParams:
-       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
        with:
          name: pyTooling
          python_version_list: "3.11 3.12"
          system_list: "ubuntu windows macos"
 
      PlatformTestingParams:
-       uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
        with:
          name: pyTooling
          python_version_list: "3.12"
@@ -138,7 +138,7 @@ python_version_list
 | Parameter Name       | Required | Type     | Default                    |
 +======================+==========+==========+============================+
 | python_version_list  | optional | string   | ``3.8 3.9 3.10 3.11 3.12`` |
-+----------------------+----------+----------+-------------------------- -+
++----------------------+----------+----------+----------------------------+
 
 Space separated list of CPython versions and/or mypy version to run tests with.
 
@@ -197,7 +197,7 @@ Space separated list of systems to run tests on.
 +------+-----------+------------------------------+-----------------------------------------------------------------+
 | 🐧   | Ubuntu    | Ubuntu 22.04 (LTS) (latest)  |                                                                 |
 +------+-----------+------------------------------+-----------------------------------------------------------------+
-| 🍎   | MacOS     | macOS Monterey 12 (latest)   | While this marked latest, macOS Ventura 13 is already provided. |
+| 🍎   | macOS     | macOS Monterey 12 (latest)   | While this marked latest, macOS Ventura 13 is already provided. |
 +------+-----------+------------------------------+-----------------------------------------------------------------+
 | 🟪   | MSYS      |                              |                                                                 |
 +------+-----------+------------------------------+-----------------------------------------------------------------+
@@ -297,12 +297,12 @@ variables. Thus, this job is used to compute an output parameter that can be reu
 
    jobs:
      Params:
-       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
        with:
          name: pyTooling
 
      CodeCoverage:
-       uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r0
+       uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r4
        needs:
          - Params
        with:
@@ -330,12 +330,12 @@ A job description contains the following key-value pairs:
 
    jobs:
      Params:
-       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
        with:
          name: pyTooling
 
      UnitTesting:
-       uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@dev
+       uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r4
        needs:
          - Params
        with:
@@ -389,12 +389,12 @@ The supported artifacts are:
 
    jobs:
      Params:
-       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Parameters.yml@r4
        with:
          name: pyTooling
 
      Coverage:
-       uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@dev
+       uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r4
        needs:
          - Params
        with:

doc/JobTemplate/PublishOnPyPI.rst

@@ -42,7 +42,7 @@ by a Git tag. A secret is forwarded from GitHub secrets to a job secret.
      # ...
 
      PublishOnPyPI:
-       uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@r0
+       uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@r4
        if: startsWith(github.ref, 'refs/tags')
        with:
          artifact: Package
@@ -66,7 +66,7 @@ by that job. Finally, the list of requirements is overwritten to load a list of
        # ...
 
      PublishOnPyPI:
-       uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@r0
+       uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@r4
        if: startsWith(github.ref, 'refs/tags')
        needs:
          - Params

doc/JobTemplate/PublishTestResults.rst

@@ -34,7 +34,7 @@ Simple Example
 
    jobs:
      PublishTestResults:
-       uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@r0
+       uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@r4
 
 Complex Example
 ===============
@@ -49,7 +49,7 @@ Complex Example
        # ...
 
      PublishTestResults:
-       uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@r0
+       uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@r4
        needs:
          - CodeCoverage
          - UnitTesting

doc/JobTemplate/PublishToGitHubPages.rst

@@ -29,7 +29,7 @@ Simple Example
        # ...
 
      PublishToGitHubPages:
-       uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r0
+       uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r4
        needs:
          - BuildTheDocs
        with:
@@ -43,7 +43,7 @@ Complex Example
 
    jobs:
      PublishToGitHubPages:
-       uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r0
+       uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r4
        needs:
          - Params
          - BuildTheDocs

doc/JobTemplate/Release.rst

@@ -12,13 +12,36 @@ This job creates a Release Page on GitHub.
    **Automated Release created on: ${{ steps.getVariables.outputs.datetime }}**
 
    # New Features
+
+   * tbd
    * tbd
 
    # Changes
+
+   * tbd
    * tbd
 
    # Bug Fixes
+
    * tbd
+   * tbd
+
+   # Documentation
+
+   * tbd
+   * tbd
+
+   # Unit Tests
+
+   * tbd
+   * tbd
+
+   ----------
+   # Related Issues and Pull-Requests
+
+   * tbd
+   * tbd
+
 
 **Behavior:**
 
@@ -39,7 +62,7 @@ Simple Example
 
    jobs:
      Release:
-       uses: pyTooling/Actions/.github/workflows/Release.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Release.yml@r4
 
 
 Complex Example
@@ -49,7 +72,7 @@ Complex Example
 
    jobs:
      Release:
-       uses: pyTooling/Actions/.github/workflows/Release.yml@r0
+       uses: pyTooling/Actions/.github/workflows/Release.yml@r4
        if: startsWith(github.ref, 'refs/tags')
        needs:
          - Package

doc/JobTemplate/StaticTypeCheck.rst

@@ -29,7 +29,7 @@ Simple Example
 
    jobs:
      StaticTypeCheck:
-       uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@r0
+       uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@r4
        with:
          commands: |
            touch pyTooling/__init__.py
@@ -44,7 +44,7 @@ Complex Example
 
    jobs:
      StaticTypeCheck:
-       uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@r0
+       uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@r4
        needs:
          - Params
        with:

doc/JobTemplate/UnitTesting.rst

@@ -36,7 +36,7 @@ Simple Example
        # ...
 
      UnitTesting:
-       uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r0
+       uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r4
        needs:
          - Params
        with:

doc/_static/css/override.css

@@ -0,0 +1,115 @@
+/* theme overrides */
+.rst-content h1,
+.rst-content h2 {
+	margin-top: 24px;
+	margin-bottom: 6px;
+	text-decoration: underline;
+}
+
+.rst-content h3,
+.rst-content h4,
+.rst-content h5,
+.rst-content h6 {
+	margin-top: 12px;
+	margin-bottom: 6px;
+}
+
+.rst-content p {
+	margin-bottom: 6px
+}
+
+/* general overrides */
+html {
+	font-size: 15px;
+}
+
+footer {
+  font-size: 95%;
+  text-align: center
+}
+
+footer p {
+  margin-bottom: 0px /* 12px */;
+  font-size: 95%
+}
+
+section > p,
+.section p,
+.simple li {
+	text-align: justify
+}
+
+.rst-content .topic-title {
+	font-size: larger;
+	font-weight: 700;
+	margin-top: 18px;
+	margin-bottom: 6px;
+}
+
+.rst-content p.rubric {
+	text-decoration: underline;
+	font-weight: 700;
+	margin-top: 18px;
+	margin-bottom: 16px;
+}
+
+/* wyrm overrides */
+.wy-menu-vertical header,
+.wy-menu-vertical p.caption {
+	color: #9b9b9b /* #55a5d9 */;
+	padding: 0 0.809em /* 0 1.618em */;
+	margin: 6px 0 0 0 /* 12px 0 0 */;
+	border-top: 1px solid #9b9b9b;
+}
+
+.wy-side-nav-search {
+	margin-bottom: 0 /* .809em */;
+	background-color: #333333 /* #2980b9 */;
+	/* BTD: */
+	/*color: #fcfcfc*/
+}
+
+.wy-side-nav-search input[type=text] {
+	border-radius: 0px /* 50px */;
+}
+
+.wy-side-nav-search .wy-dropdown > a, .wy-side-nav-search > a {
+	/* BTD: */
+	/*color: #fcfcfc;*/
+	margin-bottom: 0.404em /* .809em */;
+}
+
+.wy-side-nav-search > div.version {
+  margin: 0 0 6px 0;
+  /* BTD: */
+  /*margin-top: -.4045em;*/
+}
+
+.wy-nav .wy-menu-vertical a:hover {
+  background-color:  #333333 /* #2980b9 */;
+}
+
+.wy-nav-content {
+  max-width: 1600px /* 800px */ ;
+}
+
+.wy-nav-top {
+  background:  #333333 /* #2980b9 */;
+}
+
+/* Sphinx Design */
+.sd-tab-set {
+	margin: 0
+}
+
+.sd-tab-set > label {
+	padding-top: .5em;
+	padding-right: 1em;
+	padding-bottom: .5em;
+	padding-left: 1em
+}
+
+.sd-container-fluid {
+	padding-left: 0;
+	padding-right: 0;
+}

doc/conf.py

@@ -14,7 +14,7 @@ ROOT = Path(__file__).resolve().parent
 sys_path.insert(0, abspath("."))
 sys_path.insert(0, abspath(".."))
 sys_path.insert(0, abspath("../pyDummy"))
-sys_path.insert(0, abspath("_extensions"))
+# sys_path.insert(0, abspath("_extensions"))
 
 
 # ==============================================================================
@@ -23,9 +23,11 @@ sys_path.insert(0, abspath("_extensions"))
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
-project = "Actions"
+githubNamespace = "pyTooling"
+githubProject = "Actions"
+project = "pyDummy"
 
-packageInformationFile = Path(f"../pyDummy/__init__.py")
+packageInformationFile = Path(f"../{project}/__init__.py")
 versionInformation = extractVersionInformation(packageInformationFile)
 
 author =    versionInformation.Author
@@ -60,10 +62,10 @@ pygments_style = "manni"
 # ==============================================================================
 # Restructured Text settings
 # ==============================================================================
-prologPath = "prolog.inc"
+prologPath = Path("prolog.inc")
 try:
-	with open(prologPath, "r") as prologFile:
-		rst_prolog = prologFile.read()
+	with prologPath.open("r", encoding="utf-8") as fileHandle:
+		rst_prolog = fileHandle.read()
 except Exception as ex:
 	print(f"[ERROR:] While reading '{prologPath}'.")
 	print(ex)
@@ -73,30 +75,15 @@ except Exception as ex:
 # ==============================================================================
 # Options for HTML output
 # ==============================================================================
-html_context = {}
-ctx = ROOT / "context.json"
-if ctx.is_file():
-	html_context.update(loads(ctx.open('r').read()))
-
-if (ROOT / "_theme").is_dir():
-	html_theme_path = ["."]
-	html_theme = "_theme"
-	html_theme_options = {
-		"logo_only": True,
-		"home_breadcrumbs": False,
-		"vcs_pageview_mode": 'blob',
-#		"body_max_width": None
-#		"navigation_depth": 5,
-	}
-elif find_spec("sphinx_rtd_theme") is not None:
-	html_theme = "sphinx_rtd_theme"
-	html_theme_options = {
-		"logo_only": True,
-		"vcs_pageview_mode": 'blob',
-#		"navigation_depth": 5,
-	}
-else:
-	html_theme = "alabaster"
+html_theme = "sphinx_rtd_theme"
+html_theme_options = {
+	"logo_only": True,
+	"vcs_pageview_mode": 'blob',
+	"navigation_depth": 5,
+}
+html_css_files = [
+	'css/override.css',
+]
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
@@ -107,7 +94,7 @@ html_logo = str(Path(html_static_path[0]) / "logo.png")
 html_favicon = str(Path(html_static_path[0]) / "icon.png")
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = "ActionsDoc"
+htmlhelp_basename = f"{githubProject}Doc"
 
 # If not None, a 'Last updated on:' timestamp is inserted at every page
 # bottom, using the given strftime format.
@@ -160,10 +147,10 @@ latex_elements = {
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
 	( master_doc,
-		"Actions.tex",
-		"The pyTooling Actions Documentation",
-		"Patrick Lehmann",
-		"manual"
+		f"{githubProject}.tex",
+		f"The {githubProject} Documentation",
+		f"Patrick Lehmann",
+		f"manual"
 	),
 ]
 
@@ -174,7 +161,6 @@ latex_documents = [
 extensions = [
 # Standard Sphinx extensions
 	"sphinx.ext.autodoc",
-	"sphinx.ext.coverage",
 	"sphinx.ext.extlinks",
 	"sphinx.ext.intersphinx",
 	"sphinx.ext.inheritance_diagram",
@@ -186,10 +172,12 @@ extensions = [
 # SphinxContrib extensions
 	"sphinxcontrib.mermaid",
 # Other extensions
-	"sphinx_fontawesome",
+	"sphinx_design",
+	"sphinx_copybutton",
 	"sphinx_autodoc_typehints",
-	"sphinx_inline_tabs",
 	"autoapi.sphinx",
+	"sphinx_reports",
+# User defined extensions
 ]
 
 
@@ -221,11 +209,11 @@ autodoc_typehints = "both"
 # Sphinx.Ext.ExtLinks
 # ==============================================================================
 extlinks = {
-	"gh":      ("https://GitHub.com/%s", "gh:%s"),
- 	"ghissue": ("https://GitHub.com/pyTooling/Actions/issues/%s", "issue #%s"),
- 	"ghpull":  ("https://GitHub.com/pyTooling/Actions/pull/%s", "pull request #%s"),
- 	"ghsrc":   ("https://GitHub.com/pyTooling/Actions/blob/main/%s", None),
- 	"wiki":    ("https://en.wikipedia.org/wiki/%s", None),
+	"gh":      (f"https://GitHub.com/%s", "gh:%s"),
+	"ghissue": (f"https://GitHub.com/{githubNamespace}/{githubProject}/issues/%s", "issue #%s"),
+	"ghpull":  (f"https://GitHub.com/{githubNamespace}/{githubProject}/pull/%s", "pull request #%s"),
+	"ghsrc":   (f"https://GitHub.com/{githubNamespace}/{githubProject}/blob/main/%s", None),
+	"wiki":    (f"https://en.wikipedia.org/wiki/%s", None),
 }
 
 
@@ -265,18 +253,53 @@ todo_link_only = True
 
 
 # ==============================================================================
-# Sphinx.Ext.Coverage
+# sphinx-reports
 # ==============================================================================
-coverage_show_missing_items = True
+# report_unittest_testsuites = {
+# 	"src": {
+# 		"name":        f"{project}",
+# 		"xml_report":  "../report/unit/unittest.xml",
+# 	}
+# }
+# report_codecov_packages = {
+# 	"src": {
+# 		"name":        f"{project}",
+# 		"json_report": "../report/coverage/coverage.json",
+# 		"fail_below":  80,
+# 		"levels":      "default"
+# 	}
+# }
+# report_doccov_packages = {
+# 	"src": {
+# 		"name":       f"{project}",
+# 		"directory":  f"../{project}",
+# 		"fail_below": 80,
+# 		"levels":     "default"
+# 	}
+# }
+
+
+# ==============================================================================
+# Sphinx_Design
+# ==============================================================================
+# sd_fontawesome_latex = True
 
 
 # ==============================================================================
 # AutoAPI.Sphinx
 # ==============================================================================
 autoapi_modules = {
-	"pyDummy":  {
-		"template": "module",
-		"output": "pyDummy",
+	f"{project}":  {
+		"template": "package",
+		"output":   project,
 		"override": True
 	}
 }
+
+for directory in [mod for mod in Path(f"../{project}").iterdir() if mod.is_dir() and mod.name != "__pycache__"]:
+	print(f"Adding module rule for '{project}.{directory.name}'")
+	autoapi_modules[f"{project}.{directory.name}"] = {
+		"template": "module",
+		"output":   project,
+		"override": True
+	}

doc/coverage/index.rst

@@ -3,5 +3,5 @@ Code Coverage Report
 
 Code coverage report generated with `pytest <https://github.com/pytest-dev/pytest>`__ and `Coverage.py <https://github.com/nedbat/coveragepy/tree/master>`__.
 
-.. report:code-coverage::
+.. #report:code-coverage::
    :packageid: src

doc/index.rst

@@ -100,6 +100,9 @@ References
 
 - `hdl/containers#48 <https://github.com/hdl/containers/issues/48>`__
 
+
+.. _CONTRIBUTORS:
+
 Contributors
 ************
 
@@ -108,6 +111,8 @@ Contributors
 * `and more... <https://GitHub.com/pyTooling/Actions/graphs/contributors>`__
 
 
+.. _LICENSE:
+
 License
 *******
 

doc/requirements.txt

@@ -1,20 +1,19 @@
 -r ../requirements.txt
 
-pyTooling ~= 6.1
+pyTooling ~= 8.4
 
 # Enforce latest version on ReadTheDocs
-sphinx ~= 7.2
-docutils ~= 0.18.0
+sphinx ~= 8.2
+docutils ~= 0.21
+docutils_stubs ~= 0.0.22
+
+# ReadTheDocs Theme
+sphinx_rtd_theme ~= 3.0
 
 # Sphinx Extenstions
-#sphinx.ext.coverage
-#sphinxcontrib-actdiag>=0.8.5
-sphinxcontrib-mermaid>=0.9.2
-#sphinxcontrib-seqdiag>=0.8.5
-#sphinxcontrib-textstyle>=0.2.1
-#sphinxcontrib-spelling>=2.2.0
+sphinxcontrib-mermaid ~= 1.0
 autoapi >= 2.0.1
-sphinx_fontawesome >= 0.0.6
-sphinx-inline-tabs >= 2023.4.21
-sphinx_autodoc_typehints >= 1.24.0
-# changelog>=0.3.5
+sphinx_design ~= 0.6.1
+sphinx-copybutton >= 0.5.2
+sphinx_autodoc_typehints ~= 3.1
+sphinx_reports ~= 0.7

doc/shields.inc

@@ -4,21 +4,21 @@
    # percent encoding so that the URL is properly parsed.
 
 .. # Sourcecode link to GitHub
-.. |SHIELD:svg:pyTooling-github| image:: https://img.shields.io/badge/pyTooling-Actions-63bf7f.svg?longCache=true&style=flat-square&longCache=true&logo=GitHub
+.. |SHIELD:svg:pyTooling-github| image:: https://img.shields.io/badge/pyTooling-Actions-63bf7f?longCache=true&style=flat-square&longCache=true&logo=GitHub
    :alt: Sourcecode on GitHub
    :height: 22
-   :target: https://GitHub.com/pyTooling/pyTooling
-.. |SHIELD:png:pyTooling-github| image:: https://raster.shields.io/badge/pyTooling-Actions-63bf7f.svg?longCache=true&style=flat-square&longCache=true&logo=GitHub
+   :target: https://GitHub.com/pyTooling/Actions
+.. |SHIELD:png:pyTooling-github| image:: https://raster.shields.io/badge/pyTooling-Actions-63bf7f?longCache=true&style=flat-square&longCache=true&logo=GitHub
    :alt: Sourcecode on GitHub
    :height: 22
-   :target: https://GitHub.com/pyTooling/pyTooling
+   :target: https://GitHub.com/pyTooling/Actions
 
 .. # Sourcecode license
 .. |SHIELD:svg:pyTooling-src-license| image:: https://img.shields.io/pypi/l/pyTooling?longCache=true&style=flat-square&logo=Apache&label=code
    :alt: Code license
    :height: 22
    :target: Code-License.html
-.. |SHIELD:png:pyTooling-src-license| image:: https://img.shields.io/pypi/l/pyTooling?longCache=true&style=flat-square&logo=Apache&label=code
+.. |SHIELD:png:pyTooling-src-license| image:: https://raster.shields.io/pypi/l/pyTooling?longCache=true&style=flat-square&logo=Apache&label=code
    :alt: Code license
    :height: 22
    :target: https://GitHub.com/pyTooling/Actions/blob/main/LICENSE.md
@@ -64,11 +64,11 @@
    :target: https://pyTooling.github.io/pyTooling/
 
 .. # Gitter
-.. |SHIELD:svg:pyTooling-gitter| image:: https://img.shields.io/badge/chat-on%20gitter-4db797.svg?longCache=true&style=flat-square&logo=gitter&logoColor=e8ecef
+.. |SHIELD:svg:pyTooling-gitter| image:: https://img.shields.io/badge/chat-on%20gitter-4db797?longCache=true&style=flat-square&logo=gitter&logoColor=e8ecef
    :alt: Documentation License
    :height: 22
    :target: https://gitter.im/hdl/community
-.. |SHIELD:png:pyTooling-gitter| image:: https://raster.shields.io/badge/chat-on%20gitter-4db797.svg?longCache=true&style=flat-square&logo=gitter&logoColor=e8ecef
+.. |SHIELD:png:pyTooling-gitter| image:: https://raster.shields.io/badge/chat-on%20gitter-4db797?longCache=true&style=flat-square&logo=gitter&logoColor=e8ecef
    :alt: Documentation License
    :height: 22
    :target: https://gitter.im/hdl/community

doc/unittests/index.rst

@@ -3,5 +3,5 @@ Unittest Summary Report
 
 Unittest report generated with `pytest <https://github.com/pytest-dev/pytest>`__.
 
-.. report:unittest-summary::
+.. #report:unittest-summary::
    :reportid: src

pyDummy/__init__.py

@@ -11,7 +11,7 @@
 #                                                                                                                      #
 # License:                                                                                                             #
 # ==================================================================================================================== #
-# Copyright 2017-2024 Patrick Lehmann - Bötzingen, Germany                                                             #
+# Copyright 2017-2025 Patrick Lehmann - Bötzingen, Germany                                                             #
 #                                                                                                                      #
 # Licensed under the Apache License, Version 2.0 (the "License");                                                      #
 # you may not use this file except in compliance with the License.                                                     #
@@ -34,7 +34,7 @@ A module for a set of dummy classes.
 
 __author__ =        "Patrick Lehmann"
 __email__ =         "Paebbels@gmail.com"
-__copyright__ =     "2017-2024, Patrick Lehmann"
+__copyright__ =     "2017-2025, Patrick Lehmann"
 __license__ =       "Apache License, Version 2.0"
 __version__ =       "0.4.4"
 __keywords__ =      ["GitHub Actions"]

pyExamples/Extensions/__init__.py

@@ -0,0 +1,101 @@
+# ==================================================================================================================== #
+#             _____           _ _                  _        _   _                                                      #
+#  _ __  _   |_   _|__   ___ | (_)_ __   __ _     / \   ___| |_(_) ___  _ __  ___                                      #
+# | '_ \| | | || |/ _ \ / _ \| | | '_ \ / _` |   / _ \ / __| __| |/ _ \| '_ \/ __|                                     #
+# | |_) | |_| || | (_) | (_) | | | | | | (_| |_ / ___ \ (__| |_| | (_) | | | \__ \                                     #
+# | .__/ \__, ||_|\___/ \___/|_|_|_| |_|\__, (_)_/   \_\___|\__|_|\___/|_| |_|___/                                     #
+# |_|    |___/                          |___/                                                                          #
+# ==================================================================================================================== #
+# Authors:                                                                                                             #
+#   Patrick Lehmann                                                                                                    #
+#                                                                                                                      #
+# License:                                                                                                             #
+# ==================================================================================================================== #
+# Copyright 2017-2025 Patrick Lehmann - Bötzingen, Germany                                                             #
+#                                                                                                                      #
+# Licensed under the Apache License, Version 2.0 (the "License");                                                      #
+# you may not use this file except in compliance with the License.                                                     #
+# You may obtain a copy of the License at                                                                              #
+#                                                                                                                      #
+#   http://www.apache.org/licenses/LICENSE-2.0                                                                         #
+#                                                                                                                      #
+# Unless required by applicable law or agreed to in writing, software                                                  #
+# distributed under the License is distributed on an "AS IS" BASIS,                                                    #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.                                             #
+# See the License for the specific language governing permissions and                                                  #
+# limitations under the License.                                                                                       #
+#                                                                                                                      #
+# SPDX-License-Identifier: Apache-2.0                                                                                  #
+# ==================================================================================================================== #
+#
+"""
+A module for a set of dummy classes.
+"""
+
+__author__ =        "Patrick Lehmann"
+__email__ =         "Paebbels@gmail.com"
+__copyright__ =     "2017-2025, Patrick Lehmann"
+__license__ =       "Apache License, Version 2.0"
+__version__ =       "0.14.8"
+__keywords__ =      ["GitHub Actions"]
+__issue_tracker__ = "https://GitHub.com/pyTooling/Actions/issues"
+
+from pyTooling.Decorators import export, readonly
+from pyTooling.Platform   import Platform
+
+
+@export
+class Base:
+	"""
+	A base-class for dummy applications.
+	"""
+
+	_value: int    #: An internal value.
+
+	def __init__(self) -> None:
+		"""
+		Initializes the base-class.
+		"""
+		self._value = 0
+
+	@readonly
+	def Value(self) -> int:
+		"""
+		Read-only property to return the internal value.
+
+		:return: Internal value.
+		"""
+		return self._value
+
+
+@export
+class Application(Base):
+	"""
+	A dummy application for demonstration purposes.
+	"""
+
+	def __init__(self) -> None:
+		"""
+		Initializes the dummy application.
+		"""
+		super().__init__()
+
+		platform = Platform()
+		if platform.IsNativeLinux:
+			self._value += 1
+		elif platform.IsNativeMacOS:
+			self._value += 2
+		elif platform.IsNativeWindows:
+			self._value += 3
+		elif platform.IsMSYSOnWindows:
+			self._value += 11
+		elif platform.IsMinGW32OnWindows:
+			self._value += 12
+		elif platform.IsMinGW64OnWindows:
+			self._value += 13
+		elif platform.IsUCRT64OnWindows:
+			self._value += 14
+		elif platform.IsClang32OnWindows:
+			self._value += 15
+		elif platform.IsClang64OnWindows:
+			self._value += 16

pyproject.toml

@@ -1,8 +1,8 @@
 [build-system]
 requires = [
-  "setuptools >= 69.0.0",
-  "wheel >= 0.40.0",
-  "pyTooling ~= 6.1"
+  "setuptools ~= 78.1",
+  "wheel ~= 0.45",
+  "pyTooling ~= 8.4"
 ]
 build-backend = "setuptools.build_meta"
 
@@ -20,7 +20,14 @@ show_error_codes = true
 namespace_packages = true
 html_report = "report/typing"
 
+[tool.pytest]
+junit_xml = "report/unit/UnittestReportSummary.xml"
+
+[tool.pyedaa-reports]
+junit_xml = "report/unit/unittest.xml"
+
 [tool.pytest.ini_options]
+addopts = "--tb=native"
 # Don't set 'python_classes = *' otherwise, pytest doesn't search for classes
 # derived from unittest.Testcase
 python_files = "*"
@@ -29,6 +36,7 @@ filterwarnings = [
 	"error::DeprecationWarning",
 	"error::PendingDeprecationWarning"
 ]
+junit_logging = "all"
 
 [tool.interrogate]
 color = true

releaser/Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.9-slim-bullseye
+FROM python:3.12-slim-bookworm
 COPY releaser.py /releaser.py
 RUN pip install PyGithub --progress-bar off \
   && apt update -qq \

releaser/README.md

@@ -75,7 +75,7 @@ on:
 
 jobs:
   mwe:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
 
     # Clone repository
@@ -156,7 +156,7 @@ For prototyping purposes, the following job might be useful:
 ```yml
   Release:
     name: '📦 Release'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     needs:
       - ...
     if: github.event_name != 'pull_request' && (github.ref == 'refs/heads/master' || contains(github.ref, 'refs/tags/'))

releaser/composite/action.yml

@@ -45,7 +45,9 @@ runs:
   steps:
 
   - shell: bash
-    run: pip install --disable-pip-version-check PyGithub --progress-bar off
+    run: |
+      [ "$(source /etc/os-release && echo $VERSION_ID)" == "24.04" ] && UBUNTU_2404_ARGS='--break-system-packages' || unset UBUNTU_2404_ARGS
+      pip install --disable-pip-version-check --progress-bar off $UBUNTU_2404_ARGS PyGithub
 
   - shell: bash
     run: '''${{ github.action_path }}/../releaser.py'''

releaser/releaser.py

@@ -5,7 +5,7 @@
 #   Unai Martinez-Corral                                                                                               #
 #                                                                                                                      #
 # ==================================================================================================================== #
-# Copyright 2020-2024 The pyTooling Authors                                                                            #
+# Copyright 2020-2025 The pyTooling Authors                                                                            #
 #                                                                                                                      #
 # Licensed under the Apache License, Version 2.0 (the "License");                                                      #
 # you may not use this file except in compliance with the License.                                                     #

requirements.txt

@@ -1 +1 @@
-pyTooling ~= 6.1
+pyTooling ~= 8.4

run.ps1

@@ -0,0 +1,316 @@
+[CmdletBinding()]
+Param(
+	# Clean up all files and directories
+	[switch]$clean,
+
+  # Commands
+  [switch]$all,
+  [switch]$copyall,
+
+  [switch]$doc,
+  [switch]$livedoc,
+  [switch]$doccov,
+
+  [switch]$unit,
+  [switch]$liveunit,
+  [switch]$copyunit,
+
+  [switch]$cov,
+  [switch]$livecov,
+  [switch]$copycov,
+
+  [switch]$type,
+  [switch]$livetype,
+  [switch]$copytype,
+
+  [switch]$nooutput,
+
+  [switch]$build,
+  [switch]$install,
+
+	# Display this help"
+	[switch]$help
+)
+
+$PackageName = "Actions"
+
+# set default values
+$EnableDebug =        [bool]$PSCmdlet.MyInvocation.BoundParameters["Debug"]
+$EnableVerbose =      [bool]$PSCmdlet.MyInvocation.BoundParameters["Verbose"] -or $EnableDebug
+
+# Display help if no command was selected
+$help = $help -or ( -not(
+  $all -or $copyall -or
+    $clean -or
+    $doc -or $livedoc -or $doccov -or
+    $unit -or $liveunit -or $copyunit -or
+    $cov -or $livecov -or $copycov -or
+    $type -or $livetype -or $copytype -or
+    $build -or $install
+  )
+)
+
+Write-Host "================================================================================" -ForegroundColor Magenta
+Write-Host "$PackageName Documentation Compilation and Assembly Tool"                         -ForegroundColor Magenta
+Write-Host "================================================================================" -ForegroundColor Magenta
+
+if ($help)
+{	Get-Help $MYINVOCATION.MyCommand.Path -Detailed
+	exit 0
+}
+
+if ($all)
+{	$doc =      $true
+	$unit =     $true
+#	$copyunit = $true
+	$cov =      $true
+#	$copycov =  $true
+	$type =     $true
+	$copytype = $true
+}
+if ($copyall)
+{# $copyunit = $true
+#  $copycov =  $true
+  $copytype = $true
+}
+
+if ($clean)
+{ Write-Host -ForegroundColor DarkYellow    "[live][DOC]        Cleaning documentation directories ..."
+  rm -Force .\doc\$PackageName\*
+  .\doc\make.bat clean
+  Write-Host -ForegroundColor DarkYellow   "[live][BUILD]      Cleaning build directories ..."
+  rm -Force .\build\bdist.win-amd64
+  rm -Force .\build\lib
+}
+
+if ($build)
+{ Write-Host -ForegroundColor Yellow        "[live][BUILD]      Cleaning build directories ..."
+  rm -Force .\build\bdist.win-amd64
+  rm -Force .\build\lib
+  Write-Host -ForegroundColor Yellow        "[live][BUILD]      Building $PackageName package as wheel ..."
+  py -3.13 -m build --wheel
+
+  Write-Host -ForegroundColor Yellow        "[live][BUILD]      Building wheel finished"
+}
+if ($install)
+{ if (!([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator"))
+  { Write-Host -ForegroundColor Yellow      "[live][INSTALL]    Installing $PackageName with administrator rights ..."
+    $proc = Start-Process pwsh.exe "-NoProfile -ExecutionPolicy Bypass -WorkingDirectory `"$PSScriptRoot`" -File `"$PSCommandPath`" `"-install`"" -Verb RunAs -Wait
+
+#    Write-Host -ForegroundColor Yellow   "[live][INSTALL]    Wait on administrator console ..."
+#    Wait-Process -Id $proc.Id
+  }
+  else
+  { Write-Host -ForegroundColor Cyan        "[ADMIN][UNINSTALL] Uninstalling $PackageName ..."
+    py -3.13 -m pip uninstall -y $PackageName
+    Write-Host -ForegroundColor Cyan        "[ADMIN][INSTALL]   Installing $PackageName from wheel ..."
+    py -3.13 -m pip install .\dist\$PackageName-8.1.0-py3-none-any.whl
+
+    Write-Host -ForegroundColor Cyan        "[ADMIN][INSTALL]   Closing window in 5 seconds ..."
+    Start-Sleep -Seconds 5
+  }
+}
+
+$jobs = @()
+
+if ($livedoc)
+{ Write-Host -ForegroundColor DarkYellow    "[live][DOC]       Building documentation using Sphinx ..."
+
+  .\doc\make.bat html --verbose
+
+  Write-Host -ForegroundColor DarkYellow    "[live][DOC]       Documentation finished"
+}
+elseif ($doc)
+{ Write-Host -ForegroundColor DarkYellow    "[Job1][DOC]       Building documentation using Sphinx ..."
+  Write-Host -ForegroundColor DarkGreen     "[SCRIPT]          Starting Documentation job ..."
+
+  # Compile documentation
+  $compileDocFunc = {
+    .\doc\make.bat html --verbose
+  }
+  $docJob = Start-Job -Name "Documentation" -ScriptBlock $compileDocFunc
+#  $jobs += $docJob
+}
+
+
+if ($doccov)
+{
+  .\doc\make.bat coverage
+}
+
+if ($liveunit)
+{ Write-Host -ForegroundColor DarkYellow    "[live][UNIT]      Running Unit Tests using pytest ..."
+
+  $env:ENVIRONMENT_NAME = "Windows (x86-64)"
+  pytest -raP --color=yes --junitxml=report/unit/unittest.xml --template=html1/index.html --report=report/unit/html/index.html --split-report tests/unit
+
+  if ($copyunit)
+  { cp -Recurse -Force .\report\unit\html\* .\doc\_build\html\unittests
+    Write-Host -ForegroundColor DarkBlue    "[live][UNIT]      Copyed unit testing report to 'unittests' directory in HTML directory"
+  }
+
+  Write-Host -ForegroundColor DarkYellow    "[live][UNIT]      Unit Tests finished"
+}
+elseif ($unit)
+{ Write-Host -ForegroundColor DarkYellow    "[Job2][UNIT]      Running Unit Tests using pytest ..."
+  Write-Host -ForegroundColor DarkGreen     "[SCRIPT]          Starting UnitTests jobs ..."
+
+  # Run unit tests
+  $runUnitFunc = {
+    $env:ENVIRONMENT_NAME = "Windows (x86-64)"
+    pytest -raP --color=yes --junitxml=report/unit/unittest.xml --template=html1/index.html --report=report/unit/html/index.html --split-report tests/unit
+  }
+  $unitJob = Start-Job -Name "UnitTests" -ScriptBlock $runUnitFunc
+  $jobs += $unitJob
+}
+
+if ($livecov)
+{ Write-Host -ForegroundColor DarkMagenta   "[live][COV]       Running Unit Tests with coverage ..."
+
+  $env:ENVIRONMENT_NAME = "Windows (x86-64)"
+  coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -ra --tb=line --color=yes tests/unit
+
+  Write-Host -ForegroundColor DarkMagenta   "[live][COV]       Convert coverage report to HTML ..."
+  coverage html
+
+  Write-Host -ForegroundColor DarkMagenta   "[live][COV]       Convert coverage report to XML (Cobertura) ..."
+  coverage xml
+
+  Write-Host -ForegroundColor DarkMagenta   "[live][COV]       Convert coverage report to JSON ..."
+  coverage json
+
+  Write-Host -ForegroundColor DarkMagenta   "[live][COV]       Write coverage report to console ..."
+  coverage report
+
+  if ($copycov)
+  { cp -Recurse -Force .\report\coverage\html\* .\doc\_build\html\coverage
+    Write-Host -ForegroundColor DarkMagenta "[live][COV]       Copyed code coverage report to 'coverage' directory in HTML directory"
+  }
+
+  Write-Host -ForegroundColor DarkMagenta   "[live][COV]       Coverage finished"
+}
+elseif ($cov)
+{ Write-Host -ForegroundColor DarkMagenta   "[live][COV]       Running Unit Tests with coverage ..."
+  Write-Host -ForegroundColor DarkMagenta   "[SCRIPT]          Starting Coverage jobs ..."
+
+  # Collect coverage
+  $collectCovFunc = {
+    $env:ENVIRONMENT_NAME = "Windows (x86-64)"
+    coverage run --data-file=.coverage --rcfile=pyproject.toml -m pytest -ra --tb=line --color=yes tests/unit
+
+    Write-Host -ForegroundColor DarkMagenta "[Job3][COV]       Convert coverage report to HTML ..."
+    coverage html
+
+    Write-Host -ForegroundColor DarkMagenta "[Job3][COV]       Convert coverage report to XML (Cobertura) ..."
+    coverage xml
+
+    Write-Host -ForegroundColor DarkMagenta "[Job3][COV]       Convert coverage report to JSON ..."
+    coverage json
+  }
+  $covJob = Start-Job -Name "Coverage" -ScriptBlock $collectCovFunc
+  $jobs += $covJob
+}
+
+if ($livetype)
+{ Write-Host -ForegroundColor DarkCyan      "[live][TYPE]      Running static type analysis using mypy ..."
+
+  $env:MYPY_FORCE_COLOR = 1
+  mypy.exe -p $PackageName
+
+  if ($copytype)
+  { cp -Recurse -Force .\report\typing\* .\doc\_build\html\typing
+    Write-Host -ForegroundColor DarkCyan    "[live][TYPE]      Copyed typing report to 'typing' directory in HTML directory."
+  }
+
+  Write-Host -ForegroundColor DarkCyan      "[live][TYPE]      Static type analysis finished"
+}
+elseif ($type)
+{ Write-Host -ForegroundColor DarkCyan      "[live][TYPE]      Running static type analysis using mypy ..."
+  Write-Host -ForegroundColor DarkCyan      "[SCRIPT]          Starting Typing jobs ..."
+
+  # Analyze types
+  $analyzeTypesFunc = {
+    $env:MYPY_FORCE_COLOR = 1
+    mypy.exe -p $PackageName
+  }
+  $typeJob = Start-Job -Name "Typing" -ScriptBlock $analyzeTypesFunc
+  $jobs += $typeJob
+}
+
+
+if ($doc)
+{ Write-Host -ForegroundColor DarkGreen     "[SCRIPT]          Waiting on Documentation job ..."
+  Wait-Job -Job $docJob
+  Write-Host -ForegroundColor DarkYellow    "[Job1][DOC]       Documentation finished"
+}
+if ($jobs.Count -ne 0)
+{
+  Write-Host -ForegroundColor DarkGreen (   "[SCRIPT]          Waiting on {0} jobs ({1}) ..." -f $jobs.Count, (($jobs | %{ $_.Name }) -join ", "))
+  Wait-Job -Job $jobs
+}
+
+
+if (-not $liveunit -and $copyunit)
+{
+#  if ($unit)
+#  { Wait-Job -Job $unitJob
+#    Write-Host -ForegroundColor DarkBlue "[Job2][UNIT] Unit tests finished"
+#  }
+  cp -Recurse -Force .\report\unit\html\* .\doc\_build\html\unittests
+  Write-Host -ForegroundColor DarkBlue      "[post][UNIT]      Copyed unit testing report to 'unittests' directory in HTML directory"
+}
+if (-not ($livecov -or $cov) -and $copycov)
+{
+#  if ($cov)
+#  { Wait-Job -Job $unitJob
+#    Write-Host -ForegroundColor DarkMagenta "[Job3][UNIT] Coverage collection finished"
+#  }
+  cp -Recurse -Force .\report\coverage\html\* .\doc\_build\html\coverage
+  Write-Host -ForegroundColor DarkMagenta   "[post][COV]       Copyed code coverage report to 'coverage' directory in HTML directory"
+}
+if (-not $livetype -and $copytype)
+{
+#  if ($type)
+#  { Wait-Job -Job $typeJob
+#    Write-Host -ForegroundColor DarkCyan "[Job4][UNIT] Static type analysis finished"
+#  }
+  cp -Recurse -Force .\report\typing\* .\doc\_build\html\typing
+  Write-Host -ForegroundColor DarkCyan      "[post][TYPE]      Copyed typing report to 'typing' directory in HTML directory."
+}
+
+
+if ($type)
+{ Write-Host -ForegroundColor DarkCyan      "================================================================================"
+  if (-not $nooutput)
+  { Receive-Job -Job $typeJob
+  }
+  Remove-Job  -Job $typeJob
+}
+if ($doc)
+{ Write-Host -ForegroundColor DarkYellow    "================================================================================"
+  if (-not $nooutput)
+  { Receive-Job -Job $docJob
+  }
+  Remove-Job  -Job $docJob
+}
+if ($unit)
+{ Write-Host -ForegroundColor DarkBlue      "================================================================================"
+  if (-not $nooutput)
+  { Receive-Job -Job $unitJob
+  }
+  Remove-Job  -Job $unitJob
+}
+if ($cov)
+{ Write-Host -ForegroundColor DarkMagenta   "================================================================================"
+  if (-not $nooutput)
+  { Receive-Job -Job $covJob
+  }
+  Remove-Job  -Job $covJob
+
+  if ($copycov)
+  { cp -Recurse -Force .\report\coverage\html\* .\doc\_build\html\coverage
+    Write-Host -ForegroundColor DarkMagenta "[post][COV]       Copyed code coverage report to 'coverage' directory in HTML directory"
+  }
+}
+Write-Host -ForegroundColor DarkGreen       "================================================================================"
+Write-Host -ForegroundColor DarkGreen       "[SCRIPT]          Finished"

setup.py

@@ -11,7 +11,7 @@
 #                                                                                                                      #
 # License:                                                                                                             #
 # ==================================================================================================================== #
-# Copyright 2017-2024 Patrick Lehmann - Bötzingen, Germany                                                             #
+# Copyright 2017-2025 Patrick Lehmann - Bötzingen, Germany                                                             #
 #                                                                                                                      #
 # Licensed under the Apache License, Version 2.0 (the "License");                                                      #
 # you may not use this file except in compliance with the License.                                                     #

tests/pacman_packages.py

@@ -0,0 +1,91 @@
+from os import getenv
+from pathlib import Path
+from re import compile
+from sys import version
+
+print(f"Python: {version}")
+
+
+def loadRequirementsFile(requirementsFile: Path):
+	requirements = []
+	with requirementsFile.open("r", encoding="utf-8") as file:
+		for line in file.readlines():
+			line = line.strip()
+			if line.startswith("#") or line.startswith("https") or line == "":
+				continue
+			elif line.startswith("-r"):
+				# Remove the first word/argument (-r)
+				requirements += loadRequirementsFile(requirementsFile.parent / line[2:].lstrip())
+			else:
+				requirements.append(line)
+
+	return requirements
+
+
+requirements = "-r ../tests/requirements.txt"
+if requirements.startswith("-r"):
+	requirementsFile = Path(requirements[2:].lstrip())
+	try:
+		dependencies = loadRequirementsFile(requirementsFile)
+	except FileNotFoundError as ex:
+		print(f"::error title=FileNotFound::{ex}")
+		exit(1)
+else:
+	dependencies = [req.strip() for req in requirements.split(" ")]
+
+packages = {
+	"coverage": "python-coverage:p",
+	"igraph": "igraph:p",
+	"jinja2": "python-markupsafe:p",
+	"lxml": "python-lxml:p",
+	"numpy": "python-numpy:p",
+	"markupsafe": "python-markupsafe:p",
+	"pip": "python-pip:p",
+	"ruamel.yaml": "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
+	"sphinx": "python-markupsafe:p",
+	"tomli": "python-tomli:p",
+	"wheel": "python-wheel:p",
+	"pyEDAA.ProjectModel": "python-ruamel-yaml:p python-ruamel.yaml.clib:p python-lxml:p",
+	"pyEDAA.Reports": "python-ruamel-yaml:p python-ruamel.yaml.clib:p python-lxml:p",
+}
+subPackages = {
+	"pytooling": {
+		"yaml": "python-ruamel-yaml:p python-ruamel.yaml.clib:p",
+	},
+}
+
+regExp = compile(
+	r"(?P<PackageName>[\w_\-\.]+)(?:\[(?P<SubPackages>(?:\w+)(?:\s*,\s*\w+)*)\])?(?:\s*(?P<Comperator>[<>~=]+)\s*)(?P<Version>\d+(?:\.\d+)*)(?:-(?P<VersionExtension>\w+))?")
+
+pacboyPackages = set(("python-pip:p", "python-wheel:p", "python-tomli:p"))
+print(f"Processing dependencies ({len(dependencies)}):")
+for dependency in dependencies:
+	print(f"  {dependency}")
+
+	match = regExp.match(dependency.lower())
+	if not match:
+		print(f"    Wrong format: {dependency}")
+		print(f"::error title=Identifying Pacboy Packages::Unrecognized dependency format '{dependency}'")
+		continue
+
+	package = match["PackageName"]
+	if package in packages:
+		rewrite = packages[package]
+		print(f"    Found rewrite rule for '{package}': {rewrite}")
+		pacboyPackages.add(rewrite)
+
+	if match["SubPackages"] and package in subPackages:
+		for subPackage in match["SubPackages"].split(","):
+			if subPackage in subPackages[package]:
+				rewrite = subPackages[package][subPackage]
+				print(f"    Found rewrite rule for '{package}[..., {subPackage}, ...]': {rewrite}")
+				pacboyPackages.add(rewrite)
+
+# Write jobs to special file
+github_output = Path(getenv("GITHUB_OUTPUT"))
+print(f"GITHUB_OUTPUT: {github_output}")
+with github_output.open("a+", encoding="utf-8") as f:
+	f.write(f"pacboy_packages={' '.join(pacboyPackages)}\n")
+
+print(f"GITHUB_OUTPUT:")
+print(f"pacboy_packages={' '.join(pacboyPackages)}\n")

tests/platform/Specific.py

@@ -11,7 +11,7 @@
 #                                                                                                                      #
 # License:                                                                                                             #
 # ==================================================================================================================== #
-# Copyright 2017-2024 Patrick Lehmann - Bötzingen, Germany                                                             #
+# Copyright 2017-2025 Patrick Lehmann - Bötzingen, Germany                                                             #
 #                                                                                                                      #
 # Licensed under the Apache License, Version 2.0 (the "License");                                                      #
 # you may not use this file except in compliance with the License.                                                     #
@@ -28,12 +28,12 @@
 # SPDX-License-Identifier: Apache-2.0                                                                                  #
 # ==================================================================================================================== #
 #
-from unittest         import TestCase
+from unittest           import TestCase
 
-from pytest           import mark
-from pyTooling.Common import CurrentPlatform
+from pytest             import mark
+from pyTooling.Platform import CurrentPlatform
 
-from pyDummy          import Application
+from pyDummy            import Application
 
 
 if __name__ == "__main__":  # pragma: no cover

tests/python_jobs.py

@@ -0,0 +1,216 @@
+from json import dumps as json_dumps
+from os import getenv
+from pathlib import Path
+from textwrap import dedent
+from typing import Iterable
+
+name = "example".strip()
+python_version = "3.12".strip()
+systems = "ubuntu windows macos-arm mingw64 ucrt64".strip()
+versions = "3.8 3.9 3.10 3.11 3.12".strip()
+include_list = "".strip()
+exclude_list = "".strip()
+disable_list = "".strip()
+
+currentMSYS2Version = "3.11"
+currentAlphaVersion = "3.13"
+currentAlphaRelease = "3.13.0-alpha.1"
+
+if systems == "":
+	print("::error title=Parameter::system_list is empty.")
+else:
+	systems = [sys.strip() for sys in systems.split(" ")]
+
+if versions == "":
+	versions = [python_version]
+else:
+	versions = [ver.strip() for ver in versions.split(" ")]
+
+if include_list == "":
+	includes = []
+else:
+	includes = [tuple(include.strip().split(":")) for include in include_list.split(" ")]
+
+if exclude_list == "":
+	excludes = []
+else:
+	excludes = [exclude.strip() for exclude in exclude_list.split(" ")]
+
+if disable_list == "":
+	disabled = []
+else:
+	disabled = [disable.strip() for disable in disable_list.split(" ")]
+
+if "3.7" in versions:
+	print("::warning title=Deprecated::Support for Python 3.7 ended in 2023.06.27.")
+if "msys2" in systems:
+	print("::warning title=Deprecated::System 'msys2' will be replaced by 'mingw64'.")
+if currentAlphaVersion in versions:
+	print(f"::notice title=Experimental::Python {currentAlphaVersion} ({currentAlphaRelease}) is a pre-release.")
+for disable in disabled:
+	print(f"::warning title=Disabled Python Job::System '{disable}' temporarily disabled.")
+
+# see https://raw.githubusercontent.com/actions/python-versions/main/versions-manifest.json
+data = {
+	# Python and PyPy versions supported by "setup-python" action
+	"python": {
+		"3.7": {"icon": "⚫", "until": "2023.06.27"},
+		"3.8": {"icon": "🔴", "until": "2024.10"},
+		"3.9": {"icon": "🟠", "until": "2025.10"},
+		"3.10": {"icon": "🟡", "until": "2026.10"},
+		"3.11": {"icon": "🟢", "until": "2027.10"},
+		"3.12": {"icon": "🟢", "until": "2028.10"},
+		#  "3.13":      { "icon": "🟣",  "until": "2028.10" },
+		"pypy-3.7": {"icon": "⟲⚫", "until": "????.??"},
+		"pypy-3.8": {"icon": "⟲🔴", "until": "????.??"},
+		"pypy-3.9": {"icon": "⟲🟠", "until": "????.??"},
+		"pypy-3.10": {"icon": "⟲🟡", "until": "????.??"},
+	},
+	# Runner systems (runner images) supported by GitHub Actions
+	"sys": {
+		"ubuntu": {"icon": "🐧", "runs-on": "ubuntu-24.04", "shell": "bash", "name": "Linux (x86-64)"},
+		"windows": {"icon": "🪟", "runs-on": "windows-latest", "shell": "pwsh", "name": "Windows (x86-64)"},
+		"macos": {"icon": "🍎", "runs-on": "macos-latest-large", "shell": "bash", "name": "macOS (x86-64)"},
+		"macos-arm": {"icon": "🍏", "runs-on": "macos-latest", "shell": "bash", "name": "macOS (aarch64)"},
+	},
+	# Runtimes provided by MSYS2
+	"runtime": {
+		"msys": {"icon": "🪟🟪", "name": "Windows+MSYS2 (x86-64) - MSYS"},
+		"mingw32": {"icon": "🪟⬛", "name": "Windows+MSYS2 (x86-64) - MinGW32"},
+		"mingw64": {"icon": "🪟🟦", "name": "Windows+MSYS2 (x86-64) - MinGW64"},
+		"clang32": {"icon": "🪟🟫", "name": "Windows+MSYS2 (x86-64) - Clang32"},
+		"clang64": {"icon": "🪟🟧", "name": "Windows+MSYS2 (x86-64) - Clang64"},
+		"ucrt64": {"icon": "🪟🟨", "name": "Windows+MSYS2 (x86-64) - UCRT64"},
+	}
+}
+
+print(f"includes ({len(includes)}):")
+for system, version in includes:
+	print(f"- {system}:{version}")
+print(f"excludes ({len(excludes)}):")
+for exclude in excludes:
+	print(f"- {exclude}")
+print(f"disabled ({len(disabled)}):")
+for disable in disabled:
+	print(f"- {disable}")
+
+
+def match(combination: str, pattern: str) -> bool:
+	system, version = combination.split(":")
+	sys, ver = pattern.split(":")
+
+	if sys == "*":
+		return (ver == "*") or (version == ver)
+	elif system == sys:
+		return (ver == "*") or (version == ver)
+	else:
+		return False
+
+
+def notIn(combination: str, patterns: Iterable[str]) -> bool:
+	for pattern in patterns:
+		if match(combination, pattern):
+			return False
+
+	return True
+
+combinations = [
+								 (system, version)
+								 for system in systems
+								 if system in data["sys"]
+								 for version in versions
+								 if version in data["python"]
+										and notIn(f"{system}:{version}", excludes)
+										and notIn(f"{system}:{version}", disabled)
+							 ] + [
+								 (system, currentMSYS2Version)
+								 for system in systems
+								 if system in data["runtime"]
+										and notIn(f"{system}:{currentMSYS2Version}", excludes)
+										and notIn(f"{system}:{currentMSYS2Version}", disabled)
+							 ] + [
+								 (system, version)
+								 for system, version in includes
+								 if system in data["sys"]
+										and version in data["python"]
+										and notIn(f"{system}:{version}", disabled)
+							 ]
+print(f"Combinations ({len(combinations)}):")
+for system, version in combinations:
+	print(f"- {system}:{version}")
+
+jobs = [
+				 {
+					 "sysicon": data["sys"][system]["icon"],
+					 "system": system,
+					 "runs-on": data["sys"][system]["runs-on"],
+					 "runtime": "native",
+					 "shell": data["sys"][system]["shell"],
+					 "pyicon": data["python"][version]["icon"],
+					 "python": currentAlphaRelease if version == currentAlphaVersion else version,
+					 "envname": data["sys"][system]["name"],
+				 }
+				 for system, version in combinations if system in data["sys"]
+			 ] + [
+				 {
+					 "sysicon": data["runtime"][runtime]["icon"],
+					 "system": "msys2",
+					 "runs-on": "windows-latest",
+					 "runtime": runtime.upper(),
+					 "shell": "msys2 {0}",
+					 "pyicon": data["python"][currentMSYS2Version]["icon"],
+					 "python": version,
+					 "envname": data["runtime"][runtime]["name"],
+				 }
+				 for runtime, version in combinations if runtime not in data["sys"]
+			 ]
+
+artifact_names = {
+	"unittesting_xml": f"{name}-UnitTestReportSummary-XML",
+	"unittesting_html": f"{name}-UnitTestReportSummary-HTML",
+	"perftesting_xml": f"{name}-PerformanceTestReportSummary-XML",
+	"benchtesting_xml": f"{name}-BenchmarkTestReportSummary-XML",
+	"apptesting_xml": f"{name}-ApplicationTestReportSummary-XML",
+	"codecoverage_sqlite": f"{name}-CodeCoverage-SQLite",
+	"codecoverage_xml": f"{name}-CodeCoverage-XML",
+	"codecoverage_json": f"{name}-CodeCoverage-JSON",
+	"codecoverage_html": f"{name}-CodeCoverage-HTML",
+	"statictyping_html": f"{name}-StaticTyping-HTML",
+	"package_all": f"{name}-Packages",
+	"documentation_html": f"{name}-Documentation-HTML",
+	"documentation_latex": f"{name}-Documentation-LaTeX",
+	"documentation_pdf": f"{name}-Documentation-PDF",
+}
+
+# Deprecated structure
+params = {
+	"python_version": python_version,
+	"artifacts": {
+		"unittesting": f"{artifact_names['unittesting_xml']}",
+		"coverage": f"{artifact_names['codecoverage_html']}",
+		"typing": f"{artifact_names['statictyping_html']}",
+		"package": f"{artifact_names['package_all']}",
+		"doc": f"{artifact_names['documentation_html']}",
+	}
+}
+
+print("Parameters:")
+print(f"  python_version: {python_version}")
+print(f"  python_jobs ({len(jobs)}):\n" +
+			"".join(
+				[f"    {{ " + ", ".join([f"\"{key}\": \"{value}\"" for key, value in job.items()]) + f" }},\n" for job in jobs])
+			)
+print(f"  artifact_names ({len(artifact_names)}):")
+for id, name in artifact_names.items():
+	print(f"    {id:>20}: {name}")
+
+# Write jobs to special file
+github_output = Path(getenv("GITHUB_OUTPUT"))
+print(f"GITHUB_OUTPUT: {github_output}")
+with github_output.open("a+", encoding="utf-8") as f:
+	f.write(dedent(f"""\
+    python_version={python_version}
+    python_jobs={json_dumps(jobs)}
+    artifact_names={json_dumps(artifact_names)}
+    params={json_dumps(params)}
+"""))

tests/requirements.txt

@@ -1,13 +1,13 @@
 -r ../requirements.txt
 
 # Coverage collection
-Coverage ~= 7.5
+Coverage ~= 7.8
 
 # Test Runner
-pytest ~= 8.1
-pytest-cov ~= 5.0
+pytest ~= 8.3
+pytest-cov ~= 6.1
 
 # Static Type Checking
-mypy ~= 1.9
-typing_extensions ~= 4.11
-lxml ~= 5.1
+mypy ~= 1.15
+typing_extensions ~= 4.13
+lxml ~= 5.3

tests/unit/Dummy.py

@@ -11,7 +11,7 @@
 #                                                                                                                      #
 # License:                                                                                                             #
 # ==================================================================================================================== #
-# Copyright 2017-2024 Patrick Lehmann - Bötzingen, Germany                                                             #
+# Copyright 2017-2025 Patrick Lehmann - Bötzingen, Germany                                                             #
 #                                                                                                                      #
 # Licensed under the Apache License, Version 2.0 (the "License");                                                      #
 # you may not use this file except in compliance with the License.                                                     #

tests/unit/__init__.py

@@ -11,7 +11,7 @@
 #                                                                                                                      #
 # License:                                                                                                             #
 # ==================================================================================================================== #
-# Copyright 2017-2024 Patrick Lehmann - Bötzingen, Germany                                                             #
+# Copyright 2017-2025 Patrick Lehmann - Bötzingen, Germany                                                             #
 #                                                                                                                      #
 # Licensed under the Apache License, Version 2.0 (the "License");                                                      #
 # you may not use this file except in compliance with the License.                                                     #