Support Python 3.14 (and drop Python 3.9)

Author: eriknw

.github/workflows/test.yml

@@ -18,7 +18,7 @@ jobs:
         source: ["conda-forge"]
         # os: ["ubuntu-latest"]
         # source: ["source"]
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: [ "3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
     - name: Checkout
       uses: actions/checkout@v4

.pre-commit-config.yaml

@@ -28,6 +28,8 @@ repos:
       - id: mixed-line-ending
         args: [--fix=lf]
       - id: trailing-whitespace
+      - id: name-tests-test
+        args: ["--pytest-test-first"]
   - repo: https://github.com/abravalheri/validate-pyproject
     rev: v0.24.1
     hooks:
@@ -39,16 +41,16 @@ repos:
       - id: autoflake
         args: [--in-place]
   - repo: https://github.com/pycqa/isort
-    rev: 6.0.1
+    rev: 7.0.0
     hooks:
       - id: isort
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.20.0
+    rev: v3.21.0
     hooks:
       - id: pyupgrade
-        args: [--py39-plus]
+        args: [--py310-plus]
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.1.0
+    rev: 25.9.0
     hooks:
       - id: black
   - repo: https://github.com/PyCQA/flake8
@@ -61,21 +63,21 @@ repos:
         - flake8==7.3.0
         - flake8-comprehensions==3.17.0
         - flake8-bugbear==24.12.12
-        # - flake8-simplify==0.21.0
+        # - flake8-simplify==0.22.0
   - repo: https://github.com/asottile/yesqa
     rev: v1.5.0
     hooks:
       - id: yesqa
         additional_dependencies: *flake8_dependencies
   # `pyroma` may help keep our package standards up to date if best practices change.
   # This is a "low value" check though and too slow to run as part of pre-commit.
-  # - repo: https://github.com/regebro/pyroma
-  #   rev: "4.2"
-  #   hooks:
-  #     - id: pyroma
-  #       args: [-n, "10", .]
+  - repo: https://github.com/regebro/pyroma
+    rev: "5.0"
+    hooks:
+      - id: pyroma
+        args: [-n, "10", .]
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.33.3
+    rev: 0.34.1
     hooks:
       - id: check-dependabot
       - id: check-github-workflows

Dockerfile

@@ -1,4 +1,4 @@
-ARG BASE_CONTAINER=python:3.9-slim-buster
+ARG BASE_CONTAINER=python:3.10-slim-buster
 FROM ${BASE_CONTAINER} as suitesparse
 ENV DEBIAN_FRONTEND=noninteractive
 
@@ -24,7 +24,7 @@ ENV PYTHONUNBUFFERED 1
 
 COPY --from=suitesparse  /usr/include/GraphBLAS.h /usr/local/include/
 COPY --from=suitesparse /usr/lib/x86_64-linux-gnu/libgraphblas* /usr/lib/x86_64-linux-gnu/
-COPY --from=suitesparse /build/pycparser/utils/fake_libc_include/* /usr/local/lib/python3.9/site-packages/pycparser/utils/fake_libc_include/
+COPY --from=suitesparse /build/pycparser/utils/fake_libc_include/* /usr/local/lib/python3.10/site-packages/pycparser/utils/fake_libc_include/
 
 RUN apt-get update && apt-get install -yq build-essential git
 RUN pip3 install numpy cffi pytest cython
@@ -44,4 +44,4 @@ RUN apt-get -y --purge remove git python3-pip && apt-get clean
 FROM ${BASE_CONTAINER}
 COPY --from=suitesparse /usr/lib/x86_64-linux-gnu/libgraphblas* /usr/lib/x86_64-linux-gnu/
 COPY --from=suitesparse /usr/lib/x86_64-linux-gnu/libgomp* /usr/lib/x86_64-linux-gnu/
-COPY --from=psg /usr/local/lib/python3.9/site-packages /usr/local/lib/python3.9/site-packages
+COPY --from=psg /usr/local/lib/python3.10/site-packages /usr/local/lib/python3.10/site-packages

build_graphblas_cffi.py

@@ -13,7 +13,7 @@
 # GraphBLAS_ROOT env var can point to the root directory of GraphBLAS to link against.
 # Expected subdirectories: include/ (contains GraphBLAS.h), lib/, and bin/ (on Windows only)
 # Otherwise fallback to default system folders.
-graphblas_root = os.environ.get("GraphBLAS_ROOT", None)
+graphblas_root = os.environ.get("GraphBLAS_ROOT")
 
 if not graphblas_root:
     # Windows wheels.yml configures suitesparse.sh to install GraphBLAS to "C:\\GraphBLAS".

pyproject.toml

@@ -6,7 +6,8 @@ requires = [
     "setuptools-git-versioning",
     "wheel",
     "cffi>=1.11",
-    "cython",
+    "cython; python_version<'3.14'",
+    "cython>=3.1; python_version>='3.14'",
     "numpy>=2.0",
 ]
 
@@ -15,7 +16,7 @@ name = "suitesparse-graphblas"
 dynamic = ["version"]
 description = "SuiteSparse:GraphBLAS Python bindings."
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 license = {file = "LICENSE"}
 authors = [
     {name = "Erik Welch", email = "[email protected]"},
@@ -51,12 +52,13 @@ classifiers = [
     "Operating System :: Microsoft :: Windows",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: Free Threading :: 2 - Beta",
     "Intended Audience :: Developers",
     "Intended Audience :: Other Audience",
     "Intended Audience :: Science/Research",
@@ -93,7 +95,7 @@ dirty_template = "{tag}+{ccount}.g{sha}.dirty"
 
 [tool.black]
 line-length = 100
-target-version = ["py39", "py310", "py311", "py312", "py313"]
+target-version = ["py310", "py311", "py312", "py313", "py314"]
 
 [tool.isort]
 sections = ["FUTURE", "STDLIB", "THIRDPARTY", "FIRSTPARTY", "LOCALFOLDER"]

suitesparse_graphblas/utils.pyx

@@ -1,3 +1,9 @@
+# cython: freethreading_compatible=True
+#
+# We don't do anything special to support free-threading, but GraphBLAS C
+# libraries are required to be thread-safe, so things should "just work".
+# Of course, users writing multithreaded code can find many creative ways
+# to fail, but python-suitesparse-graphblas shouldn't crash.
 import numpy as np
 from cpython.ref cimport Py_INCREF
 from libc.stdint cimport uintptr_t