Bump python version (#497)

* bumped min python version to 3.12

* Removed deprecated behaviour from shapiq:
 - removed `path_to_values` from `Game`
 - made json the only viable file format for `InteractionValues`

* updated CHANGELOG.md

* bumped min python version to 3.12

* bumped python version to 3.14

* added entry to CHANGELOG.md

* updated uv.lock

* updated uv.lock

* update tabpfn download for CI

* fixed ty issues

* fixed setup code

* fixed tabpfn code

* increased workflow dependencies for less workflow runtime in case of failure

* introduce AGENTS.md (prev. only CLAUDE.md)

* fixed tests with new versions of dependencies

Author: mmschlk

.github/workflows/ci.yml

@@ -27,7 +27,7 @@ jobs:
             -   name: Run code-quality checks
                 run: uv run pre-commit run --all-files --show-diff-on-failure
     # ----------------------------------------------------------------------------------------------
-    # Install and Import Check
+    # Install and Import Check `shapiq`
     # ----------------------------------------------------------------------------------------------
     install_and_import_shapiq:
         name: Install and import check shapiq
@@ -36,9 +36,9 @@ jobs:
             matrix:
                 include:
                     - os: ubuntu-latest
-                      python-version: "3.10"
+                      python-version: "3.12"
                     - os: ubuntu-latest
-                      python-version: "3.13"
+                      python-version: "3.14"
                     - os: windows-latest
                       python-version: "3.12"
                     - os: macos-latest
@@ -58,7 +58,7 @@ jobs:
             -   name: Test import
                 run: uv run --no-sync python -c "import shapiq; print('shapiq imported successfully')"
     # ----------------------------------------------------------------------------------------------
-    # Install and Import Check
+    # Install and Import Check `shapiq_games`
     # ----------------------------------------------------------------------------------------------
     install_and_import_shapiq_games:
         name: Install and import check shapiq-games
@@ -79,22 +79,37 @@ jobs:
             -   name: Test import of shapiq_games
                 run: uv run --no-sync python -c "import shapiq_games; print('shapiq_games imported successfully')"
     # ----------------------------------------------------------------------------------------------
-    # Unit Tests with Matrix
+    # Unit Tests for shapiq (Stable Python and Matrix)
     # ----------------------------------------------------------------------------------------------
-    test_shapiq:
-        name: Run Unit Tests
+    test_shapiq_stable:
+        name: Run Unit Tests (Stable Python)
+        runs-on: ubuntu-latest
+        steps:
+            -   uses: actions/checkout@v6
+            -   name: Set up Python and uv
+                uses: astral-sh/setup-uv@v7
+                with:
+                    python-version: "3.12"
+                    enable-cache: true
+            -   name: Install test dependencies
+                run: uv sync
+            -   name: Run unit tests
+                run: uv run pytest "tests/shapiq"
+    test_shapiq_matrix:
+        name: Run Unit Tests (Matrix)
+        needs:
+            - test_shapiq_stable
+            - install_and_import_shapiq
         strategy:
             fail-fast: false
             matrix:
                 include:
                     - os: ubuntu-latest
-                      python-version: "3.10"
-                    - os: ubuntu-latest
-                      python-version: "3.13"
+                      python-version: "3.14"  # Test latest Python on Ubuntu
                     - os: windows-latest
-                      python-version: "3.12"
+                      python-version: "3.12"  # Test stable Python on Windows
                     - os: macos-latest
-                      python-version: "3.12"
+                      python-version: "3.12"  # Test stable Python on macOS
         runs-on: ${{ matrix.os }}
         steps:
             -   uses: actions/checkout@v6
@@ -112,6 +127,9 @@ jobs:
     # ----------------------------------------------------------------------------------------------
     test_shapiq_games:
         runs-on: ubuntu-latest
+        needs:
+            - install_and_import_shapiq
+            - test_shapiq_stable
         steps:
             -   uses: actions/checkout@v6
             -   name: Set up Python and uv
@@ -156,6 +174,7 @@ jobs:
         needs:
             - install_and_import_shapiq
             - check_code_quality
+            - test_shapiq_stable
         steps:
             -   uses: actions/checkout@v6
             -   name: Set up Python and uv

AGENTS.md

@@ -0,0 +1,65 @@
+# CLAUDE.md
+
+Guidance for Claude Code when working in this repository.
+
+## Project Overview
+
+`shapiq` is a Python library for computing Shapley Interactions for Machine Learning. The repo hosts **two separate installable packages**:
+- `shapiq` in `src/shapiq/` — the core library
+- `shapiq_games` in `src/shapiq_games/` — optional benchmark games (requires extra ML deps via `uv sync --group all_ml`)
+
+## Commands
+
+```sh
+# Setup
+uv sync                        # dev dependencies (test + lint + all_ml)
+
+# Testing
+uv run pytest tests/shapiq
+uv run pytest tests/shapiq_games -n logical
+uv run pytest tests/shapiq/tests_unit/test_interaction_values.py  # single file
+
+# Quality (run before every commit)
+uv run pre-commit run --all-files
+uv run ty check                # type check src/shapiq/ only
+
+# Docs
+uv run sphinx-build -b html docs/source docs/build/html
+```
+
+## Package Structure
+
+```
+src/
+├── shapiq/
+│   ├── interaction_values.py       # InteractionValues — central output type
+│   ├── game.py                     # Base Game class
+│   ├── approximator/               # Approximation algorithms (base.py + subdirs)
+│   ├── explainer/
+│   │   ├── tabular.py              # TabularExplainer — main user-facing class
+│   │   ├── tree/
+│   │   └── product_kernel/
+│   ├── imputer/                    # MarginalImputer is the default
+│   ├── game_theory/
+│   │   ├── exact.py
+│   │   ├── indices.py              # ALL_AVAILABLE_CONCEPTS — index registry
+│   │   └── moebius_converter.py
+│   ├── plot/
+│   └── utils/
+└── shapiq_games/
+    ├── benchmark/
+    ├── synthetic/
+    └── tabular/
+```
+
+## Code Style
+
+- **All files** must start with `from __future__ import annotations` — `isort` enforces this
+- `ruff` with `black` style, line length 100, Google-style docstrings
+- Uppercase `X` in function signatures is allowed (ML convention)
+
+## Key Rules
+
+- **Do not** add ML-heavy dependencies to `shapiq` core — they belong in `shapiq_games`
+- Use existing fixtures in `tests/shapiq/fixtures/` rather than duplicating setup
+- `ty` type checking runs on `src/shapiq/` only; tests are excluded

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## v1.5.0 (unreleased)
 
+### Python Version
+- adds support for Python 3.14 making the package compatible with the latest Python version.
+- drops support for Python 3.10 and 3.11. The minimum supported Python version is now 3.12.
+
 ### Removed Deprecated Features
 - removes `path_to_values` parameter from `shapiq.Game`, which was previously deprecated. Use `shapiq.Game.load()` instead.
 - removes pickle support from `shapiq.InteractionValues`. JSON is now the only supported file format. Use `InteractionValues.save()` and `InteractionValues.load()` with JSON files.

CLAUDE.md

@@ -47,7 +47,6 @@
     "sphinx.ext.viewcode",
     "sphinx.ext.autosectionlabel",
     "sphinx_autodoc_typehints",
-    "sphinx_toolbox.more_autodoc.autoprotocol",
     "sphinxcontrib.bibtex",
     "sphinx_gallery.gen_gallery",
 ]

