array-api-strict 2.4__tar.gz → 2.4.1__tar.gz

{array_api_strict-2.4 → array_api_strict-2.4.1}/.github/workflows/array-api-tests.yml

@@ -3,7 +3,7 @@ name: Array API Tests
 on: [push, pull_request]
 
 env:
-  PYTEST_ARGS: "-v -rxXfE --hypothesis-disable-deadline --max-examples 200"
+  PYTEST_ARGS: "-v -rxXfE --hypothesis-disable-deadline --max-examples 500 -n 4"
   API_VERSIONS: "2023.12 2024.12"
 
 jobs:
@@ -11,12 +11,16 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.12', '3.13']
-        numpy-version: ['1.26', '2.2', 'dev']
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+        numpy-version: ['1.26', '2.3', 'dev']
         exclude:
+          - python-version: '3.10'
+            numpy-version: '2.3'
+          - python-version: '3.10'
+            numpy-version: 'dev'            
           - python-version: '3.13'
             numpy-version: '1.26'
-
+      fail-fast: false
     steps:
     - name: Checkout array-api-strict
       uses: actions/checkout@v4
@@ -42,7 +46,7 @@ jobs:
         fi
         python -m pip install ${GITHUB_WORKSPACE}/array-api-strict
         python -m pip install -r ${GITHUB_WORKSPACE}/array-api-tests/requirements.txt
-        python -m pip install hypothesis
+        python -m pip install hypothesis pytest-xdist
     - name: Run the array API testsuite
       env:
         ARRAY_API_TESTS_MODULE: array_api_strict

{array_api_strict-2.4 → array_api_strict-2.4.1}/.github/workflows/docs-deploy.yml

@@ -13,7 +13,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Download Artifact
-        uses: dawidd6/action-download-artifact@v10
+        uses: dawidd6/action-download-artifact@v11
         with:
           workflow: docs-build.yml
           name: docs-build

{array_api_strict-2.4 → array_api_strict-2.4.1}/.github/workflows/tests.yml

@@ -6,11 +6,15 @@ jobs:
     strategy:
       matrix:
         python-version: ['3.10', '3.11', '3.12', '3.13']
-        numpy-version: ['1.26', 'dev']
+        numpy-version: ['1.26', '2.3', 'dev']
         exclude:
+          - python-version: '3.10'
+            numpy-version: '2.3'
+          - python-version: '3.10'
+            numpy-version: 'dev'            
           - python-version: '3.13'
             numpy-version: '1.26'
-      fail-fast: true
+      fail-fast: false
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5

{array_api_strict-2.4 → array_api_strict-2.4.1}/CHANGELOG.md

@@ -1,6 +1,32 @@
 # Changelog
 
-## 2.4.0 (XXX)
+## 2.4.1 (2025-07-27)
+
+### Major Changes
+
+- The array object defines `__array__` again when `__buffer__` is not available.
+
+- Support for Python versions 3.10 and 3.11 has been reinstated.
+
+
+### Minor Changes
+
+- Arithmetic operations no longer accept NumPy arrays.
+
+- Disallow `__setitem__` for invalid dtype combinations (e.g. setting a float value
+into an integer array)
+
+
+### Contributors
+
+The following users contributed to this release:
+
+Evgeni Burovski,
+Lucas Colley,
+Guido Imperiale
+
+
+## 2.4.0 (2025-06-16)
 
 ### Major Changes
 
@@ -39,7 +65,7 @@ The following users contributed to this release:
 
 Lumir Balhar,
 Evgeni Burovski,
-Joren Hammudoglu
+Joren Hammudoglu,
 Tim Head,
 Guido Imperiale,
 Lucy Liu

