v2.0.0

2026-02-12 02:56:56 +08:00 · 2024-11-10 11:18:28 +01:00
parent bf6ba9ba19 df0889b86b
commit e7e95b446d
38 changed files with 1286 additions and 288 deletions
--- a/.github/workflows/ArtifactCleanUp.yml
+++ b/.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
@@ -38,7 +43,7 @@ on:
 jobs:
  ArtifactCleanUp:
    name: 🗑️ Artifact Cleanup
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"

    steps:
      - name: 🗑️ Delete package Artifacts
--- a/.github/workflows/BuildTheDocs.yml
+++ b/.github/workflows/BuildTheDocs.yml
@@ -37,6 +37,9 @@ jobs:
    runs-on: ubuntu-24.04

    steps:
+      - name: '❗ Deprecation message'
+        run: echo "::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

--- a/.github/workflows/CheckDocumentation.yml
+++ b/.github/workflows/CheckDocumentation.yml
@@ -24,6 +24,11 @@ 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
@@ -42,7 +47,7 @@ on:
 jobs:
  DocCoverage:
    name: 👀 Check documentation coverage
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
    steps:
      - name: ⏬ Checkout repository
        uses: actions/checkout@v4
--- a/.github/workflows/CoverageCollection.yml
+++ b/.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,9 +68,12 @@ jobs:

  Coverage:
    name: 📈 Collect Coverage Data using Python ${{ inputs.python_version }}
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"

    steps:
+      - name: '❗ Deprecation message'
+        run: echo "::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

