Merge branch 'main' into r1

(cherry picked from commit 33b99a3b4e)

.github/workflows/ArtifactCleanUp.yml

@@ -36,23 +36,19 @@ on:
         type: string
 
 jobs:
-
   ArtifactCleanUp:
     name: 🗑️ Artifact Cleanup
     runs-on: ubuntu-latest
 
     steps:
-
       - name: 🗑️ Delete package Artifacts
         if: ${{ ! startsWith(github.ref, 'refs/tags') }}
-        uses: geekyeggo/delete-artifact@v4
+        uses: geekyeggo/delete-artifact@v5
         with:
           name: ${{ inputs.package }}
-          token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: 🗑️ Delete remaining Artifacts
         if: ${{ inputs.remaining != '' }}
-        uses: geekyeggo/delete-artifact@v4
+        uses: geekyeggo/delete-artifact@v5
         with:
           name: ${{ inputs.remaining }}
-          token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/CheckDocumentation.yml

@@ -47,10 +47,10 @@ jobs:
       - name: ⏬ Checkout repository
         uses: actions/checkout@v4
 
-      - name: 🐍 Setup Python 3.11
+      - name: 🐍 Setup Python ${{ inputs.python_version }}
         uses: actions/setup-python@v5
         with:
-          python-version: "3.11"
+          python-version: ${{ inputs.python_version }}
 
       - name: 🔧 Install wheel,tomli and pip dependencies (native)
         run: |

.github/workflows/IntermediateCleanUp.yml

@@ -39,17 +39,15 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 🗑️ Delete SQLite coverage artifacts from matrix jobs
-        uses: geekyeggo/delete-artifact@v4
+        uses: geekyeggo/delete-artifact@v5
         if: inputs.sqlite_coverage_artifacts_prefix != ''
         continue-on-error: true
         with:
           name: ${{ inputs.sqlite_coverage_artifacts_prefix }}*
-          token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: 🗑️ Delete XML coverage artifacts from matrix jobs
-        uses: geekyeggo/delete-artifact@v4
+        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/Parameters.yml

@@ -140,6 +140,7 @@ jobs:
           for disable in disabled:
             print(f"::warning title=Disabled Python Job::System '{disable}' temporary disabled.")
 