docs/source/conf.py

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "shapiq"
 dynamic = ["readme", "version"]
 description = "Shapley Interactions for Machine Learning"
-requires-python = ">=3.10"
+requires-python = ">=3.12"
 dependencies = [
     # core
     "numpy",
@@ -45,10 +45,9 @@ classifiers = [
     'Operating System :: Unix',
     'Operating System :: MacOS',
     'Programming Language :: Python :: 3',
-    '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',
 ]
 keywords = [
     "python",
@@ -93,7 +92,7 @@ minversion = "8.0"
 
 [tool.ruff]
 line-length = 100
-target-version = "py310"
+target-version = "py312"
 src = ["tests", "src", "docs"]
 
 [tool.ruff.lint]
@@ -212,7 +211,7 @@ include = ["src/shapiq"]
 exclude = ["tests", "docs", "benchmark", "scripts", "src/shapiq_games"]
 
 [tool.ty.environment]
-python-version = "3.10"
+python-version = "3.12"
 python = "./.venv"
 python-platform = "linux"
 
@@ -238,8 +237,8 @@ all_ml = [
     "tf-keras; python_version < '3.13' and platform_system != 'Windows'",   # only up to py 3.12
 ]
 test = [
-    "pytest>=8.3.5",        # for running tests
-    "pytest-cov>=6.0.0",    # for coverage
+    "pytest>=9.0.2",        # for running tests
+    "pytest-cov>=7.0.0",    # for coverage
     "pytest-xdist>=3.8.0",  # for parallel test execution
     "packaging",            # for version parsing in tests
 ]
@@ -254,7 +253,6 @@ docs = [
     "myst-parser",              # Markdown support for Sphinx
     "sphinx-copybutton",        # copy button for code blocks
     "sphinx-autodoc-typehints", # include typehints in docs
-    "sphinx_toolbox",           # various sphinx extensions
     "sphinxcontrib-bibtex",     # references based on bibtex
     "nbconvert",                # notebook support for sphinx
     "nbsphinx",                 # notebook support for sphinx

pyproject.toml

@@ -143,6 +143,10 @@
 ]
 
 
-def __getattr__(name: str) -> ModuleType | None:
+def __getattr__(name: str) -> ModuleType:
     """Redirect deprecated imports to the new module."""
-    return try_import_deprecated(name)
+    result = try_import_deprecated(name)
+    if result is None:
+        msg = f"module 'shapiq' has no attribute {name!r}"
+        raise AttributeError(msg)
+    return result