mirgrate to uv and also allow py314

Author: jefjonkers

.github/workflows/documentation.yml

@@ -22,45 +22,18 @@ jobs:
           docker-images: true
           swap-storage: true
 
-      - name: Set up Python 3.10
-        uses: actions/setup-python@v5
+      - name: Install uv and set Python 3.10
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
+          version: "0.11.32"
           python-version: "3.10"
-          architecture: "x64"
+          enable-cache: true
 
-      - name: Show Python
-        run: |
-          python --version
-          which python
-
-      - name: Setup PDM
-        uses: pdm-project/setup-pdm@v4
-        with:
-          python-version: "3.10"
-          cache: true
-
-      - name: Make PDM use this Python
-        run: |
-          pdm use -f "$(python -c 'import sys; print(sys.executable)')"
-          pdm info
-
-      - name: Install dependencies into PDM venv
-        run: |
-          pdm sync -d
-
-      # 🔧 Add pip to the PDM venv
-      - name: Ensure pip is available in the PDM venv
-        run: |
-          pdm run python -m ensurepip --upgrade
-
-      # Install your package (editable) so Sphinx/autodoc can import it
-      - name: Install project (editable) into PDM venv
-        run: |
-          pdm run pip install -e .
+      - name: Install locked documentation dependencies
+        run: uv sync --locked --no-default-groups --group doc
 
       - name: Sphinx build
-        run: |
-          pdm run doc
+        run: uv run --no-sync sphinx-build docs docs/_build/html
 
       - name: Deploy to GitHub Pages
         uses: peaceiris/actions-gh-pages@v3

.github/workflows/pypi-release.yml

@@ -1,10 +1,4 @@
-# This workflow will upload a Python Package using Twine when a release is created
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
-
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
+# This workflow builds and publishes the package when a release is created.
 
 name: Upload Python Package
 
@@ -20,14 +14,34 @@ jobs:
     name: upload release to PyPI
     runs-on: ubuntu-latest
     permissions:
-      # This permission is needed for private repositories.
       contents: read