--- a/.github/workflows/ExtractConfiguration.yml
+++ b/.github/workflows/ExtractConfiguration.yml
@@ -0,0 +1,144 @@
+# ==================================================================================================================== #
+# 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.12'
+        type: string
+      coverage_config:
+        description: 'Path to the .coveragerc file. Use pyproject.toml by default.'
+        required: false
+        default: 'pyproject.toml'
+        type: string
+
+    outputs:
+      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:
+        description: ""
+        value: ${{ jobs.Extract.outputs.coverage_report_xml }}
+      coverage_report_json_directory:
+        description: ""
+        value: ${{ jobs.Extract.outputs.coverage_report_json_directory }}
+      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:
+      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:            ${{ steps.getVariables.outputs.coverage_report_xml }}
+      coverage_report_json_directory: ${{ steps.getVariables.outputs.coverage_report_json_directory }}
+      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: 🔁 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.")
+              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)
+
+              htmlDirectory = Path(coverageRCSettings["html"]["directory"])
+              xmlFile       = Path(coverageRCSettings["xml"]["output"])
+              jsonFile      = 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"""\
+              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}")
--- a/.github/workflows/IntermediateCleanUp.yml
+++ b/.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-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
    steps:
      - name: 🗑️ Delete SQLite coverage artifacts from matrix jobs
        uses: geekyeggo/delete-artifact@v5
@@ -45,7 +50,7 @@ jobs:
        with:
          name: ${{ inputs.sqlite_coverage_artifacts_prefix }}*

-      - 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
--- a/.github/workflows/LaTeXDocumentation.yml
+++ b/.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,7 +47,7 @@ on:
 jobs:
  PDFDocumentation:
    name: 📓 Converting LaTeX Documentation to PDF
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
    steps:
      - name: 📥 Download artifacts '${{ inputs.latex_artifact }}' from 'SphinxDocumentation' job
        uses: actions/download-artifact@v4
--- a/.github/workflows/Package.yml
+++ b/.github/workflows/Package.yml
@@ -25,6 +25,11 @@ 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
@@ -44,7 +49,7 @@ jobs:

  Package:
    name: 📦 Package in Source and Wheel Format
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"

    steps:
      - name: ⏬ Checkout repository
--- a/.github/workflows/Parameters.yml
+++ b/.github/workflows/Parameters.yml
@@ -25,6 +25,11 @@ 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
@@ -32,17 +37,17 @@ on:
      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-arm 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.'
@@ -72,10 +77,10 @@ on:
      macos_intel_image:
        description: 'The used GitHub Action image for macOS (Intel x86-64) based jobs.'
        required: false
-        default: 'macos-latest-large'
+        default: 'macos-13'
        type: string
      macos_arm_image:
-        description: 'The used GitHub Action image for macOS (ARM arm64) based jobs.'
+        description: 'The used GitHub Action image for macOS (ARM aarch64) based jobs.'
        required: false
        default: 'macos-latest'
        type: string
@@ -96,7 +101,8 @@ on:

 jobs:
  Parameters:
-    runs-on: ubuntu-24.04
+    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 }}
@@ -123,8 +129,8 @@ jobs:
          disable_list =   "${{ inputs.disable_list }}".strip()

          currentMSYS2Version = "3.11"
-          currentAlphaVersion = "3.13"
-          currentAlphaRelease = "3.13.0-alpha.1"
+          currentAlphaVersion = "3.14"
+          currentAlphaRelease = "3.14.0-alpha.1"

          if systems == "":
            print("::error title=Parameter::system_list is empty.")
@@ -151,8 +157,8 @@ 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:
@@ -164,13 +170,13 @@ jobs:
          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": "????.??" },
@@ -181,7 +187,7 @@ jobs:
              "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 (arm64)"    },
+              "macos-arm": { "icon": "🍏", "runs-on": "${{ inputs.macos_arm_image }}",   "shell": "bash", "name": "macOS (aarch64)"  },
            },
            # Runtimes provided by MSYS2
            "runtime": {
--- a/.github/workflows/Pipeline-NamespacePackage.yml
+++ b/.github/workflows/Pipeline-NamespacePackage.yml
@@ -0,0 +1,284 @@
+name: Namespace Package
+
+on:
+  workflow_call:
+    inputs:
+      package_namespace:
+        description: 'Name of the tool.'
+        required: true
+        type: string
+      package_name:
+        description: 'Name of the tool.'
+        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
+
+jobs:
+  UnitTestingParams:
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@main
+    with:
+      name: "${{ inputs.package_namespace }}.${{ 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@main
+    with:
+      name: "${{ inputs.package_namespace }}.${{ 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@main
+    needs:
+      - UnitTestingParams
+    with:
+      jobs: ${{ needs.UnitTestingParams.outputs.python_jobs }}
+      requirements: "-r tests/unit/requirements.txt"
+#      pacboy: "msys/git python-lxml:p"
+      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@main
+    needs:
+      - UnitTestingParams
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      commands: |
+        touch ${{ inputs.package_namespace }}/__init__.py
+        mypy --html-report htmlmypy -p ${{ inputs.package_namespace }}.${{ inputs.name }}
+      html_report: 'htmlmypy'
+      html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
+
+  DocCoverage:
+    uses: pyTooling/Actions/.github/workflows/CheckDocumentation.yml@main
+    needs:
+      - UnitTestingParams
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      directory: ${{ inputs.package_namespace }}/${{ inputs.package_name }}
+#      fail_below: 70
+
+  ConfigParams:
+    uses: pyTooling/Actions/.github/workflows/ExtractConfiguration.yml@main
+    needs:
+      - DocCoverage
+
+  Package:
+    uses: pyTooling/Actions/.github/workflows/Package.yml@main
+    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@main
+#    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@main
+    needs:
+      - 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_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@main
+    needs:
+      - UnitTestingParams
+      - UnitTesting
+    with:
+      merged_junit_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).unittesting_xml }}
+
+#  VerifyDocs:
+#    uses: pyTooling/Actions/.github/workflows/VerifyDocs.yml@main
+#    needs:
+#      - UnitTestingParams
+#    with:
+#      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+
+  Documentation:
+    uses: pyTooling/Actions/.github/workflows/SphinxDocumentation.yml@main
+    needs:
+      - UnitTestingParams
+      - ConfigParams
+      - 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 }}-ubuntu-native-3.12
+      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@main
+    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@main
+#    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@main
+    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@main
+    if: startsWith(github.ref, 'refs/tags')
+    needs:
+      - Package
+#      - AppTesting
+      - PublishToGitHubPages
+
+  PublishOnPyPI:
+    uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@main
+    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@main
+    needs:
+      - UnitTestingParams
+      - UnitTesting
+      - StaticTypeCheck
+      - Documentation
+#      - PDFDocumentation
+      - PublishTestResults
+      - PublishCoverageResults
+      - PublishToGitHubPages
+#      - PublishOnPyPI
+      - IntermediateCleanUp
+    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 }}
--- a/.github/workflows/PublishCoverageResults.yml
+++ b/.github/workflows/PublishCoverageResults.yml
@@ -24,6 +24,11 @@ name: Publish Code Coverage Results
 on:
  workflow_call:
    inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
      coverage_config:
        description: 'Path to the .coveragerc file. Use pyproject.toml by default.'
        required: false
@@ -57,7 +62,7 @@ on:
 jobs:
  PublishCoverageResults:
    name: 📊 Publish Code Coverage Results
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
    if: always()

    steps:
--- a/.github/workflows/PublishOnPyPI.yml
+++ b/.github/workflows/PublishOnPyPI.yml
@@ -25,6 +25,11 @@ 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
@@ -48,7 +53,7 @@ jobs:

  PublishOnPyPI:
    name: 🚀 Publish to PyPI
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"

    steps:
      - name: 📥 Download artifacts '${{ inputs.artifact }}' from 'Package' job
--- a/.github/workflows/PublishTestResults.yml
+++ b/.github/workflows/PublishTestResults.yml
@@ -25,6 +25,11 @@ name: Publish Unit Test Results
 on:
  workflow_call:
    inputs:
+      ubuntu_image_version:
+        description: 'Ubuntu image version.'
+        required: false
+        default: '24.04'
+        type: string
      merged_junit_artifact:
        description: 'Name of the merged JUnit Test Summary artifact.'
        required: false
@@ -44,7 +49,7 @@ on:
 jobs:
  PublishTestResults:
    name: 📊 Publish Test Results
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"
    if: always()

    steps:
@@ -69,7 +74,7 @@ jobs:

      - name: 🔁 Merge JUnit Unit Test Summaries
        run: |
-          pyedaa-reports -v unittest "--merge=pytest-junit:junit/*.xml" ${{ inputs.additional_merge_args }} "--output=ant-junit:Unittesting.xml"
+          pyedaa-reports -v unittest "--merge=pyTest-JUnit:junit/*.xml" ${{ inputs.additional_merge_args }} "--output=pyTest-JUnit:Unittesting.xml"
          echo "cat Unittesting.xml"
          cat Unittesting.xml

--- a/.github/workflows/PublishToGitHubPages.yml
+++ b/.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,7 +49,7 @@ jobs:

  PublishToGitHubPages:
    name: 📚 Publish to GH-Pages
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"

    steps:
      - name: ⏬ Checkout repository
--- a/.github/workflows/Release.yml
+++ b/.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-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"

    steps:
      - name: 🔁 Extract Git tag from GITHUB_REF
--- a/.github/workflows/SphinxDocumentation.yml
+++ b/.github/workflows/SphinxDocumentation.yml
@@ -24,6 +24,11 @@ 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
@@ -34,16 +39,15 @@ on:
        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: true
+        type: string
      coverage_json_artifact:
        description: 'Name of the coverage JSON artifact.'
        required: false
@@ -71,9 +75,9 @@ on:
        type: string

 jobs:
-  Sphinx:
-    name: 📓 Documentation generation using Sphinx and Python ${{ inputs.python_version }}
-    runs-on: ubuntu-24.04
+  Sphinx-HTML:
+    name: 📓 HTML Documentation using Sphinx and Python ${{ inputs.python_version }}
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"

    steps:
      - name: ⏬ Checkout repository
@@ -89,71 +93,9 @@ 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.")
-              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)
-
-              htmlDirectory = Path(coverageRCSettings["html"]["directory"])
-              xmlFile       = Path(coverageRCSettings["xml"]["output"])
-              jsonFile      = 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"""\
-              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
        if: inputs.unittest_xml_artifact != ''
        uses: actions/download-artifact@v4