{array_api_strict-2.4/array_api_strict.egg-info → array_api_strict-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: array_api_strict
-Version: 2.4
+Version: 2.4.1
 Summary: A strict, minimal implementation of the Python array API standard.
 Author: Consortium for Python Data API Standards
 License: Copyright (c) 2021-2024, NumPy Developers, Consortium for Python Data API Standards

{array_api_strict-2.4 → array_api_strict-2.4.1}/array_api_strict/_array_object.py

@@ -16,6 +16,7 @@ of ndarray.
 from __future__ import annotations
 
 import operator
+import sys
 from collections.abc import Iterator
 from enum import IntEnum
 from types import EllipsisType, ModuleType
@@ -67,8 +68,6 @@ class Device:
 CPU_DEVICE = Device()
 ALL_DEVICES = (CPU_DEVICE, Device("device1"), Device("device2"))
 
-_default = object()
-
 
 class Array:
     """
@@ -149,29 +148,40 @@ class Array:
 
     __str__ = __repr__
 
-    # `__array__` was implemented historically for compatibility, and removing it has
-    # caused issues for some libraries (see
-    # https://github.com/data-apis/array-api-strict/issues/67).
-
-    # Instead of `__array__` we now implement the buffer protocol.
-    # Note that it makes array-apis-strict requiring python>=3.12
     def __buffer__(self, flags):
         if self._device != CPU_DEVICE:
-            raise RuntimeError(f"Can not convert array on the '{self._device}' device to a Numpy array.")
+            raise RuntimeError(
+                # NumPy swallows this exception and falls back to __array__.
+                f"Can't extract host buffer from array on the '{self._device}' device."
+            )
         return self._array.__buffer__(flags)
 
-    # We do not define __release_buffer__, per the discussion at
-    # https://github.com/data-apis/array-api-strict/pull/115#pullrequestreview-2917178729
-
-    def __array__(self, *args, **kwds):
-        # a stub for python < 3.12; otherwise numpy silently produces object arrays
-        import sys
-        minor, major = sys.version_info.minor, sys.version_info.major
-        if major < 3 or minor < 12:
+    # `__array__` is not part of the Array API. Ideally we want to support
+    # `xp.asarray(Array)` exclusively through the __buffer__ protocol; however this is
+    # only possible on Python >=3.12. Additionally, when __buffer__ raises (e.g. because
+    # the array is not on the CPU device, NumPy will try to fall back on __array__ but,
+    # if that doesn't exist, create a scalar numpy array of objects which contains the
+    # array_api_strict.Array. So we can't get rid of __array__ entirely.
+    def __array__(
+        self, dtype: None | np.dtype[Any] = None, copy: None | bool = None
+    ) -> npt.NDArray[Any]:
+        if self._device != CPU_DEVICE:
+            # We arrive here from np.asarray() on Python >=3.12 when __buffer__ raises.
+            raise RuntimeError(
+                f"Can't convert array on the '{self._device}' device to a "
+                "NumPy array."
+            )
+        if sys.version_info >= (3, 12):
             raise TypeError(
-                "Interoperation with NumPy requires python >= 3.12. Please upgrade."
+                "The __array__ method is not supported by the Array API. "
+                "Please use the __buffer__ interface instead."
             )
 
+        # copy keyword is new in 2.0
+        if np.__version__[0] < '2':
+            return np.asarray(self._array, dtype=dtype)
+        return np.asarray(self._array, dtype=dtype, copy=copy)
+
     # These are various helper functions to make the array behavior match the
     # spec in places where it either deviates from or is more strict than
     # NumPy behavior
@@ -942,6 +952,15 @@ class Array:
         self._validate_index(key, op="setitem")
         # Indexing self._array with array_api_strict arrays can be erroneous
         np_key = key._array if isinstance(key, Array) else key
+
+        # sanitize the value
+        other = value
+        if isinstance(value, (bool, int, float, complex)):
+            other = self._promote_scalar(value)
+        dt = _result_type(self.dtype, other.dtype)
+        if dt != self.dtype:
+            raise TypeError(f"mismatched dtypes: {self.dtype = } and {other.dtype = }")
+
         self._array.__setitem__(np_key, asarray(value)._array)
 
     def __sub__(self, other: Array | complex, /) -> Array:
@@ -1104,6 +1123,7 @@ class Array:
         """
         Performs the operation __imod__.
         """
+        self._check_type_device(other)
         other = self._check_allowed_dtypes(other, "real numeric", "__imod__")
         if other is NotImplemented:
             return other
@@ -1126,6 +1146,7 @@ class Array:
         """
         Performs the operation __imul__.
         """
+        self._check_type_device(other)
         other = self._check_allowed_dtypes(other, "numeric", "__imul__")
         if other is NotImplemented:
             return other
@@ -1148,6 +1169,7 @@ class Array:
         """
         Performs the operation __ior__.
         """
+        self._check_type_device(other)
         other = self._check_allowed_dtypes(other, "integer or boolean", "__ior__")
         if other is NotImplemented:
             return other
@@ -1170,6 +1192,7 @@ class Array:
         """
         Performs the operation __ipow__.
         """
+        self._check_type_device(other)
         other = self._check_allowed_dtypes(other, "numeric", "__ipow__")
         if other is NotImplemented:
             return other
@@ -1182,6 +1205,7 @@ class Array:
         """
         from ._elementwise_functions import pow  # type: ignore[attr-defined]
 
+        self._check_type_device(other)
         other = self._check_allowed_dtypes(other, "numeric", "__rpow__")
         if other is NotImplemented:
             return other
@@ -1193,6 +1217,7 @@ class Array:
         """
         Performs the operation __irshift__.
         """
+        self._check_type_device(other)
         other = self._check_allowed_dtypes(other, "integer", "__irshift__")
         if other is NotImplemented:
             return other
@@ -1215,6 +1240,7 @@ class Array:
         """
         Performs the operation __isub__.
         """
+        self._check_type_device(other)
         other = self._check_allowed_dtypes(other, "numeric", "__isub__")
         if other is NotImplemented:
             return other
@@ -1237,6 +1263,7 @@ class Array:
         """
         Performs the operation __itruediv__.
         """
+        self._check_type_device(other)
         other = self._check_allowed_dtypes(other, "floating-point", "__itruediv__")
         if other is NotImplemented:
             return other
@@ -1259,6 +1286,7 @@ class Array:
         """
         Performs the operation __ixor__.
         """
+        self._check_type_device(other)
         other = self._check_allowed_dtypes(other, "integer or boolean", "__ixor__")
         if other is NotImplemented:
             return other

{array_api_strict-2.4 → array_api_strict-2.4.1}/array_api_strict/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '2.4'
-__version_tuple__ = version_tuple = (2, 4)
+__version__ = version = '2.4.1'
+__version_tuple__ = version_tuple = (2, 4, 1)

{array_api_strict-2.4 → array_api_strict-2.4.1}/array_api_strict/tests/test_array_object.py

@@ -18,12 +18,14 @@ from .._dtypes import (
     _integer_or_boolean_dtypes,
     _real_numeric_dtypes,
     _numeric_dtypes,
+    uint8,
     int8,
     int16,
     int32,
     int64,
     uint64,
     float64,
+    complex128,
     bool as bool_,
 )
 from .._flags import set_array_api_strict_flags
@@ -193,6 +195,29 @@ def test_indexing_arrays_different_devices():
         a[idx1, idx2]
 
 
+def test_setitem_invalid_promotions():
+    # Check that violating these two raises:
+    #   Setting array values must not affect the data type of self, and
+    #   Behavior must otherwise follow Type Promotion Rules.
+    a = asarray([1, 2, 3])
+    with pytest.raises(TypeError):
+        a[0] = 3.5
+
+    with pytest.raises(TypeError):
+        a[0] = asarray(3.5)
+
+    a = asarray([1, 2, 3], dtype=uint8)
+    with pytest.raises(TypeError):
+        a[0] = asarray(42, dtype=uint64)
+
+    a = asarray([1, 2, 3], dtype=float64)
+    with pytest.raises(TypeError):
+        a[0] = 3.5j
+
+    with pytest.raises(TypeError):
+        a[0] = asarray(3.5j, dtype=complex128)
+
+
 def test_promoted_scalar_inherits_device():
     device1 = Device("device1")
     x = asarray([1., 2, 3], device=device1)
@@ -344,6 +369,13 @@ def test_operators():
                                 getattr(x, _op)(y)
                             else:
                                 assert_raises(TypeError, lambda: getattr(x, _op)(y))
+                            # finally, test that array op ndarray raises
+                            # XXX: as long as there is __array__ or __buffer__, __rop__s
+                            #  still return ndarrays
+                            if not _op.startswith("__r"):
+                                with assert_raises(TypeError):
+                                    getattr(x, _op)(y._array)
+
 
     for op, dtypes in unary_op_dtypes.items():
         for a in _array_vals():
@@ -527,36 +559,54 @@ def test_array_properties():
     assert b.mT.shape == (3, 2)
 
 
-@pytest.mark.xfail(sys.version_info.major*100 + sys.version_info.minor < 312,
-                   reason="array conversion relies on buffer protocol, and "
-                          "requires python >= 3.12"
-)
 def test_array_conversion():
     # Check that arrays on the CPU device can be converted to NumPy
     # but arrays on other devices can't. Note this is testing the logic in
-    # __array__, which is only used in asarray when converting lists of
-    # arrays.
+    # __array__ on Python 3.10~3.11 and in __buffer__ on Python >=3.12.
     a = ones((2, 3))
-    np.asarray(a)
+    na = np.asarray(a)
+    assert na.shape == (2, 3)
+    assert na.dtype == np.float64
+    na[0, 0] = 10
+    assert a[0, 0] == 10  # return view when possible
+
+    a = arange(5, dtype=uint8)
+    na = np.asarray(a)
+    assert na.dtype == np.uint8
 
     for device in ("device1", "device2"):
         a = ones((2, 3), device=array_api_strict.Device(device))
-        with pytest.raises((RuntimeError, ValueError)):
+        with pytest.raises(RuntimeError, match=device):
             np.asarray(a)
 
-    # __buffer__ should work for now for conversion to numpy
-    a = ones((2, 3))
-    na = np.array(a)
-    assert na.shape == (2, 3)
-    assert na.dtype == np.float64
 
-@pytest.mark.skipif(not sys.version_info.major*100 + sys.version_info.minor < 312,
-                    reason="conversion to numpy errors out unless python >= 3.12"
+@pytest.mark.skipif(np.__version__ < "2", reason="np.asarray has no copy kwarg")
+def test_array_conversion_copy():
+    a = arange(5)
+    na = np.asarray(a, copy=False)
+    na[0] = 10
+    assert a[0] == 10
+
+    a = arange(5)
+    na = np.asarray(a, copy=True)
+    na[0] = 10
+    assert a[0] == 0
+
+    a = arange(5)
+    with pytest.raises(ValueError):
+        np.asarray(a, dtype=np.uint8, copy=False)
+
+
+@pytest.mark.skipif(
+    sys.version_info < (3, 12), reason="Python <3.12 has no __buffer__ interface"
 )
-def test_array_conversion_2():
+def test_no_array_interface():
+    """When the __buffer__ interface is available, the __array__ interface is not."""
     a = ones((2, 3))
-    with pytest.raises(TypeError):
-        np.array(a)
+    with pytest.raises(TypeError, match="not supported"):
+        # Because NumPy prefers __buffer__ when available, we can't trigger this
+        # exception from np.asarray().
+        a.__array__()
 
 
 def test_allow_newaxis():

{array_api_strict-2.4 → array_api_strict-2.4.1/array_api_strict.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: array_api_strict
-Version: 2.4
+Version: 2.4.1
 Summary: A strict, minimal implementation of the Python array API standard.
 Author: Consortium for Python Data API Standards
 License: Copyright (c) 2021-2024, NumPy Developers, Consortium for Python Data API Standards

{array_api_strict-2.4 → array_api_strict-2.4.1}/docs/changelog.md

@@ -1,6 +1,32 @@
 # Changelog
 
-## 2.4.0 (XXX)
+## 2.4.1 (2025-07-27)
+
+### Major Changes
+
+- The array object defines `__array__` again when `__buffer__` is not available.
+
+- Support for Python versions 3.10 and 3.11 has been reinstated.
+
+
+### Minor Changes
+
+- Arithmetic operations no longer accept NumPy arrays.
+
+- Disallow `__setitem__` for invalid dtype combinations (e.g. setting a float value
+into an integer array)
+
+
+### Contributors
+
+The following users contributed to this release:
+
+Evgeni Burovski,
+Lucas Colley,
+Guido Imperiale
+
+
+## 2.4.0 (2025-06-16)
 
 ### Major Changes
 
@@ -39,7 +65,7 @@ The following users contributed to this release:
 
 Lumir Balhar,
 Evgeni Burovski,
-Joren Hammudoglu
+Joren Hammudoglu,
 Tim Head,
 Guido Imperiale,
 Lucy Liu