+          # see https://raw.githubusercontent.com/actions/python-versions/main/versions-manifest.json
           data = {
             # Python and PyPy versions supported by "setup-python" action
             "python": {
@@ -157,9 +158,9 @@ jobs:
             },
             # Runner systems (runner images) supported by GitHub Actions
             "sys": {
-              "ubuntu":  { "icon": "🐧", "runs-on": "ubuntu-latest",  "shell": "bash", "name": "Linux (x86-64)"   },
+              "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)" },
+              "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)"   },
+              "macos":   { "icon": "🍎", "runs-on": "macos-latest",   "shell": "bash", "name": "MacOS (x86-64)",   "minPy": (3, 10)},
             },
             # Runtimes provided by MSYS2
             "runtime": {
@@ -182,12 +183,17 @@ jobs:
           for disable in disabled:
             print(f"- {disable}")
 
+          def toVersion(value):
+            major, minor = value.split(".")
+            return int(major[-1]), int(minor)
+
           combinations = [
             (system, version)
             for system in systems
               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
           ] + [
@@ -201,6 +207,7 @@ jobs:
             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
           ]
           print(f"Combinations ({len(combinations)}):")

.github/workflows/PublishCoverageResults.yml

@@ -199,7 +199,7 @@ jobs:
       - name: 📊 Publish code coverage at CodeCov
         if: inputs.CodeCov == true
         continue-on-error: true
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v4
         with:
           files: ${{ steps.getVariables.outputs.coverage_report_xml }}
           flags: unittests

.github/workflows/PublishOnPyPI.yml

@@ -78,6 +78,6 @@ jobs:
         run: twine upload dist/*.whl
 
       - name: 🗑️ Delete packaging Artifacts
-        uses: geekyeggo/delete-artifact@v4
+        uses: geekyeggo/delete-artifact@v5
         with:
           name: ${{ inputs.artifact }}

.github/workflows/UnitTesting.yml

@@ -165,11 +165,13 @@ jobs:
             "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+))?")

.github/workflows/_Checking_ArtifactCleanup.yml

@@ -6,7 +6,7 @@ on:
 
 jobs:
   Params:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
     with:
       name: Example
       python_version_list: "3.10 3.11"
@@ -50,7 +50,7 @@ jobs:
           retention-days: 1
 
   ArtifactCleanUp:
-    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@dev
+    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r1
     needs:
       - Params
       - Testing

.github/workflows/_Checking_Parameters.yml

@@ -6,24 +6,24 @@ on:
 
 jobs:
   Params_Default:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
     with:
       name: Example
 
   Params_PythonVersions:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
     with:
       name: Example
       python_version_list: "3.9 3.10 pypy-3.8 pypy-3.9"
 
   Params_Systems:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
     with:
       name: Example
       system_list: "windows mingw32 mingw64"
 
   Params_Include:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
     with:
       name: Example
       python_version_list: "3.10"
@@ -31,7 +31,7 @@ jobs:
       include_list: "ubuntu:3.11 ubuntu:3.12"
 
   Params_Exclude:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
     with:
       name: Example
       python_version_list: "3.10"
@@ -39,7 +39,7 @@ jobs:
       exclude_list: "windows:3.10 windows:3.11"
 
   Params_Disable:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
     with:
       name: Example
       python_version_list: "3.10"
@@ -47,7 +47,7 @@ jobs:
       disable_list: "windows:3.10 windows:3.11"
 
   Params_All:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Parameters.yml@r1
     with:
       name: Example
       python_version_list: "3.10 3.11"
@@ -80,22 +80,28 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.11"
+          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.8", "3.9", "3.10", "3.11"]
+          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.10"]
+          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",
+            "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
-            "perftesting_xml":    f"{expectedName}-PerformanceTestReportSummary-XML",
+            "unittesting_html":    f"{expectedName}-UnitTestReportSummary-HTML",
-            "benchtesting_xml":   f"{expectedName}-BenchmarkTestReportSummary-XML",
+            "perftesting_xml":     f"{expectedName}-PerformanceTestReportSummary-XML",
-            "apptesting_xml":     f"{expectedName}-ApplicationTestReportSummary-XML",
+            "benchtesting_xml":    f"{expectedName}-BenchmarkTestReportSummary-XML",
-            "codecoverage_xml":   f"{expectedName}-CodeCoverage-XML",
+            "apptesting_xml":      f"{expectedName}-ApplicationTestReportSummary-XML",
-            "codecoverage_html":  f"{expectedName}-CodeCoverage-HTML",
+            "codecoverage_sqlite": f"{expectedName}-CodeCoverage-SQLite",
-            "statictyping_html":  f"{expectedName}-StaticTyping-HTML",
+            "codecoverage_xml":    f"{expectedName}-CodeCoverage-XML",
-            "package_all":        f"{expectedName}-Packages",
+            "codecoverage_json":   f"{expectedName}-CodeCoverage-JSON",
-            "documentation_pdf":  f"{expectedName}-Documentation-PDF",
+            "codecoverage_html":   f"{expectedName}-CodeCoverage-HTML",
-            "documentation_html": f"{expectedName}-Documentation-HTML",
+            "statictyping_html":   f"{expectedName}-StaticTyping-HTML",
+            "package_all":         f"{expectedName}-Packages",
+            "documentation_html":  f"{expectedName}-Documentation-HTML",
+            "documentation_latex": f"{expectedName}-Documentation-LaTeX",
+            "documentation_pdf":   f"{expectedName}-Documentation-PDF",
           }
 
           actualPythonVersion =            """${{ needs.Params_Default.outputs.python_version }}"""
@@ -108,8 +114,12 @@ 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']}")
+            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)}.")
@@ -132,22 +142,29 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.11"
+          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.10"]
+          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",
+            "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
-            "perftesting_xml":    f"{expectedName}-PerformanceTestReportSummary-XML",
+            "unittesting_html":    f"{expectedName}-UnitTestReportSummary-HTML",
-            "benchtesting_xml":   f"{expectedName}-BenchmarkTestReportSummary-XML",
+            "perftesting_xml":     f"{expectedName}-PerformanceTestReportSummary-XML",
-            "apptesting_xml":     f"{expectedName}-ApplicationTestReportSummary-XML",
+            "benchtesting_xml":    f"{expectedName}-BenchmarkTestReportSummary-XML",
-            "codecoverage_xml":   f"{expectedName}-CodeCoverage-XML",
+            "apptesting_xml":      f"{expectedName}-ApplicationTestReportSummary-XML",
-            "codecoverage_html":  f"{expectedName}-CodeCoverage-HTML",
+            "codecoverage_sqlite": f"{expectedName}-CodeCoverage-SQLite",
-            "statictyping_html":  f"{expectedName}-StaticTyping-HTML",
+            "codecoverage_xml":    f"{expectedName}-CodeCoverage-XML",
-            "package_all":        f"{expectedName}-Packages",
+            "codecoverage_json":   f"{expectedName}-CodeCoverage-JSON",
-            "documentation_pdf":  f"{expectedName}-Documentation-PDF",
+            "codecoverage_html":   f"{expectedName}-CodeCoverage-HTML",
-            "documentation_html": f"{expectedName}-Documentation-HTML",
+            "statictyping_html":   f"{expectedName}-StaticTyping-HTML",
+            "package_all":         f"{expectedName}-Packages",
+            "documentation_html":  f"{expectedName}-Documentation-HTML",
+            "documentation_latex": f"{expectedName}-Documentation-LaTeX",
+            "documentation_pdf":   f"{expectedName}-Documentation-PDF",
           }
 
           actualPythonVersion =            """${{ needs.Params_PythonVersions.outputs.python_version }}"""
@@ -160,8 +177,12 @@ 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']}")
+            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)}.")
@@ -184,22 +205,26 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.11"
+          expectedPythonVersion = "3.12"
-          expectedPythons = ["3.8", "3.9", "3.10", "3.11"]
+          expectedPythons = ["3.8", "3.9", "3.10", "3.11", "3.12"]
           expectedSystems = ["windows"]
-          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["mingw32:3.10", "mingw64:3.10"]
+          expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["mingw32:3.11", "mingw64:3.11"]
           expectedName =    "Example"
           expectedArtifacts = {
-            "unittesting_xml":    f"{expectedName}-UnitTestReportSummary-XML",
+            "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
-            "perftesting_xml":    f"{expectedName}-PerformanceTestReportSummary-XML",
+            "unittesting_html":    f"{expectedName}-UnitTestReportSummary-HTML",
-            "benchtesting_xml":   f"{expectedName}-BenchmarkTestReportSummary-XML",
+            "perftesting_xml":     f"{expectedName}-PerformanceTestReportSummary-XML",
-            "apptesting_xml":     f"{expectedName}-ApplicationTestReportSummary-XML",
+            "benchtesting_xml":    f"{expectedName}-BenchmarkTestReportSummary-XML",
-            "codecoverage_xml":   f"{expectedName}-CodeCoverage-XML",
+            "apptesting_xml":      f"{expectedName}-ApplicationTestReportSummary-XML",
-            "codecoverage_html":  f"{expectedName}-CodeCoverage-HTML",
+            "codecoverage_sqlite": f"{expectedName}-CodeCoverage-SQLite",
-            "statictyping_html":  f"{expectedName}-StaticTyping-HTML",
+            "codecoverage_xml":    f"{expectedName}-CodeCoverage-XML",
-            "package_all":        f"{expectedName}-Packages",
+            "codecoverage_json":   f"{expectedName}-CodeCoverage-JSON",
-            "documentation_pdf":  f"{expectedName}-Documentation-PDF",
+            "codecoverage_html":   f"{expectedName}-CodeCoverage-HTML",
-            "documentation_html": f"{expectedName}-Documentation-HTML",
+            "statictyping_html":   f"{expectedName}-StaticTyping-HTML",
+            "package_all":         f"{expectedName}-Packages",
+            "documentation_html":  f"{expectedName}-Documentation-HTML",
+            "documentation_latex": f"{expectedName}-Documentation-LaTeX",
+            "documentation_pdf":   f"{expectedName}-Documentation-PDF",
           }
 
           actualPythonVersion =            """${{ needs.Params_Systems.outputs.python_version }}"""
@@ -212,8 +237,12 @@ 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']}")
+            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)}.")
@@ -236,22 +265,26 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.11"
+          expectedPythonVersion = "3.12"
           expectedPythons = ["3.10"]
           expectedSystems = ["ubuntu", "windows", "macos"]
           expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons] + ["ubuntu:3.11", "ubuntu:3.12"]
           expectedName =    "Example"
           expectedArtifacts = {
-            "unittesting_xml":    f"{expectedName}-UnitTestReportSummary-XML",
+            "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
-            "perftesting_xml":    f"{expectedName}-PerformanceTestReportSummary-XML",
+            "unittesting_html":    f"{expectedName}-UnitTestReportSummary-HTML",
-            "benchtesting_xml":   f"{expectedName}-BenchmarkTestReportSummary-XML",
+            "perftesting_xml":     f"{expectedName}-PerformanceTestReportSummary-XML",
-            "apptesting_xml":     f"{expectedName}-ApplicationTestReportSummary-XML",
+            "benchtesting_xml":    f"{expectedName}-BenchmarkTestReportSummary-XML",
-            "codecoverage_xml":   f"{expectedName}-CodeCoverage-XML",
+            "apptesting_xml":      f"{expectedName}-ApplicationTestReportSummary-XML",
-            "codecoverage_html":  f"{expectedName}-CodeCoverage-HTML",
+            "codecoverage_sqlite": f"{expectedName}-CodeCoverage-SQLite",
-            "statictyping_html":  f"{expectedName}-StaticTyping-HTML",
+            "codecoverage_xml":    f"{expectedName}-CodeCoverage-XML",
-            "package_all":        f"{expectedName}-Packages",
+            "codecoverage_json":   f"{expectedName}-CodeCoverage-JSON",
-            "documentation_pdf":  f"{expectedName}-Documentation-PDF",
+            "codecoverage_html":   f"{expectedName}-CodeCoverage-HTML",
-            "documentation_html": f"{expectedName}-Documentation-HTML",
+            "statictyping_html":   f"{expectedName}-StaticTyping-HTML",
+            "package_all":         f"{expectedName}-Packages",
+            "documentation_html":  f"{expectedName}-Documentation-HTML",
+            "documentation_latex": f"{expectedName}-Documentation-LaTeX",
+            "documentation_pdf":   f"{expectedName}-Documentation-PDF",
           }
 
           actualPythonVersion =            """${{ needs.Params_Include.outputs.python_version }}"""
@@ -264,8 +297,12 @@ 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']}")
+            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)}.")
@@ -288,22 +325,26 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.11"
+          expectedPythonVersion = "3.12"
           expectedPythons = ["3.10"]
           expectedSystems = ["ubuntu", "macos"]
           expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons]
           expectedName =    "Example"
           expectedArtifacts = {
-            "unittesting_xml":    f"{expectedName}-UnitTestReportSummary-XML",
+            "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
-            "perftesting_xml":    f"{expectedName}-PerformanceTestReportSummary-XML",
+            "unittesting_html":    f"{expectedName}-UnitTestReportSummary-HTML",
-            "benchtesting_xml":   f"{expectedName}-BenchmarkTestReportSummary-XML",
+            "perftesting_xml":     f"{expectedName}-PerformanceTestReportSummary-XML",
-            "apptesting_xml":     f"{expectedName}-ApplicationTestReportSummary-XML",
+            "benchtesting_xml":    f"{expectedName}-BenchmarkTestReportSummary-XML",
-            "codecoverage_xml":   f"{expectedName}-CodeCoverage-XML",
+            "apptesting_xml":      f"{expectedName}-ApplicationTestReportSummary-XML",
-            "codecoverage_html":  f"{expectedName}-CodeCoverage-HTML",
+            "codecoverage_sqlite": f"{expectedName}-CodeCoverage-SQLite",
-            "statictyping_html":  f"{expectedName}-StaticTyping-HTML",
+            "codecoverage_xml":    f"{expectedName}-CodeCoverage-XML",
-            "package_all":        f"{expectedName}-Packages",
+            "codecoverage_json":   f"{expectedName}-CodeCoverage-JSON",
-            "documentation_pdf":  f"{expectedName}-Documentation-PDF",
+            "codecoverage_html":   f"{expectedName}-CodeCoverage-HTML",
-            "documentation_html": f"{expectedName}-Documentation-HTML",
+            "statictyping_html":   f"{expectedName}-StaticTyping-HTML",
+            "package_all":         f"{expectedName}-Packages",
+            "documentation_html":  f"{expectedName}-Documentation-HTML",
+            "documentation_latex": f"{expectedName}-Documentation-LaTeX",
+            "documentation_pdf":   f"{expectedName}-Documentation-PDF",
           }
 
           actualPythonVersion =            """${{ needs.Params_Exclude.outputs.python_version }}"""
@@ -316,8 +357,12 @@ 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']}")
+            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)}.")
@@ -340,22 +385,26 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.11"
+          expectedPythonVersion = "3.12"
           expectedPythons = ["3.10"]
           expectedSystems = ["ubuntu", "macos"]
           expectedJobs =    [f"{system}:{python}" for system in expectedSystems for python in expectedPythons]
           expectedName =    "Example"
           expectedArtifacts = {
-            "unittesting_xml":    f"{expectedName}-UnitTestReportSummary-XML",
+            "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
-            "perftesting_xml":    f"{expectedName}-PerformanceTestReportSummary-XML",
+            "unittesting_html":    f"{expectedName}-UnitTestReportSummary-HTML",
-            "benchtesting_xml":   f"{expectedName}-BenchmarkTestReportSummary-XML",
+            "perftesting_xml":     f"{expectedName}-PerformanceTestReportSummary-XML",
-            "apptesting_xml":     f"{expectedName}-ApplicationTestReportSummary-XML",
+            "benchtesting_xml":    f"{expectedName}-BenchmarkTestReportSummary-XML",
-            "codecoverage_xml":   f"{expectedName}-CodeCoverage-XML",
+            "apptesting_xml":      f"{expectedName}-ApplicationTestReportSummary-XML",
-            "codecoverage_html":  f"{expectedName}-CodeCoverage-HTML",
+            "codecoverage_sqlite": f"{expectedName}-CodeCoverage-SQLite",
-            "statictyping_html":  f"{expectedName}-StaticTyping-HTML",
+            "codecoverage_xml":    f"{expectedName}-CodeCoverage-XML",
-            "package_all":        f"{expectedName}-Packages",
+            "codecoverage_json":   f"{expectedName}-CodeCoverage-JSON",
-            "documentation_pdf":  f"{expectedName}-Documentation-PDF",
+            "codecoverage_html":   f"{expectedName}-CodeCoverage-HTML",
-            "documentation_html": f"{expectedName}-Documentation-HTML",
+            "statictyping_html":   f"{expectedName}-StaticTyping-HTML",
+            "package_all":         f"{expectedName}-Packages",
+            "documentation_html":  f"{expectedName}-Documentation-HTML",
+            "documentation_latex": f"{expectedName}-Documentation-LaTeX",
+            "documentation_pdf":   f"{expectedName}-Documentation-PDF",
           }
 
           actualPythonVersion =            """${{ needs.Params_Exclude.outputs.python_version }}"""
@@ -368,8 +417,12 @@ 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']}")
+            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)}.")
@@ -392,22 +445,26 @@ jobs:
 
           from pyTooling.Common import zipdicts
 
-          expectedPythonVersion = "3.11"
+          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"]
           expectedName =    "Example"
           expectedArtifacts = {
-            "unittesting_xml":    f"{expectedName}-UnitTestReportSummary-XML",
+            "unittesting_xml":     f"{expectedName}-UnitTestReportSummary-XML",
-            "perftesting_xml":    f"{expectedName}-PerformanceTestReportSummary-XML",
+            "unittesting_html":    f"{expectedName}-UnitTestReportSummary-HTML",
-            "benchtesting_xml":   f"{expectedName}-BenchmarkTestReportSummary-XML",
+            "perftesting_xml":     f"{expectedName}-PerformanceTestReportSummary-XML",
-            "apptesting_xml":     f"{expectedName}-ApplicationTestReportSummary-XML",
+            "benchtesting_xml":    f"{expectedName}-BenchmarkTestReportSummary-XML",
-            "codecoverage_xml":   f"{expectedName}-CodeCoverage-XML",
+            "apptesting_xml":      f"{expectedName}-ApplicationTestReportSummary-XML",
-            "codecoverage_html":  f"{expectedName}-CodeCoverage-HTML",
+            "codecoverage_sqlite": f"{expectedName}-CodeCoverage-SQLite",
-            "statictyping_html":  f"{expectedName}-StaticTyping-HTML",
+            "codecoverage_xml":    f"{expectedName}-CodeCoverage-XML",
-            "package_all":        f"{expectedName}-Packages",
+            "codecoverage_json":   f"{expectedName}-CodeCoverage-JSON",
-            "documentation_pdf":  f"{expectedName}-Documentation-PDF",
+            "codecoverage_html":   f"{expectedName}-CodeCoverage-HTML",
-            "documentation_html": f"{expectedName}-Documentation-HTML",
+            "statictyping_html":   f"{expectedName}-StaticTyping-HTML",
+            "package_all":         f"{expectedName}-Packages",
+            "documentation_html":  f"{expectedName}-Documentation-HTML",
+            "documentation_latex": f"{expectedName}-Documentation-LaTeX",
+            "documentation_pdf":   f"{expectedName}-Documentation-PDF",
           }
 
           actualPythonVersion =            """${{ needs.Params_All.outputs.python_version }}"""
@@ -420,8 +477,12 @@ 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']}")
+            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

@@ -6,21 +6,21 @@ on:
 
 jobs:
   UnitTestingParams:
-    uses: pyTooling/Actions/.github/workflows/Parameters.yml@dev
+    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@dev
+    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@dev
+    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r1
     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@dev
+    uses: pyTooling/Actions/.github/workflows/UnitTesting.yml@r1
     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@dev
+#    uses: pyTooling/Actions/.github/workflows/CoverageCollection.yml@r1
 #    needs:
 #      - UnitTestingParams
 #    with:
@@ -58,7 +58,7 @@ jobs:
 #      codacy_token: ${{ secrets.CODACY_PROJECT_TOKEN }}
 
   StaticTypeCheck:
-    uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@dev
+    uses: pyTooling/Actions/.github/workflows/StaticTypeCheck.yml@r1
     needs:
       - UnitTestingParams
     with:
@@ -69,7 +69,7 @@ jobs:
       html_artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
 
   PublishCoverageResults:
-    uses: pyTooling/Actions/.github/workflows/PublishCoverageResults.yml@dev
+    uses: pyTooling/Actions/.github/workflows/PublishCoverageResults.yml@r1
     needs:
       - UnitTestingParams
       - UnitTesting
@@ -84,13 +84,13 @@ jobs:
       codacy_token: ${{ secrets.CODACY_PROJECT_TOKEN }}
 
   PublishTestResults:
-    uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@dev
+    uses: pyTooling/Actions/.github/workflows/PublishTestResults.yml@r1
     needs:
       - UnitTesting
       - PlatformTesting
 
   Package:
-    uses: pyTooling/Actions/.github/workflows/Package.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Package.yml@r1
     needs:
       - UnitTestingParams
       - UnitTesting
@@ -101,14 +101,14 @@ jobs:
       artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).package_all }}
 
 #  VerifyDocs:
-#    uses: pyTooling/Actions/.github/workflows/VerifyDocs.yml@dev
+#    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@dev
+    uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r1
     needs:
       - UnitTestingParams
 #      - VerifyDocs
@@ -116,7 +116,7 @@ jobs:
       artifact: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).documentation_html }}
 
   PublishToGitHubPages:
-    uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@dev
+    uses: pyTooling/Actions/.github/workflows/PublishToGitHubPages.yml@r1
     needs:
       - UnitTestingParams
       - BuildTheDocs
@@ -129,7 +129,7 @@ jobs:
       typing: ${{ fromJson(needs.UnitTestingParams.outputs.artifact_names).statictyping_html }}
 
   ReleasePage:
-    uses: pyTooling/Actions/.github/workflows/Release.yml@dev
+    uses: pyTooling/Actions/.github/workflows/Release.yml@r1
     if: startsWith(github.ref, 'refs/tags')
     needs:
       - UnitTesting
@@ -140,7 +140,7 @@ jobs:
       - PublishToGitHubPages
 
   PublishOnPyPI:
-    uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@dev
+    uses: pyTooling/Actions/.github/workflows/PublishOnPyPI.yml@r1
     if: startsWith(github.ref, 'refs/tags')
     needs:
       - UnitTestingParams
@@ -154,7 +154,7 @@ jobs:
       PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
 
   ArtifactCleanUp:
-    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@dev
+    uses: pyTooling/Actions/.github/workflows/ArtifactCleanUp.yml@r1
     needs:
       - UnitTestingParams
       - PlatformTestingParams

doc/Instantiation.rst

@@ -80,7 +80,7 @@ Documentation Only (Sphinx)
 
        steps:
          - name: 🗑️ Delete artifacts
-           uses: geekyeggo/delete-artifact@v2
+           uses: geekyeggo/delete-artifact@v5
            with:
              name: Documentation
 

doc/requirements.txt

@@ -1,10 +1,10 @@
 -r ../requirements.txt
 
-pyTooling ~= 6.0
+pyTooling ~= 6.1
 
 # Enforce latest version on ReadTheDocs
-sphinx >= 7.1, < 8.0
+sphinx ~= 7.3
-docutils >= 0.18.0, < 0.19.0
+docutils ~= 0.18.0
 
 # Sphinx Extenstions
 #sphinx.ext.coverage
@@ -16,5 +16,5 @@ sphinxcontrib-mermaid>=0.9.2
 autoapi >= 2.0.1
 sphinx_fontawesome >= 0.0.6
 sphinx-inline-tabs >= 2023.4.21
-sphinx_autodoc_typehints >= 1.24.0
+sphinx_autodoc_typehints ~= 2.1
 # changelog>=0.3.5

pyproject.toml

@@ -1,8 +1,8 @@
 [build-system]
 requires = [
-  "setuptools >= 69.0.0",
+  "setuptools ~= 69.5",
-  "wheel >= 0.40.0",
+  "wheel ~= 0.40.0",
-  "pyTooling ~= 6.0"
+  "pyTooling ~= 6.1"
 ]
 build-backend = "setuptools.build_meta"
 

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'''

requirements.txt

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

tests/platform/Specific.py

@@ -28,12 +28,12 @@
 # SPDX-License-Identifier: Apache-2.0                                                                                  #
 # ==================================================================================================================== #
 #
-from unittest         import TestCase
+from unittest           import TestCase
 
-from pytest           import mark
+from pytest             import mark
-from pyTooling.Common import CurrentPlatform
+from pyTooling.Platform import CurrentPlatform
 
-from pyDummy          import Application
+from pyDummy            import Application
 
 
 if __name__ == "__main__":  # pragma: no cover

tests/requirements.txt

@@ -1,13 +1,13 @@
 -r ../requirements.txt
 
 # Coverage collection
-Coverage >= 7.4
+Coverage ~= 7.5
 
 # Test Runner
-pytest >= 7.4.0
+pytest ~= 8.1
-pytest-cov >= 4.1.0
+pytest-cov ~= 5.0
 
 # Static Type Checking
-mypy >= 1.8.0
+mypy ~= 1.10
-typing_extensions >= 4.9.0
+typing_extensions ~= 4.11
-lxml >= 5.0
+lxml ~= 5.1

with-post-step/action.yml

@@ -37,6 +37,6 @@ inputs:
     default: POST
 
 runs:
-  using: 'node16'
+  using: 'node20'
   main: 'main.js'
   post: 'main.js'