@@ -166,7 +108,7 @@ jobs:
        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 }}

      - name: ☑ Generate HTML documentation
        if: inputs.html_artifact != ''
@@ -176,16 +118,6 @@ jobs:
          cd "${{ inputs.doc_directory || '.' }}"
          sphinx-build -v -n -b html -d _build/doctrees -j $(nproc) -w _build/html.log . _build/html

-      - name: ☑ Generate LaTeX documentation
-        if: inputs.latex_artifact != ''
-#        continue-on-error: true
-        run: |
-          export PYTHONPATH=$(pwd)
-
-          cd "${{ inputs.doc_directory || '.' }}"
-          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
@@ -196,6 +128,51 @@ jobs:
          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
+
+      - 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
+        if: inputs.unittest_xml_artifact != ''
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ inputs.unittest_xml_artifact }}
+          path: ${{ inputs.unittest_xml_directory }}
+
+      - name: 📥 Download artifacts '${{ inputs.coverage_json_artifact }}' from 'PublishCoverageResults' job
+        if: inputs.coverage_json_artifact != ''
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ inputs.coverage_json_artifact }}
+          path: ${{ inputs.coverage_report_json_directory }}
+
+      - name: ☑ Generate LaTeX documentation
+        if: inputs.latex_artifact != ''
+#        continue-on-error: true
+        run: |
+          export PYTHONPATH=$(pwd)
+
+          cd "${{ inputs.doc_directory || '.' }}"
+          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 'LaTeX Documentation' artifact
        if: inputs.latex_artifact != ''
        continue-on-error: true
