switch to UV

Author: vincentsarago

.github/workflows/ci.yml

@@ -8,36 +8,33 @@ on:
     - '*'
   pull_request:
 env:
-  LATEST_PY_VERSION: '3.13'
+  LATEST_PY_VERSION: '3.14'
 
 jobs:
   tests:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version:
-          - '3.11'
-          - '3.12'
-          - '3.13'
-          # - '3.14.0-alpha.2' wait for pyproj and rasterio wheels to support 3.14
+        python-version: ['3.11', '3.12', '3.13', '3.14']
 
     steps:
       - uses: actions/checkout@v5
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
+          version: "0.9.*" 
+          enable-cache: true
           python-version: ${{ matrix.python-version }}
 
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          python -m pip install .["test"]
+          uv sync
 
-      - name: run pre-commit
+      - name: Run pre-commit
         if: ${{ matrix.python-version == env.LATEST_PY_VERSION }}
         run: |
-          python -m pip install pre-commit
-          pre-commit run --all-files
+          uv run pre-commit run --all-files
 
       - name: Run tests
         run: python -m pytest --cov morecantile --cov-report term-missing --cov-report xml
@@ -51,24 +48,50 @@ jobs:
           fail_ci_if_error: false
           token: ${{ secrets.CODECOV_TOKEN }}
 
+  # We need two set of tests because rasterio wheels are not availble for python 3.14 yet
+  tests-rasterio:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13']
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.*" 
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          uv sync --extra rasterio
+
+      - name: Run tests
+        run: python -m pytest --cov morecantile --cov-report term-missing --cov-report xml
+
   benchmark:
-    needs: [tests]
+    needs: [tests, tests-rasterio]
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: '3.13'
+          version: "0.9.*" 
+          enable-cache: true
+          python-version: ${{ env.LATEST_PY_VERSION }}
 
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          python -m pip install -e ".[benchmark]"
+          uv sync --group benchmark
 
       - name: Run Benchmark
         run: |
-          python -m pytest tests/benchmarks.py --benchmark-only --benchmark-columns 'min, max, mean, median' --benchmark-sort 'min' --benchmark-json output.json
+          uv run pytest tests/benchmarks.py --benchmark-only --benchmark-columns 'min, max, mean, median' --benchmark-sort 'min' --benchmark-json output.json
 
       - name: Store and Compare benchmark result
         uses: benchmark-action/github-action-benchmark@v1
@@ -87,21 +110,22 @@ jobs:
           benchmark-data-dir-path: dev/benchmarks
 
   publish:
-    needs: [tests]
+    needs: [tests, tests-rasterio]
     runs-on: ubuntu-latest
     if: startsWith(github.event.ref, 'refs/tags') || github.event_name == 'release'
     steps:
       - uses: actions/checkout@v5
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
+          version: "0.9.*" 
+          enable-cache: true
           python-version: ${{ env.LATEST_PY_VERSION }}
 
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          python -m pip install flit
-          python -m pip install .
+          uv sync --group deploy
 
       - name: Set tag version
         id: tag
@@ -112,11 +136,13 @@ jobs:
       - name: Set module version
         id: module
         run: |
-          echo version=$(python -c'import morecantile; print(morecantile.__version__)') >> $GITHUB_OUTPUT
+          echo "version=$(uv run hatch --quiet version)" >> $GITHUB_OUTPUT
 
       - name: Build and publish
         if: ${{ steps.tag.outputs.version }} == ${{ steps.module.outputs.version}}
         env:
-          FLIT_USERNAME: ${{ secrets.PYPI_USERNAME }}
-          FLIT_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
-        run: flit publish
+          HATCH_INDEX_USER: ${{ secrets.PYPI_USERNAME }}
+          HATCH_INDEX_AUTH: ${{ secrets.PYPI_PASSWORD }}
+        run: |
+          uv run hatch build 
+          uv run hatch publish

.github/workflows/deploy_mkdocs.yml

@@ -19,16 +19,11 @@ jobs:
       - name: Checkout main
         uses: actions/checkout@v5
 
-      - name: Set up Python 3.13
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: 3.13
-
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install numpy
-          python -m pip install .["docs"]
+          version: "0.9.*" 
+          enable-cache: true
 
       - name: Deploy docs
-        run: mkdocs gh-deploy --force -f docs/mkdocs.yml
+        run: uv run --group docs mkdocs gh-deploy --force -f docs/mkdocs.yml

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.12.1
+    rev: v0.24
     hooks:
       - id: validate-pyproject
 

CONTRIBUTING.md

@@ -2,52 +2,58 @@
 
 Issues and pull requests are more than welcome.
 