-      # IMPORTANT: this permission is mandatory for trusted publishing
       id-token: write
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
+
+      - name: Install uv and set Python 3.14
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.32"
+          python-version: "3.14"
+
+      - name: Build package distributions
+        run: uv build --no-sources
+
+      - name: Smoke-test wheel
+        run: |
+          uv venv "${RUNNER_TEMP}/landmarker-wheel-smoke"
+          uv pip install --python "${RUNNER_TEMP}/landmarker-wheel-smoke/bin/python" --no-deps dist/*.whl
+          "${RUNNER_TEMP}/landmarker-wheel-smoke/bin/python" -c "import landmarker; print(landmarker.__version__)"
+
+      - name: Smoke-test source distribution
+        run: |
+          uv venv "${RUNNER_TEMP}/landmarker-sdist-smoke"
+          uv pip install --python "${RUNNER_TEMP}/landmarker-sdist-smoke/bin/python" --no-deps dist/*.tar.gz
+          "${RUNNER_TEMP}/landmarker-sdist-smoke/bin/python" -c "import landmarker; print(landmarker.__version__)"
 
-      - uses: pdm-project/setup-pdm@v3
+      - name: Validate package publication
+        run: uv publish --dry-run --trusted-publishing never
 
       - name: Publish package distributions to PyPI
-        run: pdm publish
+        run: uv publish --trusted-publishing always

.github/workflows/tests.yml

@@ -12,34 +12,25 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python & PDM ${{ matrix.python-version }}
-        uses: pdm-project/setup-pdm@v4
+      - name: Install uv and set Python ${{ matrix.python-version }}
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
+          version: "0.11.32"
           python-version: ${{ matrix.python-version }}
-          cache: true
+          enable-cache: true
 
       - name: System packages
         run: |
           sudo apt-get update
           sudo apt-get install -y ffmpeg libsm6 libxext6 libopenblas-dev libzmq3-dev
 
-      # Make sure PDM points at the interpreter in this job
-      - name: Ensure PDM uses this interpreter
-        run: pdm use -f $(python -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')}")
-
-      # On 3.13/3.14, refresh the lock for this Python so we get cp313/cp314 wheels
-      - name: Refresh lockfile on 3.13/3.14
-        if: matrix.python-version == '3.13' || matrix.python-version == '3.14'
-        run: pdm lock --refresh
-
-      # Let PDM handle installing the project + dev deps
-      - name: Install deps (PDM)
-        run: pdm sync -d
+      - name: Install locked test dependencies
+        run: uv sync --locked --no-default-groups --group test
 
       - name: Test with pytest
-        run: pdm run pytest --junitxml=junit/test-results-${{ matrix.python-version }}.xml
+        run: uv run --no-sync pytest --junitxml=junit/test-results-${{ matrix.python-version }}.xml

.gitignore

@@ -17,6 +17,7 @@ iframe_figures/*
 .DS_Store
 .directory
 .tox
+.venv/
 .mypy_cache
 examples/data
 test_notebooks
@@ -44,16 +45,14 @@ build/*
 dist/*
 sdist/*
 wheel/*
-.pdm-build
 docs/_build/*
 cover/*
 MANIFEST
-.pdm-python
 
 # example files
 examples/configs/*
 examples/datasets/*
 examples/lightning_logs/*
 examples/lightning_models/*
 examples/main.py
-*model_checkpoints/*
+*model_checkpoints/*

CONTRIBUTING.md

@@ -13,39 +13,46 @@ For more information on contributing to open source projects, [GitHub's own guid
 
 ## Setting up your development environment
 
-To get started, fork the `landmarker` repository and clone it to your local machine. Then, install the required dependencies using <a href="https://pdm.fming.dev/" target="_blank">pdm</a> (see <a href="https://pdm-project.org/latest/#installation" target="_blank">installation instructions</a>):
+To get started, fork the `landmarker` repository and clone it to your local machine. Then, install the required dependencies using <a href="https://docs.astral.sh/uv/" target="_blank">uv</a> (see <a href="https://docs.astral.sh/uv/getting-started/installation/" target="_blank">installation instructions</a>):
 
 ```bash
-pdm install --dev
+uv sync
 ```
 
 ## Running tests
-`landmarker` uses [pytest](https://docs.pytest.org/en/stable/) for testing. You can run test by running a pdm script, by using the following command:
+`landmarker` uses [pytest](https://docs.pytest.org/en/stable/) for testing. Coverage reporting is enabled by default:
 
 ```bash
-pdm run test
+uv run pytest
 ```
 
-If you want to run pytest with coverage, you can use the following command:
+To run the complete test matrix across all supported Python versions, as well as the lint and type-check environments, use tox:
 
 ```bash
-pdm run coverage
+uv run tox
+```
+
+You can also run the lint and type checks directly:
+
+```bash
+uv run flake8 src/
+uv run mypy src/
 ```
 
 ## Building documentation
 `landmarker` uses [sphinx](https://www.sphinx-doc.org/en/master/) for documentation, and use MyST markdown for documentation pages. You can build the documentation locally by running the following command:
 
 ```bash
-pdm run doc
+uv run sphinx-build docs docs/_build/html
 ```
 
 We also support the use of [sphinx-autobuild](https://github.com/executablebooks/sphinx-autobuild), which will automatically rebuild the documentation when a change is detected and live-reload the page in your browser. You can run it using the following command:
 
 ```bash
-pdm run docauto
+uv run sphinx-autobuild docs docs/_build/html --ignore _collections
 ```
 
 ## Ground Rules
 The goal is to maintain a diverse community that's pleasant for everyone.
 **Please be considerate and respectful of others**.
-Everyone must abide by our [Code of Conduct](https://github.com/GenericMappingTools/.github/blob/main/CODE_OF_CONDUCT.md) and we encourage all to read it carefully.
+Everyone must abide by our [Code of Conduct](https://github.com/GenericMappingTools/.github/blob/main/CODE_OF_CONDUCT.md) and we encourage all to read it carefully.

README.md

@@ -5,7 +5,7 @@
 </p>
 
 [![PyPI Latest Release](https://img.shields.io/pypi/v/landmarker.svg)](https://pypi.org/project/landmarker/)
-[![support-version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/landmarker/)
+[![support-version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://pypi.org/project/landmarker/)
 [![codecov](https://img.shields.io/codecov/c/github/predict-idlab/landmarker?logo=codecov)](https://codecov.io/gh/predict-idlab/landmarker)
 [![CodeQL](https://github.com/predict-idlab/landmarker/actions/workflows/codeql.yml/badge.svg)](https://github.com/predict-idlab/landmarker/actions/workflows/codeql.yml)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?)](http://makeapullrequest.com)