Compatibility policy and validation

Protspect requires Python >=3.10. The CI target is CPython 3.10–3.15 on Linux, macOS, and Windows. All 21 installed-distribution jobs passed, along with the build/lint/test job. The run linked below records the actual platform results.

Each of the 18 latest-compatible dependency jobs installs both the wheel and source distribution in separate fresh virtual environments outside the checkout. It checks core-only imports, the legacy namespace, numerical tests, examples, then optional ML/validation dependencies, the full test suite, and plotting. Three additional Python 3.10 jobs use exact minimum versions on each OS. Logs and resolved dependency versions are uploaded as CI artifacts. One test requiring original Git history skips outside a checkout; it runs in the build job.

Dependency bounds

Dependency

Minimum

Reason/evidence

NumPy

1.23

Exact minimum tested with Python 3.10

SciPy

1.9

Exact minimum tested with Python 3.10

pandas

1.5

Exact minimum tested with Python 3.10

scikit-learn (optional)

1.4

1.2 fails pandas output for list input; 1.4 passes

Matplotlib (validation)

3.6

Exact minimum plotting smoke test

threadpoolctl (validation)

3

Exact minimum tested

setuptools (build)

77

PEP 639 license metadata; first available release 77.0.1 tested

The scikit-learn 1.2 failure is triggered by SpectralTransformer().set_output(transform="pandas") with a list of sequences: its output wrapper treats the list’s index method as a pandas index. The minimum is raised to 1.4, whose pandas adapter handles list input correctly.

No speculative upper bounds are imposed. CI resolves a coherent latest stack for each interpreter; arbitrary mixtures of old and new dependency versions, PyPy, free-threaded builds, and additional architectures are not established by this matrix. The research notebook has its own pinned Python 3.12 environment.

Verified environments

OS

Latest compatible stack

Exact minimum stack

Linux

CPython 3.10–3.15: passed

CPython 3.10: passed

macOS

CPython 3.10–3.15: passed

CPython 3.10: passed

Windows

CPython 3.10–3.15: passed

CPython 3.10: passed

Each installed-distribution job runs the wheel and source suites separately. The full optional suite passes 74 tests per artifact, with the one expected Git-history skip. The source-checkout build job passes all 75 tests.

Local evidence

Fresh wheel and source installs passed on macOS arm64 with CPython 3.14.10 and 3.15.2 using current dependencies. The minimum Python 3.10.22 wheel and source checks each passed 74 tests with one expected checkout-only skip.

Remote platform verification passed all 22 checks in GitHub Actions run 40532904693 for commit 8e066b2, reviewed in PR #2.

Run the same checks after building with:

python ci/check_installed.py --output-dir compatibility-results
python ci/check_installed.py --constraints ci/constraints/minimum.txt --output-dir minimum-results