+We recommand using [`uv`](https://docs.astral.sh/uv) as project manager for development.
+
+See https://docs.astral.sh/uv/getting-started/installation/ for installation 
+
 **dev install**
 
 ```bash
-$ git clone https://github.com/developmentseed/morecantile.git
-$ cd morecantile
-$ python -m pip install -e .["dev"]
+git clone https://github.com/developmentseed/morecantile.git
+cd morecantile
+
+uv sync --extra rasterio
 ```
 
 You can then run the tests with the following command:
 
 ```sh
-python -m pytest --cov morecantile --cov-report term-missing -s -vv
+uv run pytest --cov morecantile --cov-report term-missing -s -vv
 ```
 
 ### pre-commit
 
 This repo is set to use `pre-commit` to run *isort*, *flake8*, *pydocstring*, *black* ("uncompromising Python code formatter") and mypy when committing new code.
 
 ```bash
-$ pre-commit install
+uv run pre-commit install
 ```
 
 ##### Performance tests
 
 ```sh
-python -m pip install -e ".[benchmark]"
-python -m pytest tests/benchmarks.py --benchmark-only --benchmark-columns 'min, max, mean, median' --benchmark-sort 'min'
+uv sync --group benchmark 
+uv run pytest tests/benchmarks.py --benchmark-only --benchmark-columns 'min, max, mean, median' --benchmark-sort 'min'
 ```
 
 ### Docs
 
 ```bash
-$ git clone https://github.com/developmentseed/morecantile.git
-$ cd morecantile
-$ python -m pip install -e .["docs"]
+git clone https://github.com/developmentseed/morecantile.git
+cd morecantile
+
+uv sync --group docs
 ```
 
 Hot-reloading docs:
 
 ```bash
-$ mkdocs serve -f docs/mkdocs.yml
+uv run mkdocs serve -f docs/mkdocs.yml
 ```
 
 To manually deploy docs (note you should never need to do this because Github
 Actions deploys automatically for new commits.):
 
 ```bash
-$ mkdocs gh-deploy -f docs/mkdocs.yml
-```
+uv run mkdocs gh-deploy -f docs/mkdocs.yml
+```

README.md

@@ -44,12 +44,12 @@ Morecantile is like [mercantile](https://github.com/mapbox/mercantile) (the best
 ## Install
 
 ```bash
-$ python -m pip install -U pip
-$ python -m pip install morecantile
+python -m pip install -U pip
+python -m pip install morecantile
 
 # Or install from source:
-$ python -m pip install -U pip
-$ python -m pip install git+https://github.com/developmentseed/morecantile.git
+python -m pip install -U pip
+python -m pip install git+https://github.com/developmentseed/morecantile.git
 ```
 
 ## Usage

pyproject.toml

@@ -15,6 +15,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Scientific/Engineering :: GIS",
 ]
 dynamic = ["version"]
@@ -29,22 +30,18 @@ dependencies = [
 rasterio = [
     "rasterio>=1.2.1",
 ]
-test = [
+
+[dependency-groups]
+dev = [
     "mercantile",
     "pytest",
     "pytest-cov",
-    "rasterio>=1.2.1",
     # ref: https://github.com/pallets/click/issues/2939
     "click!=8.2.1,!=8.2.2",
-]
-benchmark = [
-    "pytest",
-    "pytest-benchmark",
-]
-dev = [
     "pre-commit",
     "bump-my-version",
 ]
+
 docs = [
     "mkdocs>=1.4.3",
     "mkdocs-material[imaging]>=9.5",
@@ -53,6 +50,14 @@ docs = [
     "pygments",
 ]
 
+benchmark = [
+    "pytest-benchmark",
+]
+
+deploy = [
+    "hatch",
+]
+
 [project.urls]
 Source = "https://github.com/developmentseed/morecantile"
 Documentation = "https://developmentseed.org/morecantile/"
@@ -61,20 +66,17 @@ Documentation = "https://developmentseed.org/morecantile/"
 morecantile = "morecantile.scripts.cli:cli"
 
 [build-system]
-requires = ["flit_core>=3.2,<4"]
-build-backend = "flit_core.buildapi"
+requires = ["hatchling"]
+build-backend = "hatchling.build"
 
-[tool.flit.module]
-name = "morecantile"
+[tool.hatch.version]
+path = "morecantile/__init__.py"
 
-[tool.flit.sdist]
-exclude = [
-    "tests/",
-    "docs/",
-    ".github/",
-    "CHANGES.md",
-    "CONTRIBUTING.md",
-]
+[tool.hatch.build.targets.sdist]
+only-include = ["morecantile/"]
+
+[tool.hatch.build.targets.wheel]
+only-include = ["morecantile/"]
 
 [tool.coverage.run]
 branch = true
@@ -114,7 +116,6 @@ ignore = [
 [tool.ruff.lint.per-file-ignores]
 "tests/*.py" = ["D1"]
 
-
 [tool.pytest.ini_options]
 filterwarnings = [
     "ignore:You will likely lose important projection*:UserWarning",

tests/test_models.py

@@ -8,7 +8,6 @@
 import pyproj
 import pytest
 from pydantic import ValidationError
-from rasterio.crs import CRS as rioCRS
 
 import morecantile
 from morecantile.commons import Tile
@@ -405,7 +404,6 @@ def test_mars_tms_construction():
         matrix_scale=[2, 1],
     )
     assert "4326" not in mars_tms.geographic_crs.to_wkt()
-    assert "4326" not in mars_tms.rasterio_geographic_crs.to_wkt()
     assert mars_tms.xy_bbox.left == pytest.approx(-180.0)
     assert mars_tms.xy_bbox.bottom == pytest.approx(-90.0)
     assert mars_tms.xy_bbox.right == pytest.approx(180.0)
@@ -427,7 +425,6 @@ def test_mars_web_mercator_long_lat():
         id="MarsWebMercator",
     )
     assert "4326" not in mars_tms_wm.geographic_crs.to_wkt()
-    assert "4326" not in mars_tms_wm.rasterio_geographic_crs.to_wkt()
     assert mars_tms_wm.bbox.left == pytest.approx(-180.0)
     assert mars_tms_wm.bbox.bottom == pytest.approx(-85.0511287)
     assert mars_tms_wm.bbox.right == pytest.approx(180.0)
@@ -549,6 +546,10 @@ def test_crs_uris_for_defaults(tilematrixset):
 
 def test_rasterio_crs():
     """Check rasterio CRS methods."""
+    _ = pytest.importorskip("rasterio")
+
+    from rasterio.crs import CRS as rioCRS
+
     tms = morecantile.tms.get("WebMercatorQuad")
     assert isinstance(tms.rasterio_crs, rioCRS)
     assert isinstance(tms.rasterio_geographic_crs, rioCRS)