fix: platform dependency windows only

correct GitHub actions, package can run only on Windows due to PyWin32 dependency, corrections to pyproject.toml

Author: dornech

.cruft.json

@@ -11,6 +11,7 @@
       "project_short_description": "Package with various utilities to support COM object development with Python based on PyWin32",
       "open_source_license": "GPL-3.0-only",
       "target_python_version": "3.9",
+      "target_os_platform": "windows-latest",
       "github_username": "dornech",
       "project_repo": "https://github.com/dornech/utils-COMobjects",
       "pypi_username": "dornech",

.github/workflows/build.yml

@@ -23,7 +23,7 @@ jobs:
   build-test:
     strategy:
       matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
+        os: [ windows-latest ]
     runs-on: ${{ matrix.os }}
     if: startsWith(github.ref, 'refs/tags/')
     steps:
@@ -51,7 +51,7 @@ jobs:
           verbose: true
 
   build-distribution:
-    runs-on: ubuntu-latest
+    runs-on: windows-latest
     needs: build-test
     steps:
       - name: Check out the repository

.github/workflows/documentation.yml

@@ -37,8 +37,25 @@ jobs:
         run: echo "$GITHUB_CONTEXT"
 
   build-documentation:
-    runs-on: ubuntu-latest
+    runs-on: windows-latest
     steps:
+      - name: Install Cairo via MSYS2
+        uses: msys2/setup-msys2@v2
+        with:
+          update: true
+          install: mingw-w64-x86_64-cairo
+      - name: Add MSYS2 Cairo to PATH to make cairocffi libraries like libcairo-2.dll discoverable
+        shell: powershell
+        # "C:\msys64\mingw64\bin" did not work, try "C:\Program Files\Unity Hub\resources\app.asar.unpacked\node_modules\canvas\build\Release"
+        # found using Get-ChildItem -Path C:\ -Filter "*libcairo*.d*" -File -Recurse -ErrorAction SilentlyContinue in Log step
+        run: |
+          echo "C:\Program Files\Unity Hub\resources\app.asar.unpacked\node_modules\canvas\build\Release" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
+          echo "CAIROCFFI_DLL_DIRECTORIES=C:\Program Files\Unity Hub\resources\app.asar.unpacked\node_modules\canvas\build\Release" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
+      - name: Log environment variable updates
+        shell: powershell
+        run: |
+          Write-Host "GITHUB_PATH: $env:PATH"
+          Write-Host "CAIROCFFI_DLL_DIRECTORIES: $env:CAIROCFFI_DLL_DIRECTORIES"
       - name: Check out the repository
         uses: actions/checkout@v5
       - name: Set up Python

.github/workflows/tests.yml

@@ -29,7 +29,7 @@ jobs:
   tests:
     strategy:
       matrix:
-        os: [ ubuntu-latest, macos-latest, windows-latest ]
+        os: [ windows-latest ]
         python-version: [ '3.9', '3.10', '3.11', '3.12', '3.13' ]
     runs-on: ${{ matrix.os }}
     steps:

pyproject.toml

@@ -120,7 +120,7 @@ change_type_order = ["BREAKING CHANGE", "feat", "fix", "refactor", "perf", "docs
 ##################
 
 [tool.docsig]
-check-class = true
+check-class = false
 check-class-constructor = true
 check-dunders = false
 check-nested = false
@@ -285,7 +285,7 @@ exclude_lines = [
 
 # Hatch default environment
 [tool.hatch.envs.default]
-python = "3.11"
+# python = "3.9"
 post-install-commands = ["pre-commit install", "pre-commit install --hook-type commit-msg"]
 dependencies = [
     "pre-commit",
@@ -327,7 +327,7 @@ debug =  "cov --no-cov -s --pdb --pdbcls=IPython.core.debugger:Pdb {args}"
 # Hatch testing environment matrix for various Python versions replacing the functionality of tox
 [[tool.hatch.envs.test.matrix]]
 template = ["test"]
-python = ["39", "310", "311", "312", "313"]
+python = ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
 # Hatch default linting environment for "hatch fmt"
 [tool.hatch.envs.hatch-static-analysis]
@@ -348,11 +348,11 @@ dependencies = [
 ]
 [tool.hatch.envs.lint.scripts]
 typing = [
-    "echo \"VERSION: `mypy --version`\"",
+    "mypy --version",
     "mypy --install-types --non-interactive {args}"
 ]
 style = [
-    "echo \"VERSION: `ruff --version`\"",
+    "ruff --version",
     "ruff check {args:.}",
     "ruff format --check {args:.}",
 ]
@@ -361,13 +361,10 @@ fix = [
     "ruff check --fix {args:.}",
     "style",  # feedback on what is not fixable
 ]
-docsig = [
-    "docsig",
-]
 all = [
     "style",
     "typing",
-    "docsig",
+    "docsig src",
 ]
 
 # Hatch environment for building documentation