decent-array 0.2.2__tar.gz → 0.2.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. {decent_array-0.2.2 → decent_array-0.2.4}/PKG-INFO +1 -1
  2. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/_array.py +12 -0
  3. decent_array-0.2.4/decent_array/_constants.py +25 -0
  4. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_backend_manager.py +21 -3
  5. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/types/_dtypes.py +3 -6
  6. {decent_array-0.2.2 → decent_array-0.2.4}/pyproject.toml +1 -1
  7. {decent_array-0.2.2 → decent_array-0.2.4}/tests/test_array.py +31 -1
  8. {decent_array-0.2.2 → decent_array-0.2.4}/tests/test_backend_manager.py +9 -2
  9. decent_array-0.2.4/tests/test_bindings.py +92 -0
  10. decent_array-0.2.2/decent_array/_constants.py +0 -10
  11. {decent_array-0.2.2 → decent_array-0.2.4}/.github/CODEOWNERS +0 -0
  12. {decent_array-0.2.2 → decent_array-0.2.4}/.github/dependabot.yml +0 -0
  13. {decent_array-0.2.2 → decent_array-0.2.4}/.github/workflows/ci.yaml +0 -0
  14. {decent_array-0.2.2 → decent_array-0.2.4}/.gitignore +0 -0
  15. {decent_array-0.2.2 → decent_array-0.2.4}/LICENSE +0 -0
  16. {decent_array-0.2.2 → decent_array-0.2.4}/README.md +0 -0
  17. {decent_array-0.2.2 → decent_array-0.2.4}/benchmarks/bench_array.py +0 -0
  18. {decent_array-0.2.2 → decent_array-0.2.4}/benchmarks/bench_common.py +0 -0
  19. {decent_array-0.2.2 → decent_array-0.2.4}/benchmarks/bench_iop.py +0 -0
  20. {decent_array-0.2.2 → decent_array-0.2.4}/benchmarks/profile_hotpath.py +0 -0
  21. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/__init__.py +0 -0
  22. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/_errors.py +0 -0
  23. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/_utils.py +0 -0
  24. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/__init__.py +0 -0
  25. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_abstracts/__init__.py +0 -0
  26. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_abstracts/backend.py +0 -0
  27. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/__init__.py +0 -0
  28. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/bit_operators.py +0 -0
  29. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/comparison.py +0 -0
  30. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/creation.py +0 -0
  31. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/linalg.py +0 -0
  32. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/manipulations.py +0 -0
  33. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/math.py +0 -0
  34. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/operators.py +0 -0
  35. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/reductions.py +0 -0
  36. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/rng.py +0 -0
  37. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_iop/utils.py +0 -0
  38. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_jax/__init__.py +0 -0
  39. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_jax/jax_backend.py +0 -0
  40. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_numpy/__init__.py +0 -0
  41. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_numpy/numpy_backend.py +0 -0
  42. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_pytorch/__init__.py +0 -0
  43. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_pytorch/pytorch_backend.py +0 -0
  44. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_tensorflow/__init__.py +0 -0
  45. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/interoperability/_tensorflow/tensorflow_backend.py +0 -0
  46. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/py.typed +0 -0
  47. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/types/__init__.py +0 -0
  48. {decent_array-0.2.2 → decent_array-0.2.4}/decent_array/types/_types.py +0 -0
  49. {decent_array-0.2.2 → decent_array-0.2.4}/docs/Makefile +0 -0
  50. {decent_array-0.2.2 → decent_array-0.2.4}/docs/make.bat +0 -0
  51. {decent_array-0.2.2 → decent_array-0.2.4}/docs/requirements.txt +0 -0
  52. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/_static/custom.css +0 -0
  53. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/_static/logo.png +0 -0
  54. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/_templates/module.rst.jinja +0 -0
  55. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/_templates/package.rst.jinja +0 -0
  56. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/api/decent_array.array.rst +0 -0
  57. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/api/decent_array.interoperability.rst +0 -0
  58. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/api/decent_array.rst +0 -0
  59. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/api/decent_array.types.rst +0 -0
  60. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/author.rst +0 -0
  61. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/conf.py +0 -0
  62. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/developer.rst +0 -0
  63. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/index.rst +0 -0
  64. {decent_array-0.2.2 → decent_array-0.2.4}/docs/source/user.rst +0 -0
  65. {decent_array-0.2.2 → decent_array-0.2.4}/readthedocs.yaml +0 -0
  66. {decent_array-0.2.2 → decent_array-0.2.4}/tests/conftest.py +0 -0
  67. {decent_array-0.2.2 → decent_array-0.2.4}/tests/test_dtypes.py +0 -0
  68. {decent_array-0.2.2 → decent_array-0.2.4}/tests/test_iop_functions.py +0 -0
  69. {decent_array-0.2.2 → decent_array-0.2.4}/tests/test_iop_rng.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: decent-array