--- a/.github/workflows/StaticTypeCheck.yml
+++ b/.github/workflows/StaticTypeCheck.yml
@@ -25,6 +25,11 @@ 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
@@ -63,7 +68,7 @@ jobs:

  StaticTypeCheck:
    name: 👀 Check Static Typing using Python ${{ inputs.python_version }}
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"

    steps:
      - name: ⏬ Checkout repository
--- a/.github/workflows/UnitTesting.yml
+++ b/.github/workflows/UnitTesting.yml
@@ -207,7 +207,7 @@ jobs:

          packages = {
            "coverage":            "python-coverage:p",
-            "docstr_coverage":     "python-pyyaml:p",
+            "docstr_coverage":     "python-pyaml:p",
            "igraph":              "igraph:p",
            "jinja2":              "python-markupsafe:p",
            "lxml":                "python-lxml:p",
@@ -215,12 +215,13 @@ jobs:
            "markupsafe":          "python-markupsafe:p",
            "pip":                 "python-pip:p",
            "pyyaml":              "python-pyyaml:p",
-            "ruamel.yaml":         "python-ruamel-yaml:p python-ruamel.yaml.clib: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",
+            "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": {
--- a/.github/workflows/VerifyDocs.yml
+++ b/.github/workflows/VerifyDocs.yml
@@ -25,6 +25,11 @@ 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
@@ -35,7 +40,7 @@ jobs:

  VerifyDocs:
    name: 👍 Verify example snippets using Python ${{ inputs.python_version }}
-    runs-on: ubuntu-24.04
+    runs-on: "ubuntu-${{ inputs.ubuntu_image_version }}"

    steps:
      - name: ⏬ Checkout repository
--- a/.github/workflows/_Checking_ArtifactCleanup.yml
+++ b/.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@main
    with:
      name: Example
-      python_version_list: "3.10 3.11"
+      python_version_list: "3.12 3.13"
      system_list: "ubuntu windows"

  Testing:
@@ -50,7 +50,7 @@ jobs:
          retention-days: 1

  ArtifactCleanUp:
-    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r1
+    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@main
    needs:
      - Params
      - Testing
--- a/.github/workflows/_Checking_Parameters.yml
+++ b/.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@main
    with:
      name: Example

  Params_PythonVersions:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@main
    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@main
    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@main
    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@main
    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@main
    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@main
    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:
@@ -80,12 +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"]
+          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.11", "ucrt64:3.11"]
-          expectedJobs.remove("macos:3.8")
-          expectedJobs.remove("macos:3.9")
          expectedName =    "Example"
          expectedArtifacts = {
            "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
@@ -116,7 +114,10 @@ jobs:
            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}")
@@ -142,13 +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"]
+          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.11", "ucrt64:3.11"]
-          expectedJobs.remove("macos:3.9")
-          expectedJobs.remove("macos:pypy-3.8")
-          expectedJobs.remove("macos:pypy-3.9")
          expectedName =    "Example"
          expectedArtifacts = {
            "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
@@ -179,7 +177,10 @@ jobs:
            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}")
@@ -205,8 +206,8 @@ 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"]
          expectedName =    "Example"
@@ -239,7 +240,10 @@ jobs:
            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}")
@@ -265,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 = {
@@ -299,7 +303,10 @@ jobs:
            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}")
@@ -325,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 = {
@@ -359,7 +366,10 @@ jobs:
            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}")
@@ -385,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 = {
@@ -419,7 +429,10 @@ jobs:
            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}")
@@ -445,10 +458,10 @@ jobs:

          from pyTooling.Common import zipdicts

-          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.10", "3.11"]
+          expectedPythonVersion = "3.13"
+          expectedPythons = ["3.12", "3.13"]
          expectedSystems = ["ubuntu", "windows"]
-          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["windows:3.8", "windows:3.9", "windows:3.12"]
+          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",
@@ -479,7 +492,10 @@ jobs:
            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}")
--- a/.github/workflows/_Checking_Pipeline.yml
+++ b/.github/workflows/_Checking_Pipeline.yml
@@ -6,21 +6,21 @@ on:

 jobs:
  UnitTestingParams:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@main
    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"
+      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@r1
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@main
    with:
      name: Platform
      python_version_list: ""
      system_list: "ubuntu windows macos mingw32 mingw64 clang64 ucrt64"

  UnitTesting:
-    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r1
+    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@main
    needs:
      - UnitTestingParams
    with:
@@ -33,7 +33,7 @@ jobs:
 #      coverage_html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).codecoverage_html }}

  PlatformTesting:
-    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r1
+    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@main
    needs:
      - PlatformTestingParams
    with:
@@ -48,7 +48,7 @@ jobs:
      coverage_html_artifact: ${{ fromJson(needs.PlatformTestingParams.outputs.artifact_names).codecoverage_html }}

 #  Coverage:
-#    uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r1
+#    uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@main
 #    needs:
 #      - UnitTestingParams
 #    with:
@@ -58,7 +58,7 @@ jobs:
 #      codacy_token: ${{ secrets.CODACY_PROJECT_TOKEN }}

  StaticTypeCheck:
-    uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@r1
+    uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@main
    needs:
      - UnitTestingParams
    with:
@@ -68,8 +68,33 @@ jobs:
      html_report: 'htmlmypy'
      html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}

+  DocCoverage:
+    uses: pyTooling/Actions/.github/workflows/CheckDocumentation.yml@r1
+    needs:
+      - UnitTestingParams
+    with:
+      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}
+      directory: sphinx_reports
+#      fail_below: 70
+
+  ConfigParams:
+    uses: pyTooling/Actions/.github/workflows/ExtractConfiguration.yml@main
+    needs:
+      - DocCoverage
+
+  Package:
+    uses: pyTooling/Actions/.github/workflows/Package.yml@main
+    needs:
+      - UnitTestingParams
+      - UnitTesting
+#      - Coverage
+      - 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@r1
+    uses: pyTooling/Actions/.github/workflows/PublishCoverageResults.yml@main
    needs:
      - UnitTestingParams
      - UnitTesting
@@ -84,44 +109,63 @@ jobs:
      codacy_token: ${{ secrets.CODACY_PROJECT_TOKEN }}

  PublishTestResults:
-    uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@dev
+    uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@main
    needs:
      - UnitTesting
      - PlatformTesting
    with:
      additional_merge_args: '-d "--pytest=rewrite-dunder-init;reduce-depth:pytest.tests.unit;reduce-depth:pytest.tests.platform"'

-  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
+#    uses: pyTooling/Actions/.github/workflows/VerifyDocs.yml@main
 #    needs:
 #      - UnitTestingParams
 #    with:
 #      python_version: ${{ needs.UnitTestingParams.outputs.python_version }}

-  BuildTheDocs:
-    uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r1
+  Documentation:
+    uses: pyTooling/Actions/.github/workflows/SphinxDocumentation.yml@main
    needs:
      - UnitTestingParams
+      - ConfigParams
+      - PublishTestResults
+      - PublishCoverageResults
 #      - VerifyDocs
    with:
-      artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
+      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 }}

-  PublishToGitHubPages:
-    uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r1
+  IntermediateCleanUp:
+    uses: pyTooling/Actions/.github/workflows/IntermediateCleanUp.yml@r1
    needs:
      - UnitTestingParams
-      - BuildTheDocs
+      - 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@main
+    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@main
+    needs:
+      - UnitTestingParams
+      - Documentation
+#      - PDFDocumentation
 #      - Coverage
      - PublishCoverageResults
      - StaticTypeCheck
@@ -131,7 +175,7 @@ jobs:
      typing: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}

  ReleasePage:
-    uses: pyTooling/Actions/.github/workflows/Release.yml@r1
+    uses: pyTooling/Actions/.github/workflows/Release.yml@main
    if: startsWith(github.ref, 'refs/tags')
    needs:
      - UnitTesting
@@ -142,7 +186,7 @@ jobs:
      - PublishToGitHubPages

  PublishOnPyPI:
-    uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@r1
+    uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@main
    if: startsWith(github.ref, 'refs/tags')
    needs:
      - UnitTestingParams
@@ -156,18 +200,20 @@ jobs:
      PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}

  ArtifactCleanUp:
-    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r1
+    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@main
    needs:
      - UnitTestingParams
      - PlatformTestingParams
      - UnitTesting
-      - PlatformTesting
 #      - Coverage
      - StaticTypeCheck
-#      - BuildTheDocs
-      - PublishToGitHubPages
-      - PublishCoverageResults
+      - PlatformTesting
+      - Documentation
+#      - PDFDocumentation
      - PublishTestResults
+      - PublishCoverageResults
+      - PublishToGitHubPages
+      - IntermediateCleanUp
    with:
      package: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
      remaining: |