cunumpy 0.1.4__tar.gz → 0.1.5__tar.gz

cunumpy-0.1.5/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: cunumpy
+Version: 0.1.5
+Summary: Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
+Author: Max
+Project-URL: Source, https://github.com/max-models/cunumpy
+Keywords: python
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: array-api-compat
+Requires-Dist: numpy
+Provides-Extra: dev
+Requires-Dist: black[jupyter]; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: cunumpy[docs,test-compiled]; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: ipykernel; extra == "docs"
+Requires-Dist: myst-parser; extra == "docs"
+Requires-Dist: nbconvert; extra == "docs"
+Requires-Dist: nbsphinx; extra == "docs"
+Requires-Dist: jupyterlab; extra == "docs"
+Requires-Dist: pre-commit; extra == "docs"
+Requires-Dist: pyproject-fmt; extra == "docs"
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-book-theme; extra == "docs"
+Provides-Extra: test
+Requires-Dist: coverage; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: test-compiled
+Requires-Dist: cunumpy[test]; extra == "test-compiled"
+Requires-Dist: pyccel; extra == "test-compiled"
+
+# CuNumpy
+
+Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
+
+# Install
+
+```bash
+pip install cunumpy
+```
+
+Example usage:
+
+```
+export ARRAY_BACKEND=cupy
+```
+
+```python
+import cunumpy as xp
+
+xp.set_backend("cupy")
+
+arr = xp.array([1, 2])
+
+print(f"{type(arr) = }")
+print(f"{xp.__version__ = }")
+
+# Convert to NumPy
+arr_np = xp.to_numpy(arr)
+
+# Convert to active backend
+arr_xp = xp.to_cunumpy(arr)
+
+# Inspect backend
+print(f"{xp.get_backend(arr) = }")
+print(f"{xp.is_gpu(arr) = }")
+print(f"{xp.is_cpu(arr) = }")
+
+# Temporarily switch backend
+with xp.use_backend("numpy"):
+    # This code runs on CPU even if ARRAY_BACKEND=cupy
+    arr_cpu = xp.zeros(100)
+
+# Set backend globally
+xp.set_backend("cupy")
+
+# Synchronize GPU operations (no-op on CPU)
+xp.synchronize()
+```
+
+Output:
+
+```
+type(arr) = <class 'cupy.ndarray'>
+xp.__version__ = '0.1.4'
+xp.get_backend(arr) = 'cupy'
+xp.is_gpu(arr) = True
+xp.is_cpu(arr) = False
+```
+
+# Pyodide
+
+cuNumPy supports Pyodide with the NumPy backend. In an initialized Pyodide
+JavaScript runtime, install the package and run a Python-source kernel:
+
+```javascript
+await pyodide.loadPackage("micropip");
+await pyodide.runPythonAsync(`
+    import micropip
+    await micropip.install("cunumpy")
+
+    import cunumpy as xp
+    xp.set_backend("numpy")
+
+    def scale(values, factor):
+        values[:] *= factor
+        return values
+
+    values = xp.array([1.0, 2.0, 3.0])
+    result = xp.PyccelKernel(scale)(values, 2.0)
+    assert result is values
+    print(xp.to_numpy(result))  # [2. 4. 6.]
+`);
+```
+
+NumPy is the default backend when `ARRAY_BACKEND` is unset. CuPy/CUDA and
+native Pyccel compilation are not supported in Pyodide. Despite its name,
+`PyccelKernel` accepts ordinary Python callables and neither imports Pyccel nor
+compiles code. Applications must supply Python-source kernels with
+Pyodide-compatible imports.
+
+CI tests the built wheel in Pyodide's WebAssembly runtime under Node.js, including
+array operations, conversions, mutation/aliasing, backend context restoration,
+and Python kernels, while rejecting CuPy or Pyccel imports. This does not test
+browser-specific integration such as page loading or workers. See the
+[Pyodide guide](docs/source/pyodide.md) for details and local test commands.
+
+# Development tests
+
+```bash
+pip install -e '.[test]'
+pytest tests/portable
+```
+
+The `test` extra is compiler-free. For compiled-kernel tests, install
+`'.[test-compiled]'` and a working native compiler, then run `pytest`.
+The `dev` extra includes these compiled-test dependencies as before.
+
+# Build docs
+
+
+```
+make html
+cd ../
+open docs/_build/html/index.html
+```