3
- Version: 0.2.2
3
+ Version: 0.2.4
4
4
  Summary: A library of array operations and linear algebra primitives for interoperability across ML frameworks.
5
5
  Project-URL: Documentation, https://decent-array.readthedocs.io/en/latest/
6
6
  Project-URL: Source, https://github.com/team-decent/decent-array
@@ -26,6 +26,7 @@ Hot-path notes:
26
26
 
27
27
  from __future__ import annotations
28
28
 
29
+ from collections.abc import Callable
29
30
  from typing import TYPE_CHECKING, Any, Self
30
31
 
31
32
  from decent_array.interoperability._backend_manager import register_backend_listener
@@ -49,6 +50,11 @@ def _update_backend(backend: Backend | None) -> None:
49
50
  register_backend_listener(_update_backend)
50
51
 
51
52
 
53
+ def _reconstruct_array(value: ArrayTypes) -> Array:
54
+ """Reconstruct array after pickling."""
55
+ return Array(value)
56
+
57
+
52
58
  class Array:
53
59
  """
54
60
  Wrapper around a single backend-native array.
@@ -391,6 +397,12 @@ class Array:
391
397
  memo[id(self)] = copied
392
398
  return copied
393
399
 
400
+ # Pickle/unpickle --------------------------------------------------------
401
+
402
+ def __reduce__(self) -> tuple[Callable[..., Array], tuple[ArrayTypes]]:
403
+ """Handle unpickling of the array."""
404
+ return (_reconstruct_array, (self.value,))
405
+
394
406
  # Properties -----------------------------------------------------------
395
407
 
396
408
  @property
@@ -0,0 +1,25 @@
1
+ """Numerical constants."""
2
+
3
+ import math
4
+
5
+ _CONSTANTS = {
6
+ "e": math.e,
7
+ "inf": math.inf,
8
+ "nan": math.nan,
9
+ "pi": math.pi,
10
+ }
11
+
12
+ e = _CONSTANTS["e"]
13
+ inf = _CONSTANTS["inf"]
14
+ nan = _CONSTANTS["nan"]
15
+ pi = _CONSTANTS["pi"]
16
+
17
+
18
+ def _reset() -> None:
19
+ """Set/reset constants to the Python math defaults."""
20
+ global e, inf, nan, pi # noqa: PLW0603
21
+
22
+ e = _CONSTANTS["e"]
23
+ inf = _CONSTANTS["inf"]
24
+ nan = _CONSTANTS["nan"]
25
+ pi = _CONSTANTS["pi"]
@@ -131,6 +131,17 @@ def reset_backends() -> None:
131
131
  for listener in _BACKEND_LISTENERS:
132
132
  listener(None)
133
133
 
134
+ # clear dtypes bindings
135
+ for dt in dtypes._ALL_DTYPES: # noqa: SLF001
136
+ dt._available = False # noqa: SLF001
137
+ dt._backend_dtype = None # noqa: SLF001
138
+
139
+ dtypes._AVAILABLE_DTYPES.clear() # noqa: SLF001
140
+ dtypes._BACKEND_DTYPE_TO_DTYPE.clear() # noqa: SLF001
141
+
142
+ # clear constants bindings, restoring to Python math defaults
143
+ constants._reset() # noqa: SLF001
144
+
134
145
 
135
146
  def default_device() -> Devices:
136
147
  """
@@ -219,6 +230,14 @@ def _bind_dtypes(backend: Backend | None) -> None:
219
230
  dt._available = backend_dt is not None # noqa: SLF001
220
231
  dt._backend_dtype = backend_dt # noqa: SLF001
221
232
 
233
+ # refresh caches of available dtypes and reverse mapping
234
+ dtypes._AVAILABLE_DTYPES.clear() # noqa: SLF001
235
+ dtypes._AVAILABLE_DTYPES.update(dt for dt in dtypes._ALL_DTYPES if dt.available) # noqa: SLF001
236
+
237
+ dtypes._BACKEND_DTYPE_TO_DTYPE.clear() # noqa: SLF001
238
+ for dt in dtypes._AVAILABLE_DTYPES: # noqa: SLF001
239
+ dtypes._BACKEND_DTYPE_TO_DTYPE[dt.backend_dtype] = dt # noqa: SLF001
240
+
222
241
 
