Maintenance update

.github/workflows/_build_and_publish_documentation.yml

@@ -13,20 +13,16 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout active branch
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           lfs: true
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
-          cache-dependency-glob: "uv.lock"
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version-file: "pyproject.toml"
+          cache-dependency-glob: 'uv.lock'
       - name: Install the project
-        run: uv sync --upgrade
+        run: uv sync --frozen
       - name: Print debugging information
         run: |
           echo "github.ref:" ${{github.ref}}

.github/workflows/_build_package.yml

@@ -7,23 +7,23 @@ jobs:
     name: Build source distribution
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout code
+        uses: actions/checkout@v5
         with:
           lfs: true
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
-          cache-dependency-glob: "uv.lock"
-      - uses: actions/setup-python@v5
-        with:
-          python-version-file: "pyproject.toml"
-      - name: Build source distribution and wheel
+          cache-dependency-glob: 'uv.lock'
+      - name: Build source distribution and wheels
         run: uv build
-      - name: Run twine check
+      - name: Check build artifacts
         run: uvx twine check --strict dist/*
-      - uses: actions/upload-artifact@v4
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v5
         with:
+          name: dist
           path: |
             dist/*.tar.gz
             dist/*.whl

.github/workflows/_code_quality.yml

@@ -7,74 +7,62 @@ jobs:
     runs-on: ubuntu-latest
     name: ruff format
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout code
+        uses: actions/checkout@v5
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
-          cache-dependency-glob: "uv.lock"
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version-file: "pyproject.toml"
+          cache-dependency-glob: 'uv.lock'
       - name: Install the project
-        run: uv sync --upgrade
+        run: uv sync -U
       - name: Run ruff format
         run: uv run ruff format --diff
 
   ruff_check:
     runs-on: ubuntu-latest
     name: ruff check
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout code
+        uses: actions/checkout@v5
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
-          cache-dependency-glob: "uv.lock"
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version-file: "pyproject.toml"
+          cache-dependency-glob: 'uv.lock'
       - name: Install the project
-        run: uv sync --upgrade
+        run: uv sync -U
       - name: Run ruff check
         run: uv run ruff check --diff
 
   pyright:
     runs-on: ubuntu-latest
     name: pyright
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout code
+        uses: actions/checkout@v5
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
-          cache-dependency-glob: "uv.lock"
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version-file: "pyproject.toml"
+          cache-dependency-glob: 'uv.lock'
       - name: Install the project
-        run: uv sync --upgrade
+        run: uv sync -U
       - name: Run pyright
         run: uv run pyright
 
   mypy:
     runs-on: ubuntu-latest
     name: mypy
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout code
+        uses: actions/checkout@v5
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
-          cache-dependency-glob: "uv.lock"
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version-file: "pyproject.toml"
+          cache-dependency-glob: 'uv.lock'
       - name: Install the project
-        run: uv sync --upgrade
+        run: uv sync -U
       - name: Run mypy
         run: uv run mypy

.github/workflows/_merge_into_release.yml

@@ -12,7 +12,8 @@ jobs:
     runs-on: ubuntu-latest
     environment: release
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout code
+        uses: actions/checkout@v5
         with:
           # Fetch the whole history to prevent unrelated history errors
           fetch-depth: 0

.github/workflows/_test.yml

@@ -4,33 +4,23 @@ on: workflow_call
 
 jobs:
   test:
-    name: Test on ${{matrix.python.version}}-${{matrix.platform.runner}}
-    runs-on: ${{ matrix.platform.runner }}
+    name: Test (Python ${{ matrix.python }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
     strategy:
-      fail-fast: true
+      fail-fast: false
       matrix:
-        platform:
-          - runner: ubuntu-latest
-          - runner: windows-latest
-          # - runner: macos-latest
-        python:
-          - version: '3.10'
-          - version: '3.11'
-          - version: '3.12'
-          # - version: '3.13'
+        os: [ubuntu-latest, windows-latest]
+        python: ['3.11', '3.12', '3.13', '3.14']
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout code
+        uses: actions/checkout@v5
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
-          enable-cache: false
-          cache-dependency-glob: "uv.lock"
-      - name: Install Python ${{ matrix.python.version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python.version }}
+          enable-cache: true
+          cache-dependency-glob: 'uv.lock'
       - name: Install the project
-        run: uv sync -p ${{ matrix.python.version }} -U --no-dev
+        run: uv sync -p ${{ matrix.python }} -U --no-dev --extra test
       - name: Run pytest
         run: >
           uv run --with pytest --with pytest-cov

.github/workflows/_test_future.yml

@@ -1,34 +1,41 @@
-name: Unit Tests (py313)
-# Test also with Python 3.13 (experimental; workflow will not fail on error.)
+name: Unit Tests (py315)
+# Test also with Python 3.15 (experimental; workflow will not fail on error.)
 
 on: workflow_call
 
 jobs:
-  test313:
-    name: Test on ${{matrix.python.version}}-${{matrix.platform.runner}} (experimental)
+  test315:
+    name: Test (Python ${{ matrix.python.version }}, ${{ matrix.os }}) (experimental)
     continue-on-error: true
-    runs-on: ${{ matrix.platform.runner }}
+    runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: true
       matrix:
-        platform:
-          - runner: ubuntu-latest
-          - runner: windows-latest
+        os: [ubuntu-latest, windows-latest]
         python:
-          - version: '3.13.0-alpha - 3.13.0'
-            uvpy: '3.13'
+          - version: '3.15.0-alpha - 3.15.0'
+            uvpy: '3.15'
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout code
+        uses: actions/checkout@v5
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
-          enable-cache: false
-          cache-dependency-glob: "uv.lock"
-      - name: Install Python ${{ matrix.python.version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python.version }}
+          enable-cache: true
+          cache-dependency-glob: 'uv.lock'
+      - name: Remove Python upper version constraint from pyproject.toml
+        shell: pwsh
+        run: |
+          $File = Get-Item pyproject.toml
+          $Content = Get-Content $File -Raw
+          [regex]$RequiresPythonPattern = '(?<!-)(\brequires-python = "\s?[>=]{1,2}\s?\d+\.\d+\.?\d*\.?[\d\w]*\s?)(,\s?[<=]{1,2}\s?\d+\.?\d*\.?\d*\.?[\d\w]*\s?)?(")'
+          if ($Content -match $RequiresPythonPattern) {
+              $RequiresPythonFound = $Matches[0]
+              $RequiresPythonReplacement = $Matches[1] + $Matches[3]
+              $Content -Replace $RequiresPythonFound, $RequiresPythonReplacement | Set-Content $File -NoNewline
+          }
       - name: Install the project
-        run: uv sync -p ${{ matrix.python.uvpy }} -U --no-dev
+        run: uv sync -p ${{ matrix.python.uvpy }} -U --no-dev --extra test
       - name: Run pytest
         run: >
           uv run --with pytest --with pytest-cov

.github/workflows/nightly_build.yml

@@ -4,10 +4,9 @@ run-name: Nightly Build (by @${{ github.actor }})
 on:
   schedule:
     - cron: '30 5 * * *'
+  workflow_dispatch: # Allow manual trigger
 
 jobs:
-  code_quality:
-    uses: ./.github/workflows/_code_quality.yml
   test:
     uses: ./.github/workflows/_test.yml
   test_future:

.github/workflows/publish_release.yml

@@ -18,11 +18,13 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/download-artifact@v4
+      - name: Download build artifacts
+        uses: actions/download-artifact@v5
         with:
-          name: artifact
+          name: dist
           path: dist
-      - uses: pypa/gh-action-pypi-publish@release/v1
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
         # with:                                             # Uncomment this line to publish to testpypi
         #   repository-url: https://test.pypi.org/legacy/   # Uncomment this line to publish to testpypi
   merge_into_release:

.github/workflows/pull_request_to_main.yml

@@ -11,6 +11,7 @@ on:
       - converted_to_draft
     branches:
       - main
+  workflow_dispatch: # Allow manual trigger
 
 concurrency:
   group: pr-${{ github.ref }}-1

.gitignore

@@ -91,7 +91,7 @@ ipython_config.py
 #   It is generally recommended to include `uv.lock` in version control.
 #   However, in case of collaboration, if having platform-specific dependencies or dependencies
 #   having no cross-platform support, `uv` might install dependencies in one environment that don't work in another.
-#   In such case, `uv.lock` should be added to `.gitignore`
+#   In such case, `uv.lock` should be added to `.gitignore` (and, as such, excluded from version control).
 # uv.lock
 
 # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: mixed-line-ending
         args: [--fix=auto]
@@ -9,10 +9,10 @@ repos:
       - id: check-toml
       - id: check-merge-conflict
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.2
+    rev: v0.15.1
     hooks:
       - id: ruff-format
-      - id: ruff
+      - id: ruff-check
   # - repo: https://github.com/pre-commit/mirrors-mypy
   #   rev: v1.14.1
   #   hooks:

.sourcery.yaml

@@ -30,7 +30,7 @@ rule_settings:
     - refactoring
     - suggestion
     - comment
-  python_version: '3.10' # A string specifying the lowest Python version your project supports. Sourcery will not suggest refactorings requiring a higher Python version.
+  python_version: '3.11' # A string specifying the lowest Python version your project supports. Sourcery will not suggest refactorings requiring a higher Python version.
 
 # rules:  # A list of custom rules Sourcery will include in its analysis.
 # - id: no-print-statements

.vscode/extensions.json

@@ -5,8 +5,9 @@
     "recommendations": [
         "ms-python.python",
         "ms-python.vscode-pylance",
-        "visualstudioexptteam.vscodeintellicode",
-        "njqdev.vscode-python-typehint",
+        "github.copilot-chat",
+        "ms-python.debugpy",
+        "ms-python.vscode-python-envs",
         "charliermarsh.ruff",
         "sourcery.sourcery",
         "njpwerner.autodocstring",