cunumpy-0.1.5/README.md

@@ -0,0 +1,115 @@
+# CuNumpy
+
+Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
+
+# Install
+
+```bash
+pip install cunumpy
+```
+
+Example usage:
+
+```
+export ARRAY_BACKEND=cupy
+```
+
+```python
+import cunumpy as xp
+
+xp.set_backend("cupy")
+
+arr = xp.array([1, 2])
+
+print(f"{type(arr) = }")
+print(f"{xp.__version__ = }")
+
+# Convert to NumPy
+arr_np = xp.to_numpy(arr)
+
+# Convert to active backend
+arr_xp = xp.to_cunumpy(arr)
+
+# Inspect backend
+print(f"{xp.get_backend(arr) = }")
+print(f"{xp.is_gpu(arr) = }")
+print(f"{xp.is_cpu(arr) = }")
+
+# Temporarily switch backend
+with xp.use_backend("numpy"):
+    # This code runs on CPU even if ARRAY_BACKEND=cupy
+    arr_cpu = xp.zeros(100)
+
+# Set backend globally
+xp.set_backend("cupy")
+
+# Synchronize GPU operations (no-op on CPU)
+xp.synchronize()
+```
+
+Output:
+
+```
+type(arr) = <class 'cupy.ndarray'>
+xp.__version__ = '0.1.4'
+xp.get_backend(arr) = 'cupy'
+xp.is_gpu(arr) = True
+xp.is_cpu(arr) = False
+```
+
+# Pyodide
+
+cuNumPy supports Pyodide with the NumPy backend. In an initialized Pyodide
+JavaScript runtime, install the package and run a Python-source kernel:
+
+```javascript
+await pyodide.loadPackage("micropip");
+await pyodide.runPythonAsync(`
+    import micropip
+    await micropip.install("cunumpy")
+
+    import cunumpy as xp
+    xp.set_backend("numpy")
+
+    def scale(values, factor):
+        values[:] *= factor
+        return values
+
+    values = xp.array([1.0, 2.0, 3.0])
+    result = xp.PyccelKernel(scale)(values, 2.0)
+    assert result is values
+    print(xp.to_numpy(result))  # [2. 4. 6.]
+`);
+```
+
+NumPy is the default backend when `ARRAY_BACKEND` is unset. CuPy/CUDA and
+native Pyccel compilation are not supported in Pyodide. Despite its name,
+`PyccelKernel` accepts ordinary Python callables and neither imports Pyccel nor
+compiles code. Applications must supply Python-source kernels with
+Pyodide-compatible imports.
+
+CI tests the built wheel in Pyodide's WebAssembly runtime under Node.js, including
+array operations, conversions, mutation/aliasing, backend context restoration,
+and Python kernels, while rejecting CuPy or Pyccel imports. This does not test
+browser-specific integration such as page loading or workers. See the
+[Pyodide guide](docs/source/pyodide.md) for details and local test commands.
+
+# Development tests
+
+```bash
+pip install -e '.[test]'
+pytest tests/portable
+```
+
+The `test` extra is compiler-free. For compiled-kernel tests, install
+`'.[test-compiled]'` and a working native compiler, then run `pytest`.
+The `dev` extra includes these compiled-test dependencies as before.
+
+# Build docs
+
+
+```
+make html
+cd ../
+open docs/_build/html/index.html
+```

{cunumpy-0.1.4 → cunumpy-0.1.5}/pyproject.toml

@@ -5,7 +5,7 @@ requires = [ "setuptools", "wheel" ]
 
 [project]
 name = "cunumpy"
