cobra-array 0.1.0__py3-none-any.whl

cobra_array-0.1.0.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: cobra-array
+Version: 0.1.0
+Summary: A backend-agnostic array utility library that unifies array conversion, context control, and cross-library operations across `NumPy`/`PyTorch`-style ecosystems.
+Author-email: Zhen Tian <zhen.tian.cs@gmail.com>
+Project-URL: Homepage, https://github.com/tinchen777/cobra-array.git
+Project-URL: Repository, https://github.com/tinchen777/cobra-array.git
+Project-URL: Issues, https://github.com/tinchen777/cobra-array.git/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: array-api-compat>=1.11.2
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: numpy<2.0,>=1.21; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<h2 id="title">
+🍁 cobra-array 🍁<br>
+<sub>Unified Array Utilities with Python Array API Compatibility</sub>
+</h2>
+
+[![PyPI version](https://img.shields.io/pypi/v/cobra-array.svg)](https://pypi.org/project/cobra-array/)
+![Python](https://img.shields.io/pypi/pyversions/cobra-array?color=brightgreen)
+[![codecov](https://codecov.io/gh/tinchen777/cobra-array/branch/main/graph/badge.svg)](https://codecov.io/gh/tinchen777/cobra-array)
+![License](https://img.shields.io/github/license/tinchen777/cobra-array.svg)
+
+[![Tests](https://github.com/tinchen777/cobra-array/actions/workflows/test.yml/badge.svg)](https://github.com/tinchen777/cobra-array/actions/workflows/test.yml)
+![Github stars](https://img.shields.io/github/stars/tinchen777/cobra-array.svg)
+
+</div>
+
+## About
+
+`cobra-array` is a backend-agnostic array utility library that unifies array conversion, context control, and cross-library operations across `NumPy`/`PyTorch`-style ecosystems.
+
+- Python: 3.9+
+- Runtime deps: `array-api-compat` (>= 1.11.2)
+
+## Features
+
+- 🚀 **Ackend-agnostic API**: Work with different array backends through one consistent interface.
+- 🚀 **Context-driven unification**: Automatically align namespace, dtype, and device via context managers and decorators.
+- 🚀 **Compatibility wrappers**: `CompatArray` and `CompatNamespace` provide a clean, consistent layer over native backend behavior.
+
+## Installation
+
+### Install from PyPI
+
+```bash
+pip install cobra-array
+```
+
+## Quick Start
+
+- Basic conversions:
+
+    ```python
+    import numpy as np
+    from cobra_array.convert import to_numpy, to_tensor, to_list
+
+    data = [[1, 2], [3, 4]]
+
+    arr_np = to_numpy(data, dtype=np.float32)
+    print(type(arr_np), arr_np.dtype)  # numpy.ndarray float32
+
+    arr_torch = to_tensor(data, device="cpu")
+    print(type(arr_torch), arr_torch.device)
+
+    back_to_list = to_list(arr_np)
+    print(back_to_list)  # [[1.0, 2.0], [3.0, 4.0]]
+    ```
+
+- Context-based conversion:
+
+    ```python
+    import numpy as np
+    from cobra_array import array_context, as_context, context_spec
+
+    with array_context(xp="numpy", dtype=np.float32, device="cpu"):
+        x = as_context([1, 2, 3])
+        y = as_context(np.array([4, 5]))
+        spec = context_spec()
+        print(spec.cxp.xp_name, spec.dtype, spec.device)
+        print(x, y)
+    ```
+
+- Auto-unify function arguments:
+
+    ```python
+    import numpy as np
+    from cobra_array import unify_args
+
+    @unify_args(ref=0, unify_dtype=True, unify_device=True, arraylike_only=True)
+    def add_and_mean(a, b):
+        c = a + b
+        return c.mean()
+
+    out = add_and_mean(np.array([1, 2, 3]), [4, 5, 6])
+    print(out)
+    ```
+
+- Default backend strategy:
+
+    ```python
+    from cobra_array.default import as_default, default_spec
+
+    spec = default_spec()
+    print(spec.cxp.xp_name, spec.dtype, spec.device)
+
+    x = as_default([1, 2, 3], unify_dtype=True, unify_device=True)
+    print(x, x.dtype)
+    ```
+
+## Requirements
+
+- Python >= 3.9
+- `array-api-compat` >= 1.11.2
+
+## License
+
+See LICENSE in the repository.
+
+## Links
+
+- [Homepage/Repo](https://github.com/tinchen777/cobra-array.git)
+- [Issues](https://github.com/tinchen777/cobra-array.git/issues)

cobra_array-0.1.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+cobra_array/__init__.py,sha256=mi_D1NpbofsvWVo7KJc3Pcg6TslXJzEYen2diyKNlqc,3324
+cobra_array/_core.py,sha256=xiVvd4cMHjPUcu-i--knNWwGKZ6iM4OKCUqn8Hj5k1I,16576
+cobra_array/_utils.py,sha256=o0BO_FaMtBEyWpPV3vK1IQtm8Gay5eyLclYnn3PdvmI,2309
+cobra_array/array_api.py,sha256=NqeHpUOyRL1abt7YTdOspx_Uv58U1FrAD2Dg0Qm-3Wg,4072
+cobra_array/convert.py,sha256=d6qAB5r_aWFAY1H-ToiQeGKYnO4dWNrJo4iUviy0GB8,12491
+cobra_array/convert.pyi,sha256=raSmXpnziIJzFnaH-zSbW0H-PKFLt3lEwtUmvAsLSY0,3991
+cobra_array/default.py,sha256=rJUMFE0j6ElPd4XwFrYFgej2dzVQPV8UvdH1TKd1gbk,5370
+cobra_array/exceptions.py,sha256=JPQ809F1qSqaDNUhqRB5qIJyID-8iiX_Qt9mtQcNdWY,2217
+cobra_array/types.py,sha256=XTEyAu4Gk16gIjDkY7ykmyO5iHAXaOV2KrqHXMrW5vM,2180
+cobra_array/compat/__init__.py,sha256=q6PYjzqIy_PSO5Xz6_whB4ZcI8duokuEOPC4iH1jpOk,843
+cobra_array/compat/_array.py,sha256=AW32ihYP0t1L6ILBCwldU1pbSm4N7OjF43MFkAefyhc,19439
+cobra_array/compat/_array.pyi,sha256=IxSEQ_KgSscgZlAlIJFguRU9xDqamRjC9nKe_Ub5uJg,87225
+cobra_array/compat/_base.py,sha256=cRqOx92lhZyUyG5ai9n12uyi-qYRcFLPl5mWCtA-fyA,1480
+cobra_array/compat/_namespace.py,sha256=NhPx-1ROztLLmwJeZAMKlL2aubtu9Ro0J0FfvaIjQgQ,11945
+cobra_array/compat/_namespace.pyi,sha256=2d9fE69nnyI-VRr-itKxfh0Tptd1kJw_d1wxxBB7B1k,36051
+cobra_array-0.1.0.dist-info/licenses/LICENSE,sha256=UB1vOlHpp1w6bfzyNq42Ou5m31wc-fPCX4YHR_pSxIw,1066
+cobra_array-0.1.0.dist-info/METADATA,sha256=U3kXDw_mTsnoKUgxkNIYKO_du8IWzxt_mmtkxy67Yek,4364
+cobra_array-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+cobra_array-0.1.0.dist-info/top_level.txt,sha256=xPYu-vl_DH3zj5zD4ywYNKXcABMb7wBmRrWJyUal7pQ,12
+cobra_array-0.1.0.dist-info/RECORD,,

cobra_array-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

cobra_array-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cathie Li
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cobra_array-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+cobra_array