cvmatrix 3.2.1__tar.gz → 3.2.3__tar.gz

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/.github/actions/build/action.yml

@@ -4,12 +4,12 @@ description: Build the package
 runs:
    using: "composite"
    steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v7
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v5
+      uses: astral-sh/setup-uv@v7
       with:
-        python-version: '3.14'
+        python-version: '3.15'
 
     - name: Lint with ruff
       run: |
@@ -28,7 +28,7 @@ runs:
       shell: bash
 
     - name: Store the distribution packages
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: python-package-distributions
         path: dist/

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/.github/actions/release/action.yml

@@ -11,12 +11,12 @@ runs:
           echo "VERSION=$version" >> $GITHUB_ENV
         shell: bash
       - name: Download all the dists
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: python-package-distributions
           path: dist/
       - name: Sign the dists with Sigstore
-        uses: sigstore/gh-action-sigstore-python@v3.0.0
+        uses: sigstore/gh-action-sigstore-python@v3.4.0
         with:
           inputs: >-
             ./dist/*.tar.gz

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/.github/actions/test/action.yml

@@ -14,7 +14,7 @@ runs:
   using: "composite"
   steps:
     - name: Install uv
-      uses: astral-sh/setup-uv@v5
+      uses: astral-sh/setup-uv@v7
       with:
         python-version: ${{ inputs.PYTHON_VERSION }}
 
@@ -33,5 +33,7 @@ runs:
     # are skipped (pytest.importorskip), verifying the numpy-only path.
     - name: Run tests
       run: |
-        uv run pytest tests --doctest-modules --junitxml=junit/test-results.xml --cov=cvmatrix/ --cov-report=xml --typeguard-packages=cvmatrix/
+        # NOTE: --typeguard-packages takes the PACKAGE name "cvmatrix" (not a path); a
+        # trailing slash silently instruments nothing, disabling runtime type checks.
+        uv run pytest tests --doctest-modules --junitxml=junit/test-results.xml --cov=cvmatrix/ --cov-report=xml --typeguard-packages=cvmatrix
       shell: bash

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/.github/workflows/package_workflow.yml

@@ -10,7 +10,7 @@ jobs:
     build_package:
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v4
+            - uses: actions/checkout@v7
             - uses: ./.github/actions/build
 
     publish_package:
@@ -18,8 +18,8 @@ jobs:
         runs-on: ubuntu-latest
         if: ${{ github.event.workflow_run.conclusion == 'success' }}
         steps:  
-            - uses: actions/checkout@v4
-            - uses: actions/download-artifact@v4
+            - uses: actions/checkout@v7
+            - uses: actions/download-artifact@v8
               with:
                 name: python-package-distributions
                 path: dist/
@@ -41,5 +41,5 @@ jobs:
             contents: write
             id-token: write
         steps:
-            - uses: actions/checkout@v4
+            - uses: actions/checkout@v7
             - uses: ./.github/actions/release

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/.github/workflows/pull_request_package_workflow.yml

@@ -14,5 +14,5 @@ jobs:
     build_package:
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v4
+            - uses: actions/checkout@v7
             - uses: ./.github/actions/build

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/.github/workflows/pull_request_test_workflow.yml

@@ -18,9 +18,9 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ["3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
       - uses: ./.github/actions/test
         with:
           PYTHON_VERSION: ${{ matrix.python-version }}
@@ -42,9 +42,9 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ["3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
       - uses: ./.github/actions/test
         with:
           PYTHON_VERSION: ${{ matrix.python-version }}

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/.github/workflows/test_workflow.yml

@@ -18,9 +18,9 @@ jobs:
             fail-fast: false
             matrix:
                 os: [ubuntu-latest, windows-latest, macos-latest]
-                python-version: ["3.11", "3.12", "3.13", "3.14"]
+                python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
         steps:
-            - uses: actions/checkout@v4
+            - uses: actions/checkout@v7
             - uses: ./.github/actions/test
               with:
                     PYTHON_VERSION: ${{ matrix.python-version }}
@@ -42,9 +42,9 @@ jobs:
             fail-fast: false
             matrix:
                 os: [ubuntu-latest, windows-latest, macos-latest]
-                python-version: ["3.11", "3.12", "3.13", "3.14"]
+                python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
         steps:
-            - uses: actions/checkout@v4
+            - uses: actions/checkout@v7
             - uses: ./.github/actions/test
               with:
                     PYTHON_VERSION: ${{ matrix.python-version }}

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.2.3] - 2026-10-30
+- Increased the maximum supported Python version from 3.14 to 3.15. Python 3.15 is now included in the CI test matrices. No functional changes.
+
+## [3.2.2] - 2026-07-06
+
+### Changed
+- Lowered the minimum supported Python version from 3.11 to 3.10 (`requires-python = ">=3.10, <3.15"`). The code base uses no Python-3.11-only features; this broadens compatibility for downstream packages that still support Python 3.10. Python 3.10 is now included in the CI test matrices. No functional changes.
+
+### Fixed
+- The fold-index parameters (`validation_indices` / `val_indices`) are now annotated with a new `IndexArray` alias that `_enable_jax_typing()` broadens to admit `jax.Array`, matching the `Array`/`Scalar` aliases introduced in 3.2.1. Previously they were annotated as `npt.NDArray[np.int_]` only, so running the test suite with `typeguard` instrumentation enabled failed on the `jax.jit`/`jax.vmap` trace tests (the indices are abstract tracers under tracing). Runtime behavior is unchanged; this only affects runtime type checking.
+- CI now actually enables `typeguard` instrumentation during tests: the test command passed `--typeguard-packages=cvmatrix/` (a path, with a trailing slash) instead of the package name `cvmatrix`, which silently instrumented nothing and masked the annotation issue above.
+
 ## [3.2.1] - 2026-07-01
 
 ### Changed

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: cvmatrix
-Version: 3.2.1
+Version: 3.2.3
 Summary: Fast computation of possibly weighted and possibly centered/scaled training set kernel matrices in a cross-validation setting.
 Project-URL: Homepage, https://cvmatrix.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/Sm00thix/CVMatrix
@@ -8,11 +8,13 @@ Author-email: Sm00thix <oleemail@icloud.com>
 Maintainer-email: Sm00thix <oleemail@icloud.com>
 License-Expression: Apache-2.0
 License-File: LICENSE
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: <3.15,>=3.11
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: <3.16,>=3.10
 Requires-Dist: numpy<3.0.0,>=2.0.0
 Provides-Extra: jax
 Requires-Dist: jax>=0.4.0; extra == 'jax'
@@ -32,6 +34,8 @@ Description-Content-Type: text/markdown
 
 [![Documentation Status](https://readthedocs.org/projects/cvmatrix/badge/?version=latest)](https://cvmatrix.readthedocs.io/en/latest/?badge=latest)
 
+[![CodeFactor](https://www.codefactor.io/repository/github/sm00thix/cvmatrix/badge/main)](https://www.codefactor.io/repository/github/sm00thix/cvmatrix/overview/main)
+
 [![Tests Status](https://github.com/Sm00thix/CVMatrix/actions/workflows/test_workflow.yml/badge.svg)](https://github.com/Sm00thix/CVMatrix/actions/workflows/test_workflow.yml)
 
 [![Test Coverage](https://coveralls.io/repos/github/sm00thix/cvmatrix/badge.svg?branch=main)](https://coveralls.io/github/sm00thix/cvmatrix?branch=main)
@@ -44,6 +48,10 @@ For an implementation of the fast cross-validation algorithms combined with Impr
 
 The `cvmatrix` software package now also features **weigthed matrix produts** $\mathbf{X}^{\mathbf{T}}\mathbf{W}\mathbf{Y}$ **without increasing time or space complexity compared to the unweighted case**. This is due to a generalization of the algorithms by Engstrøm and Jensen [[1]](#references). A new article formally describing the generalization is to be announced.
 
+## Citation
+- If you use the `cvmatrix` software package for your work, please cite  [this Journal of Chemometrics article](https://analyticalsciencejournals.onlinelibrary.wiley.com/doi/full/10.1002/cem.70008).
+- If you use the sample weighted option, please also cite [this PhD thesis](https://arxiv.org/abs/2510.13452).
+
 ## Installation
 
 - Install the package for Python3 using the following command:

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/README.md

@@ -12,6 +12,8 @@
 
 [![Documentation Status](https://readthedocs.org/projects/cvmatrix/badge/?version=latest)](https://cvmatrix.readthedocs.io/en/latest/?badge=latest)
 
+[![CodeFactor](https://www.codefactor.io/repository/github/sm00thix/cvmatrix/badge/main)](https://www.codefactor.io/repository/github/sm00thix/cvmatrix/overview/main)
+
 [![Tests Status](https://github.com/Sm00thix/CVMatrix/actions/workflows/test_workflow.yml/badge.svg)](https://github.com/Sm00thix/CVMatrix/actions/workflows/test_workflow.yml)
 
 [![Test Coverage](https://coveralls.io/repos/github/sm00thix/cvmatrix/badge.svg?branch=main)](https://coveralls.io/github/sm00thix/cvmatrix?branch=main)
@@ -24,6 +26,10 @@ For an implementation of the fast cross-validation algorithms combined with Impr
 
 The `cvmatrix` software package now also features **weigthed matrix produts** $\mathbf{X}^{\mathbf{T}}\mathbf{W}\mathbf{Y}$ **without increasing time or space complexity compared to the unweighted case**. This is due to a generalization of the algorithms by Engstrøm and Jensen [[1]](#references). A new article formally describing the generalization is to be announced.
 
+## Citation
+- If you use the `cvmatrix` software package for your work, please cite  [this Journal of Chemometrics article](https://analyticalsciencejournals.onlinelibrary.wiley.com/doi/full/10.1002/cem.70008).
+- If you use the sample weighted option, please also cite [this PhD thesis](https://arxiv.org/abs/2510.13452).
+
 ## Installation
 
 - Install the package for Python3 using the following command:

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/cvmatrix/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "3.2.1"
+__version__ = "3.2.3"
 __all__ = ["CVMatrix", "Partitioner"]
 from .cvmatrix import CVMatrix
 from .partitioner import Partitioner

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/cvmatrix/cvmatrix.py

@@ -26,6 +26,9 @@ from numpy import typing as npt
 # globals at call time, so the broadened unions take effect once JAX is in use.
 Array = np.ndarray
 Scalar = Union[np.floating, float, int]
+# Integer index arrays (fold validation indices). Under jax.jit/jax.vmap these are
+# abstract tracers, so the alias is broadened alongside ``Array``/``Scalar``.
+IndexArray = npt.NDArray[np.int_]
 # ``dtype`` specifier: ``npt.DTypeLike`` cleanly admits both numpy float types and
 # JAX scalar dtypes (e.g. ``jnp.float64``) without importing JAX.
 FloatDType = npt.DTypeLike
@@ -49,9 +52,10 @@ def _enable_jax_typing() -> None:
     """
     import jax
 
-    global Array, Scalar, _TRACER_TYPES
+    global Array, Scalar, IndexArray, _TRACER_TYPES
     Array = Union[np.ndarray, jax.Array]
     Scalar = Union[np.floating, jax.Array, float, int]
+    IndexArray = Union[npt.NDArray[np.int_], jax.Array]
     _TRACER_TYPES = (jax.core.Tracer,)
 
 
@@ -328,10 +332,8 @@ class CVMatrix:
         self._init_stats()
 
     def training_XTX(
-        self, validation_indices: npt.NDArray[np.int_]
-    ) -> Tuple[
-        Array, Tuple[Optional[Array], Optional[Array], None, None]
-    ]:
+        self, validation_indices: IndexArray
+    ) -> Tuple[Array, Tuple[Optional[Array], Optional[Array], None, None]]:
         r"""
         Computes the training set :math:`\mathbf{X}^{\mathbf{T}}\mathbf{W}\mathbf{X}`
         corresponding to every sample except those at the `validation_indices`. Also
@@ -340,7 +342,7 @@ class CVMatrix:
 
         Parameters
         ----------
-        validation_indices : npt.NDArray[np.int_]
+        validation_indices : IndexArray
             An integer array of indices for the validation set for which to
             return the corresponding training set
             :math:`\mathbf{X}^{\mathbf{T}}\mathbf{W}\mathbf{X}`. The validation indices
@@ -383,7 +385,7 @@ class CVMatrix:
         return self._training_matrices(True, False, validation_indices)
 
     def training_XTY(
-        self, validation_indices: npt.NDArray[np.int_]
+        self, validation_indices: IndexArray
     ) -> Tuple[
         Array,
         Tuple[
@@ -403,7 +405,7 @@ class CVMatrix:
 
         Parameters
         ----------
-        validation_indices : npt.NDArray[np.int_]
+        validation_indices : IndexArray
             An integer array of indices for the validation set for which to
             return the corresponding training set
             :math:`\mathbf{X}^{\mathbf{T}}\mathbf{W}\mathbf{Y}`. The validation indices
@@ -449,7 +451,7 @@ class CVMatrix:
         return self._training_matrices(False, True, validation_indices)
 
     def training_XTX_XTY(
-        self, validation_indices: npt.NDArray[np.int_]
+        self, validation_indices: IndexArray
     ) -> Tuple[
         Tuple[Array, Array],
         Tuple[
@@ -471,7 +473,7 @@ class CVMatrix:
 
         Parameters
         ----------
-        validation_indices : npt.NDArray[np.int_]
+        validation_indices : IndexArray
             An integer array of indices for the validation set for which to
             return the corresponding training set
             :math:`\mathbf{X}^{\mathbf{T}}\mathbf{W}\mathbf{X}` and
@@ -517,7 +519,7 @@ class CVMatrix:
         return self._training_matrices(True, True, validation_indices)
 
     def training_statistics(
-        self, validation_indices: npt.NDArray[np.int_]
+        self, validation_indices: IndexArray
     ) -> Tuple[
         Optional[Array],
         Optional[Array],
@@ -587,7 +589,7 @@ class CVMatrix:
         return x
 
     def _get_sum_w_train_and_num_nonzero_w_train(
-        self, val_indices: npt.NDArray[np.int_]
+        self, val_indices: IndexArray
     ) -> Tuple[Scalar, Scalar]:
         """
         Returns a tuple containing the sum of weights in the training set and the number
@@ -631,7 +633,7 @@ class CVMatrix:
 
     def _compute_training_stats(
         self,
-        val_indices: npt.NDArray[np.int_],
+        val_indices: IndexArray,
         X_val: Optional[Array],
         Y_val: Optional[Array],
         return_X_mean: bool,
@@ -752,7 +754,7 @@ class CVMatrix:
         )
 
     def _training_matrices(
-        self, return_XTX: bool, return_XTY: bool, val_indices: npt.NDArray[np.int_]
+        self, return_XTX: bool, return_XTY: bool, val_indices: IndexArray
     ) -> Tuple[
         Union[Array, Tuple[Array, Array]],
         Tuple[
@@ -777,7 +779,7 @@ class CVMatrix:
             Whether to return the training set
             :math:`\mathbf{X}^{\mathbf{T}}\mathbf{W}\mathbf{Y}`.
 
-        validation_indices : npt.NDArray[np.int_]
+        validation_indices : IndexArray
             An integer array of indices for the validation set for which to
             return the corresponding training set
             :math:`\mathbf{X}^{\mathbf{T}}\mathbf{W}\mathbf{X}` and
@@ -896,7 +898,7 @@ class CVMatrix:
         )
 
     def _get_val_matrices(
-        self, val_indices: npt.NDArray[np.int_], return_XTY: bool
+        self, val_indices: IndexArray, return_XTY: bool
     ) -> Tuple[
         Array,
         Array,

{cvmatrix-3.2.1 → cvmatrix-3.2.3}/pyproject.toml

@@ -1,17 +1,19 @@
 [project]
 name = "cvmatrix"
-version = "3.2.1"
+version = "3.2.3"
 description = "Fast computation of possibly weighted and possibly centered/scaled training set kernel matrices in a cross-validation setting."
 authors = [{ name = "Sm00thix", email = "oleemail@icloud.com" }]
 maintainers = [{ name = "Sm00thix", email = "oleemail@icloud.com" }]
 license = "Apache-2.0"
 readme = "README.md"
-requires-python = ">=3.11, <3.15"
+requires-python = ">=3.10, <3.16"
 classifiers = [
+    "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.15",
 ]
 dependencies = [
     "numpy>=2.0.0,<3.0.0",