-version = "0.1.4"
+version = "0.1.5"
 description = "Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`."
 readme = "README.md"
 keywords = [ "python" ]
@@ -30,7 +30,7 @@ dependencies = [
 optional-dependencies.dev = [
   "black[jupyter]",
   "isort",
-  "cunumpy[test,docs]",
+  "cunumpy[test-compiled,docs]",
 ]
 # https://medium.com/@pratikdomadiya123/build-project-documentation-quickly-with-the-sphinx-python-2a9732b66594
 optional-dependencies.docs = [
@@ -44,7 +44,8 @@ optional-dependencies.docs = [
   "sphinx",
   "sphinx-book-theme",
 ]
-optional-dependencies.test = [ "coverage", "pyccel", "pytest" ]
+optional-dependencies.test = [ "coverage", "pytest" ]
+optional-dependencies.test-compiled = [ "cunumpy[test]", "pyccel" ]
 urls."Source" = "https://github.com/max-models/cunumpy"
 
 [tool.setuptools.packages.find]

{cunumpy-0.1.4 → cunumpy-0.1.5}/src/cunumpy/__init__.py

@@ -4,10 +4,12 @@ from importlib.metadata import PackageNotFoundError, version
 from . import xp
 from .kernel import PyccelKernel
 from .xp import (
+    assert_same_backend,
     cupy_available,
     get_backend,
     is_cpu,
     is_gpu,
+    same_backend,
     set_backend,
     set_device,
     synchronize,
@@ -25,12 +27,14 @@ except PackageNotFoundError:
 __all__ = [
     "PyccelKernel",
     "__version__",
+    "assert_same_backend",
     "cupy_available",
     "cupy_backend",
     "get_backend",
     "is_cpu",
     "is_gpu",
     "numpy_backend",
+    "same_backend",
     "set_backend",
     "set_device",
     "synchronize",

{cunumpy-0.1.4 → cunumpy-0.1.5}/src/cunumpy/__init__.pyi

@@ -17,6 +17,8 @@ def cupy_available() -> bool: ...
 def get_backend(array: Any) -> str: ...
 def is_gpu(array: Any) -> bool: ...
 def is_cpu(array: Any) -> bool: ...
+def same_backend(*arrays: Any) -> bool: ...
+def assert_same_backend(*arrays: Any) -> None: ...
 @contextmanager
 def use_backend(backend: str) -> Generator[None]: ...
 def set_backend(backend: str) -> None: ...

{cunumpy-0.1.4 → cunumpy-0.1.5}/src/cunumpy/kernel.py

@@ -8,6 +8,9 @@ made by the kernel are copied back to the device afterwards, and any arrays
 returned by the kernel are moved back to the device.
 
 On the NumPy backend the wrapper is a no-op and the kernel is called directly.
+Ordinary Python callables are supported, including in Pyodide. This module
+neither imports Pyccel nor compiles kernels; compilation, if desired, is the
+caller's responsibility.
 """
 
 from __future__ import annotations
@@ -24,7 +27,7 @@ __all__ = ["PyccelKernel"]
 
 
 class PyccelKernel:
-    """Call a Pyccel-compiled kernel with NumPy or CuPy arrays.
+    """Call a NumPy callable or Pyccel-compiled kernel with NumPy or CuPy arrays.
 
     Parameters
     ----------

{cunumpy-0.1.4 → cunumpy-0.1.5}/src/cunumpy/xp.py

@@ -192,6 +192,34 @@ def is_cpu(array: Any) -> bool:
     return get_backend(array) == "numpy"
 
 
+def same_backend(*arrays: Any) -> bool:
+    """Return True if all given arrays live on the same backend.
+
+    Trivially True for zero or one array.
+    """
+    if len(arrays) <= 1:
+        return True
+    backends = {get_backend(array) for array in arrays}
+    return len(backends) == 1
+
+
+def assert_same_backend(*arrays: Any) -> None:
+    """Raise TypeError if the given arrays don't all live on the same backend.
+
+    Mixing NumPy and CuPy arrays in an operation typically fails with a
+    confusing, backend-internal error (e.g. a CuPy kernel dispatch error
+    complaining about an "unsupported type"). Call this upfront to fail
+    with a clear message instead. Use `to_cunumpy()`/`to_numpy()`/`to_cupy()`
+    to align mismatched arrays onto one backend first.
+    """
+    if not same_backend(*arrays):
+        backends = [get_backend(array) for array in arrays]
+        raise TypeError(
+            f"Arrays are on mismatched backends: {backends}. Use "
+            "xp.to_cunumpy()/xp.to_numpy()/xp.to_cupy() to align them first."
+        )
+
+
 # TYPE_CHECKING is True when type checking (e.g., mypy), but False at runtime.
 # This allows us to use autocompletion for xp (i.e., numpy/cupy) as if numpy was imported.
 if TYPE_CHECKING:

cunumpy-0.1.5/src/cunumpy.egg-info/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: cunumpy
+Version: 0.1.5
+Summary: Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
+Author: Max
+Project-URL: Source, https://github.com/max-models/cunumpy
+Keywords: python
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: array-api-compat
+Requires-Dist: numpy
+Provides-Extra: dev
+Requires-Dist: black[jupyter]; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: cunumpy[docs,test-compiled]; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: ipykernel; extra == "docs"
+Requires-Dist: myst-parser; extra == "docs"
+Requires-Dist: nbconvert; extra == "docs"
+Requires-Dist: nbsphinx; extra == "docs"
+Requires-Dist: jupyterlab; extra == "docs"
+Requires-Dist: pre-commit; extra == "docs"
+Requires-Dist: pyproject-fmt; extra == "docs"
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-book-theme; extra == "docs"
+Provides-Extra: test
+Requires-Dist: coverage; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: test-compiled
+Requires-Dist: cunumpy[test]; extra == "test-compiled"
+Requires-Dist: pyccel; extra == "test-compiled"
+
+# CuNumpy
+
+Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
+
+# Install
+
+```bash
+pip install cunumpy
+```
+
+Example usage:
+
+```
+export ARRAY_BACKEND=cupy
+```
+
+```python
+import cunumpy as xp
+
+xp.set_backend("cupy")
+
+arr = xp.array([1, 2])
+
+print(f"{type(arr) = }")
+print(f"{xp.__version__ = }")
+
+# Convert to NumPy
+arr_np = xp.to_numpy(arr)
+
+# Convert to active backend
+arr_xp = xp.to_cunumpy(arr)
+
+# Inspect backend
+print(f"{xp.get_backend(arr) = }")
+print(f"{xp.is_gpu(arr) = }")
+print(f"{xp.is_cpu(arr) = }")
+
+# Temporarily switch backend
+with xp.use_backend("numpy"):
+    # This code runs on CPU even if ARRAY_BACKEND=cupy
+    arr_cpu = xp.zeros(100)
+
+# Set backend globally
+xp.set_backend("cupy")
+
+# Synchronize GPU operations (no-op on CPU)
+xp.synchronize()
+```
+
+Output:
+
+```
+type(arr) = <class 'cupy.ndarray'>
+xp.__version__ = '0.1.4'
+xp.get_backend(arr) = 'cupy'
+xp.is_gpu(arr) = True
+xp.is_cpu(arr) = False
+```
+
+# Pyodide
+
+cuNumPy supports Pyodide with the NumPy backend. In an initialized Pyodide
+JavaScript runtime, install the package and run a Python-source kernel:
+
+```javascript
+await pyodide.loadPackage("micropip");
+await pyodide.runPythonAsync(`
+    import micropip
+    await micropip.install("cunumpy")
+
+    import cunumpy as xp
+    xp.set_backend("numpy")
+
+    def scale(values, factor):
+        values[:] *= factor
+        return values
+
+    values = xp.array([1.0, 2.0, 3.0])
+    result = xp.PyccelKernel(scale)(values, 2.0)
+    assert result is values
+    print(xp.to_numpy(result))  # [2. 4. 6.]
+`);
+```
+
+NumPy is the default backend when `ARRAY_BACKEND` is unset. CuPy/CUDA and
+native Pyccel compilation are not supported in Pyodide. Despite its name,
+`PyccelKernel` accepts ordinary Python callables and neither imports Pyccel nor
+compiles code. Applications must supply Python-source kernels with
+Pyodide-compatible imports.
+
+CI tests the built wheel in Pyodide's WebAssembly runtime under Node.js, including
+array operations, conversions, mutation/aliasing, backend context restoration,
+and Python kernels, while rejecting CuPy or Pyccel imports. This does not test
+browser-specific integration such as page loading or workers. See the
+[Pyodide guide](docs/source/pyodide.md) for details and local test commands.
+
+# Development tests
+
+```bash
+pip install -e '.[test]'
+pytest tests/portable
+```
+
+The `test` extra is compiler-free. For compiled-kernel tests, install
+`'.[test-compiled]'` and a working native compiler, then run `pytest`.
+The `dev` extra includes these compiled-test dependencies as before.
+
+# Build docs
+
+
+```
+make html
+cd ../
+open docs/_build/html/index.html
+```

{cunumpy-0.1.4 → cunumpy-0.1.5}/src/cunumpy.egg-info/requires.txt

@@ -4,7 +4,7 @@ numpy
 [dev]
 black[jupyter]
 isort
-cunumpy[docs,test]
+cunumpy[docs,test-compiled]
 
 [docs]
 ipykernel
@@ -19,5 +19,8 @@ sphinx-book-theme
 
 [test]
 coverage
-pyccel
 pytest
+
+[test-compiled]
+cunumpy[test]
+pyccel

cunumpy-0.1.4/PKG-INFO

@@ -1,93 +0,0 @@
-Metadata-Version: 2.4
-Name: cunumpy
-Version: 0.1.4
-Summary: Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
-Author: Max
-Project-URL: Source, https://github.com/max-models/cunumpy
-Keywords: python
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
-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
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: array-api-compat
-Requires-Dist: numpy
-Provides-Extra: dev
-Requires-Dist: black[jupyter]; extra == "dev"
-Requires-Dist: isort; extra == "dev"
-Requires-Dist: cunumpy[docs,test]; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: ipykernel; extra == "docs"
-Requires-Dist: myst-parser; extra == "docs"
-Requires-Dist: nbconvert; extra == "docs"
-Requires-Dist: nbsphinx; extra == "docs"
-Requires-Dist: jupyterlab; extra == "docs"
-Requires-Dist: pre-commit; extra == "docs"
-Requires-Dist: pyproject-fmt; extra == "docs"
-Requires-Dist: sphinx; extra == "docs"
-Requires-Dist: sphinx-book-theme; extra == "docs"
-Provides-Extra: test
-Requires-Dist: coverage; extra == "test"
-Requires-Dist: pyccel; extra == "test"
-Requires-Dist: pytest; extra == "test"
-
-# CuNumpy
-
-Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
-
-# Install
-
-```bash
-pip install cunumpy
-```
-
-Example usage:
-
-```
-export ARRAY_BACKEND=cupy
-```
-
-```python
-import cunumpy as xp
-
-arr = xp.array([1, 2])
-
-print(type(arr))
-print(xp.__version__)
-
-# Convert to NumPy
-arr_np = xp.to_numpy(arr)
-
-# Convert to active backend
-arr_xp = xp.to_cunumpy(arr)
-
-# Inspect backend
-print(xp.get_backend(arr))
-print(xp.is_gpu(arr))
-print(xp.is_cpu(arr))
-
-# Temporarily switch backend
-with xp.use_backend("numpy"):
-    # This code runs on CPU even if ARRAY_BACKEND=cupy
-    arr_cpu = xp.zeros(100)
-
-# Set backend globally
-xp.set_backend("cupy")
-
-# Synchronize GPU operations (no-op on CPU)
-xp.synchronize()
-```
-
-# Build docs
-
-
-```
-make html
-cd ../
-open docs/_build/html/index.html
-```

cunumpy-0.1.4/README.md

@@ -1,55 +0,0 @@
-# CuNumpy
-
-Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
-
-# Install
-
-```bash
-pip install cunumpy
-```
-
-Example usage:
-
-```
-export ARRAY_BACKEND=cupy
-```
-
-```python
-import cunumpy as xp
-
-arr = xp.array([1, 2])
-
-print(type(arr))
-print(xp.__version__)
-
-# Convert to NumPy
-arr_np = xp.to_numpy(arr)
-
-# Convert to active backend
-arr_xp = xp.to_cunumpy(arr)
-
-# Inspect backend
-print(xp.get_backend(arr))
-print(xp.is_gpu(arr))
-print(xp.is_cpu(arr))
-
-# Temporarily switch backend
-with xp.use_backend("numpy"):
-    # This code runs on CPU even if ARRAY_BACKEND=cupy
-    arr_cpu = xp.zeros(100)
-
-# Set backend globally
-xp.set_backend("cupy")
-
-# Synchronize GPU operations (no-op on CPU)
-xp.synchronize()
-```
-
-# Build docs
-
-
-```
-make html
-cd ../
-open docs/_build/html/index.html
-```

cunumpy-0.1.4/src/cunumpy.egg-info/PKG-INFO

@@ -1,93 +0,0 @@
-Metadata-Version: 2.4
-Name: cunumpy
-Version: 0.1.4
-Summary: Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
-Author: Max
-Project-URL: Source, https://github.com/max-models/cunumpy
-Keywords: python
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
-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
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: array-api-compat
-Requires-Dist: numpy
-Provides-Extra: dev
-Requires-Dist: black[jupyter]; extra == "dev"
-Requires-Dist: isort; extra == "dev"
-Requires-Dist: cunumpy[docs,test]; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: ipykernel; extra == "docs"
-Requires-Dist: myst-parser; extra == "docs"
-Requires-Dist: nbconvert; extra == "docs"
-Requires-Dist: nbsphinx; extra == "docs"
-Requires-Dist: jupyterlab; extra == "docs"
-Requires-Dist: pre-commit; extra == "docs"
-Requires-Dist: pyproject-fmt; extra == "docs"
-Requires-Dist: sphinx; extra == "docs"
-Requires-Dist: sphinx-book-theme; extra == "docs"
-Provides-Extra: test
-Requires-Dist: coverage; extra == "test"
-Requires-Dist: pyccel; extra == "test"
-Requires-Dist: pytest; extra == "test"
-
-# CuNumpy
-
-Simple wrapper for numpy and cupy. Replace `import numpy as np` with `import cunumpy as xp`.
-
-# Install
-
-```bash
-pip install cunumpy
-```
-
-Example usage:
-
-```
-export ARRAY_BACKEND=cupy
-```
-
-```python
-import cunumpy as xp
-
-arr = xp.array([1, 2])
-
-print(type(arr))
-print(xp.__version__)
-
-# Convert to NumPy
-arr_np = xp.to_numpy(arr)
-
-# Convert to active backend
-arr_xp = xp.to_cunumpy(arr)
-
-# Inspect backend
-print(xp.get_backend(arr))
-print(xp.is_gpu(arr))
-print(xp.is_cpu(arr))
-
-# Temporarily switch backend
-with xp.use_backend("numpy"):
-    # This code runs on CPU even if ARRAY_BACKEND=cupy
-    arr_cpu = xp.zeros(100)
-
-# Set backend globally
-xp.set_backend("cupy")
-
-# Synchronize GPU operations (no-op on CPU)
-xp.synchronize()
-```
-
-# Build docs
-
-
-```
-make html
-cd ../
-open docs/_build/html/index.html
-```