223
242
  def _bind_constants(backend: Backend | None) -> None:
224
243
  """Bind constants to the corresponding backend constants."""
@@ -226,6 +245,5 @@ def _bind_constants(backend: Backend | None) -> None:
226
245
  return
227
246
  for name in constants._CONSTANTS: # noqa: SLF001
228
247
  backend_c = getattr(backend, name, None)
229
- if backend_c is None:
230
- return
231
- setattr(constants, name, backend_c)
248
+ if backend_c is not None:
249
+ setattr(constants, name, backend_c)
@@ -74,7 +74,7 @@ class dtype: # noqa: N801
74
74
  """Check equivalence by ``name`` attributes."""
75
75
  if not isinstance(other, dtype):
76
76
  return NotImplemented
77
- return self.name == other.name and self.available and other.available
77
+ return self.name == other.name
78
78
 
79
79
  def __hash__(self) -> int:
80
80
  """Hash of the dtype."""
@@ -131,12 +131,9 @@ _NUMERIC_DTYPES = _INTEGRAL_DTYPES | _REAL_FLOATING_DTYPES | _COMPLEX_FLOATING_D
131
131
  _ALL_DTYPES = _BOOL_DTYPES | _NUMERIC_DTYPES | _MISCELLANEOUS_DTYPES
132
132
 
133
133
 
134
- _AVAILABLE_DTYPES = {dt for dt in _ALL_DTYPES if dt.available}
135
-
136
-
134
+ # caches for available dtypes and reverse mapping; these are populated during set_backend
135
+ _AVAILABLE_DTYPES: set[dtype] = set()
137
136
  _BACKEND_DTYPE_TO_DTYPE: dict[Any, dtype] = {}
138
- for dt in _AVAILABLE_DTYPES:
139
- _BACKEND_DTYPE_TO_DTYPE[dt._backend_dtype] = dt # noqa: SLF001
140
137
 
141
138
 
