v4.5a (alpha version) (#483)

* bump h3lib to unreleased a9c0a2e (cellsToMultiPolygon)

* initial changes

* move around dependencies

* update CI

* ci separation

* h3.pc.in

* clean up .gitignore

* changelog

* better changelog

* add cellsToMultiPolygon to h3-py in separate release

* sdist exclude and coverage for version test

* warn that changing some justfile rules will affect CI

* try to silence some CI warnings

* one more warning

Author: ajfriend

.github/workflows/build_docs.yml

@@ -18,17 +18,14 @@ jobs:
         with:
           submodules: recursive
 
-      - uses: actions/setup-python@v6.2.0
+      - uses: astral-sh/setup-uv@v7
         with:
-          python-version: 3.11
+          python-version: '3.11'
 
-      - name: Install dependencies
-        run: |
-          pip install --upgrade pip setuptools wheel
-          pip install .[all]
+      - uses: extractions/setup-just@v2
 
       - name: Build the book
-        run: jupyter-book build docs/ --warningiserror --keep-going --all
+        run: just docs
 
       - name: Upload artifacts
         uses: actions/upload-artifact@v6.0.0

.github/workflows/lint_and_coverage.yml

@@ -16,22 +16,20 @@ jobs:
         with:
           submodules: recursive
 
-      - uses: actions/setup-python@v6.2.0
+      - uses: astral-sh/setup-uv@v7
         with:
-          python-version: 3.11
+          python-version: '3.11'
 
-      - name: Install from source
-        run: pip install .[test]
+      - uses: extractions/setup-just@v2
 
-      - name: Run Linting
-        uses: astral-sh/ruff-action@v3
+      - name: Lint
+        run: just lint
 
-      - name: Coverage Requirement - Library
-        run: |
-          pytest tests/test_lib --cov=h3 --cov=tests/test_lib --cov-fail-under=100
+      - name: Install
+        run: uv sync
+
+      - name: Coverage - Library
+        run: just ci-test
 
       - name: Coverage - Cython
-        run: |
-          pip install cython
-          cythonize tests/test_cython/cython_example.pyx
-          pytest tests/test_cython --cov=tests/test_cython
+        run: just ci-test-cython

.github/workflows/tests.yml

@@ -14,17 +14,19 @@ jobs:
     strategy:
       matrix:
         os: [macos-latest, windows-latest, ubuntu-22.04]
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
 
     steps:
       - uses: actions/checkout@v6.0.2
         with:
           submodules: recursive
 
-      - uses: actions/setup-python@v6.2.0
+      - uses: astral-sh/setup-uv@v7
         with:
           python-version: '${{ matrix.python-version }}'
 
+      - uses: extractions/setup-just@v2
+
       ## Start Windows stuff
       - uses: ilammy/msvc-dev-cmd@v1.13.0
         if: startsWith(matrix.os, 'windows')
@@ -36,13 +38,11 @@ jobs:
           echo "CXX=cl.exe" >> $GITHUB_ENV
       ## End Windows stuff
 
-      - name: Install from source
-        run: |
-          pip install --upgrade pip setuptools wheel
-          pip install .[test]
+      - name: Install
+        run: uv sync
 
       - name: Tests
-        run: |
-          pip install cython
-          cythonize tests/test_cython/cython_example.pyx
-          pytest
+        run: just ci-test
+
+      - name: Cython Tests
+        run: just ci-test-cython

.github/workflows/wheels.yml

@@ -27,25 +27,25 @@ jobs:
         with:
           submodules: recursive
 
-      - name: Setup Python
-        uses: actions/setup-python@v6.2.0
+      - uses: astral-sh/setup-uv@v7
         with:
-          python-version: 3.11
+          python-version: '3.11'
+
 
       - name: Make sdist
-        run: |
-          python --version
-          pipx --version
-          pipx run build --sdist
+        run: uv build --sdist
 
+      # Test the sdist, NOT the local checkout.
+      # Use a fresh venv + uv pip install (not uv sync, which would build from source).
       - name: Install from sdist
         run: |
-          pip install --upgrade pip setuptools wheel
+          uv venv
           cp dist/h3-*.tar.gz h3.tar.gz
-          pip install h3.tar.gz[test]
+          uv pip install h3.tar.gz[numpy] pytest pytest-cov
 
       - name: Test sdist
-        run: pytest
+        # run pytest directly from the venv to avoid `uv run` syncing from the local checkout
+        run: .venv/bin/pytest
 
       - name: Upload artifacts to GitHub
         uses: actions/upload-artifact@v6.0.0
@@ -85,12 +85,6 @@ jobs:
             build: 'cp*-manylinux_x86_64'
             name: Linux Intel glibc 64-bit
 
-          - os: ubuntu-22.04
-            build: 'cp38-musllinux_x86_64'
-            name: Linux Intel musl 64-bit 3.8
-          - os: ubuntu-22.04
-            build: 'cp39-musllinux_x86_64'
-            name: Linux Intel musl 64-bit 3.9
           - os: ubuntu-22.04
             build: 'cp310-musllinux_x86_64'
             name: Linux Intel musl 64-bit 3.10
@@ -107,12 +101,6 @@ jobs:
             build: 'cp314-musllinux_x86_64'
             name: Linux Intel musl 64-bit 3.14
 
-          - os: ubuntu-22.04
-            build: 'cp38-manylinux_aarch64'
-            name: Linux Aarch64 3.8
-          - os: ubuntu-22.04
-            build: 'cp39-manylinux_aarch64'
-            name: Linux Aarch64 3.9
           - os: ubuntu-22.04
             build: 'cp310-manylinux_aarch64'
             name: Linux Aarch64 3.10
@@ -134,7 +122,9 @@ jobs:
         with:
           submodules: recursive
 
-      - name: Set MSVC for Windows-x64  
+      - uses: astral-sh/setup-uv@v7
+
+      - name: Set MSVC for Windows-x64
         uses: microsoft/setup-msbuild@v2
         if: matrix.os == 'windows-latest'
         with:
@@ -161,14 +151,14 @@ jobs:
 
       - uses: pypa/cibuildwheel@v3.3.1
         env:
+          CIBW_BUILD_FRONTEND: 'build[uv]'
           CIBW_TEST_REQUIRES: pytest pytest-cov numpy
           CIBW_TEST_COMMAND: pytest {project}/tests
           CIBW_ARCHS_LINUX: auto aarch64
           CIBW_BUILD: ${{ matrix.build }}
 
       - name: Check with Twine
-        run: |
-          pipx run twine check wheelhouse/*
+        run: uvx twine check wheelhouse/*
 
       - name: Upload artifacts to GitHub
         uses: actions/upload-artifact@v6.0.0
@@ -193,15 +183,19 @@ jobs:
     needs: [merge]
     runs-on: ubuntu-latest
     steps:
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: false
+          ignore-empty-workdir: true
+
       - name: Download merged artifacts
         uses: actions/download-artifact@v7.0.0
         with:
           name: wheels_and_sdist
           path: dist
 
       - name: Check all wheels and sdist with Twine
-        run: |
-          pipx run twine check dist/*
+        run: uvx twine check dist/*
 
   to_pypi:
     needs: [check_merged]

.gitignore

@@ -1,75 +1,57 @@
-h3c/
+# Byte-compiled / optimized
 *.py[cod]
-.cache/
-h3/out/
-.ruff_cache/
-_build/
+__pycache__/
+
+# C extensions
+*.so
 
 # Generated C code from Cython test
 tests/**/*.c
 # Cython HTML annotations
 *.html
 
-# C extensions
-*.so
-
-# Packages
-*.egg
+# Build artifacts
+build/
+dist/
 *.egg-info
-dist
-build
-eggs
-parts
-bin
-var
-sdist
-develop-eggs
-.installed.cfg
 
-# Installer logs
-pip-log.txt
-
-# Unit test / coverage reports
+# Coverage
 .coverage
 coverage.xml
 coverage.lcov
-.tox
-nosetests.xml
-.noseids
-.pytest_cache
+htmlcov/
 
-# Mr Developer
-.mr.developer.cfg
-.project
-.pydevproject
+# Test
+.pytest_cache/
 
-*.csv
-build/
-env/
-env_docs/
+# Tools
+.ruff_cache/
+.cache/
+
+# Docs
+_build/
 docs/_build/
-htmlcov/
 
-# vim/emacs backup files
+# Environment
+.venv/
+uv.lock
+
+# OS
+.DS_Store
+
+# Editor backup files
 *~
 \#*\#
 .\#*
 .*.sw*
 
-#DB snapshots
-db_snapshots/
-
-#OSX
-.DS_Store
-
-node_modules/
-bower_components/
-.sass-cache/
+# IDE
 .idea/
-.unison.*
 
+# IPython / Jupyter
 .ipynb_checkpoints/
-_skbuild/
 
-# might want to remove this later when distributing
-MANIFEST
+# Legacy build dirs
+_skbuild/
+h3c/
+h3/out/

CHANGELOG.md

@@ -16,6 +16,13 @@ avoid adding features or APIs which do not map onto the
 
 ## Unreleased
 
+## [4.5.0a1] - 2026-02-25
+
+- Update `h3lib` with draft v4.5 changes
+- Drop Python 3.8 and 3.9 (EOL); minimum is now Python 3.10
+- Document Python 3.14 support
+- Migrate build tooling from Makefile/pip to justfile/uv, including CI
+
 ## [4.4.2] - 2026-01-29
 
 - Check for error from `cellsToLinkedMultiPolygon` (#477)

dev_notes.md

@@ -2,11 +2,20 @@
 
 ## Install for development
 
+This repo uses [`just`](https://github.com/casey/just) for running common development commands.
+
+To get started:
+
 - `git clone git@github.com:uber/h3-py.git`
 - `cd h3-py`
-- `make init`
-- `make test`
-- `make lint`
+- `just lint`
+- `just test`
+- `just test-cython`
+
+To build and view docs:
+
+- `just docs`
+- `just view`
 
 
 ## Docstrings