142
139
  _ALIASES = {
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "decent-array"
3
- version = "0.2.2"
3
+ version = "0.2.4"
4
4
  authors = [{name = "Simon Granström"}, {name = "Nicola Bastianello"}]
5
5
  maintainers = [{name = "Team Decent"}]
6
6
  description = "A library of array operations and linear algebra primitives for interoperability across ML frameworks."
@@ -575,9 +575,39 @@ def test_item_n_dim(backend: tuple) -> None:
575
575
  def test_deepcopy(backend: tuple) -> None:
576
576
  from copy import deepcopy
577
577
 
578
- src = iop.from_numpy(np.array([1.0, 2.0, 3.0], dtype=np.float32))
578
+ src = _create_array([1.0, 2.0, 3.0])
579
579
  dst = deepcopy(src)
580
580
  np.testing.assert_allclose(_np(dst), [1.0, 2.0, 3.0])
581
581
  # Mutating the copy shouldn't affect the original.
582
582
  dst[0] = 99.0
583
583
  np.testing.assert_allclose(_np(src), [1.0, 2.0, 3.0])
584
+
585
+
586
+ # Pickle/unpickle --------------------------------------------------------
587
+
588
+
589
+ def test_pickle(backend: tuple) -> None:
590
+ import pickle
591
+
592
+ original = _create_array([1.0, 2.0, 3.0])
593
+
594
+ payload = pickle.dumps(
595
+ original,
596
+ protocol=pickle.HIGHEST_PROTOCOL,
597
+ )
598
+
599
+ restored = pickle.loads(payload)
600
+
601
+ np.testing.assert_array_equal(_np(restored.value), _np(original.value))
602
+
603
+
604
+ def test_pickle_uses_reduce(backend: tuple) -> None:
605
+ import pickle
606
+ from unittest.mock import patch
607
+
608
+ array = _create_array([1.0, 2.0, 3.0])
609
+
610
+ with patch.object(Array, "__reduce__", wraps=array.__reduce__) as reduce:
611
+ payload = pickle.dumps(array)
612
+
613
+ reduce.assert_called_once()
@@ -98,8 +98,15 @@ def test_set_backend_instantiates_dtypes() -> None:
98
98
  dt2 = float32 # global dtype bound during set_dtype
99
99
  dt3 = dtype("float32") # backend is set, so this is bound to backend dtype
100
100
 
101
- assert dt1 != dt2 # dtypes are not equal if not avaiable, and dt1 is not available
102
- assert dt2 == dt3 # available because bound to backend, and equal
101
+ # check availability status
102
+ assert not dt1.available
103
+ assert dt2.available
104
+ assert dt3.available
105
+
106
+ # equality check the name attribute, so all these should be true (irrespective of availability)
107
+ assert dt1 == dt2
108
+ assert dt1 == dt3
109
+ assert dt2 == dt3
103
110
 
104
111
  dt4 = dtype("int16")
105
112
  assert dt3 != dt4
@@ -0,0 +1,92 @@
1
+ """Tests for dtype initialization and backend binding."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import math
6
+ import pytest
7
+
8
+ from decent_array.interoperability import _backend_manager
9
+ from decent_array.interoperability._backend_manager import reset_backends
10
+ from decent_array.types import _dtypes
11
+ import decent_array._constants as constants
12
+
13
+
14
+ @pytest.fixture(autouse=True)
15
+ def reset_backend_state():
16
+ """Reset backend state before and after each test."""
17
+ reset_backends()
18
+ yield
19
+ reset_backends()
20
+
21
+
22
+ def test_all_dtypes_are_bound_to_backend(backend: tuple) -> None:
23
+ """Every dtype is bound to the corresponding backend attribute."""
24
+ backend_instance = _backend_manager._BACKEND_INSTANCE
25
+
26
+ assert backend_instance is not None
27
+
28
+ for name in _dtypes._SUPPORTED:
29
+ dt = getattr(_dtypes, name)
30
+ expected_backend_dtype = getattr(backend_instance, name, None)
31
+
32
+ assert dt.backend_dtype is expected_backend_dtype
33
+ assert dt.available is (expected_backend_dtype is not None)
34
+
35
+
36
+ def test_available_dtypes_cache_is_correct(backend: tuple) -> None:
37
+ expected = {
38
+ dt for dt in _dtypes._ALL_DTYPES if dt.available
39
+ }
40
+
41
+ assert _dtypes._AVAILABLE_DTYPES == expected
42
+
43
+
44
+ def test_dtypes_returns_only_available_dtypes(backend: tuple) -> None:
45
+ available = _dtypes.dtypes()
46
+
47
+ assert available
48
+ assert all(dt.available for dt in available.values())
49
+ assert set(available.values()) == _dtypes._AVAILABLE_DTYPES
50
+
51
+
52
+ def test_backend_dtype_mapping_is_correct(backend: tuple) -> None:
53
+ expected = {
54
+ dt.backend_dtype: dt
55
+ for dt in _dtypes._AVAILABLE_DTYPES
56
+ }
57
+
58
+ assert _dtypes._BACKEND_DTYPE_TO_DTYPE == expected
59
+
60
+ for dt in _dtypes._AVAILABLE_DTYPES:
61
+ assert (
62
+ _dtypes._BACKEND_DTYPE_TO_DTYPE[dt.backend_dtype]
63
+ is dt
64
+ )
65
+
66
+
67
+ def test_reset_clears_dtype_bindings(backend: tuple) -> None:
68
+ """Resetting backends clears dtype bindings and caches."""
69
+ assert _backend_manager._BACKEND_INSTANCE is not None
70
+ assert _dtypes._AVAILABLE_DTYPES
71
+
72
+ reset_backends()
73
+
74
+ assert _backend_manager._BACKEND_INSTANCE is None
75
+ assert not _dtypes._AVAILABLE_DTYPES
76
+ assert not _dtypes._BACKEND_DTYPE_TO_DTYPE
77
+
78
+ for dt in _dtypes._ALL_DTYPES:
79
+ assert dt.available is False
80
+ assert dt.backend_dtype is None
81
+
82
+
83
+ def test_reset_restores_default_constants(backend: tuple) -> None:
84
+ """Resetting the backend restores Python math defaults."""
85
+ assert _backend_manager._BACKEND_INSTANCE is not None
86
+
87
+ reset_backends()
88
+
89
+ assert constants.e == math.e
90
+ assert constants.inf == math.inf
91
+ assert math.isnan(constants.nan)
92
+ assert constants.pi == math.pi
@@ -1,10 +0,0 @@
1
- """Numerical constants."""
2
-
3
- import math
4
-
5
- _CONSTANTS = ["e", "inf", "nan", "pi"]
6
-
7
- e = math.e
8
- inf = math.inf
9
- nan = math.nan
10
- pi = math.pi
File without changes
File without changes
File without changes
File without changes
File without changes