Add randn

.github/workflows/python-package.yml

@@ -13,7 +13,10 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest]
+        os: [ubuntu-latest]
+        # BUG
+        # fix bash script running on windows then uncomment
+        # os: [ubuntu-latest, windows-latest]
         python-version: ["3.10", "3.11", "3.12"]
 
     steps:
@@ -44,10 +47,13 @@ jobs:
       run: |
         make typecheck
 
-    - name: Test with pytest
-      run: |
-        make tests
+    # TODO
+    # add binaries to cache and make them available for library. Then uncomment
+
+    # - name: Test with pytest
+    #   run: |
+    #     make tests
 
-    - name: Test package build
+    - name: Test package build without pre-installed AF binaries
       run: |
-        make build
+        bash ./scripts/build_package_without_binaries.sh

.gitignore

@@ -2,7 +2,7 @@
 
 .eggs/
 .mypy_cache
-arrayfire_python_wrapper.egg-info/
+arrayfire_binary_python_wrapper.egg-info/
 build/
 dist/
 

Makefile

@@ -19,7 +19,7 @@ install :
 	pip install --upgrade pip
 	pip install pip-tools
 	pip-compile requirements.txt -o final_requirements.txt --allow-unsafe --rebuild --verbose
-	pip install -e . -r final_requirements.txt
+	pip install -r final_requirements.txt
 
 .PHONY : build
 build :

README.md

@@ -1,4 +1,4 @@
-# arrayfire-python-wrapper
+# arrayfire-binary-python-wrapper
 
 Arrayfire python C library wrapper
 

arrayfire_wrapper/_backend.py

@@ -145,12 +145,12 @@ def _load_backend_libs(self) -> None:
         for backend_type in BackendType:
             self._load_backend_lib(backend_type)
 
-            if self._backend_type:
+            if hasattr(self, "_backend_type"):
                 if VERBOSE_LOADS:
                     print(f"Setting {backend_type.name} as backend.")
                 break
 
-        if not self._backend_type and not self._clib:
+        if not (hasattr(self, "_backend_type") and hasattr(self, "_clib")):
             raise RuntimeError(
                 "Could not load any ArrayFire libraries.\n"
                 "Please look at https://github.com/arrayfire/arrayfire-python/wiki for more information."

arrayfire_wrapper/lib/__init__.py

@@ -72,11 +72,13 @@
 
 __all__ += [
     "AFRandomEngineHandle",
+    "randn",
     "create_random_engine",
     "random_engine_get_seed",
     "random_engine_get_type",
     "random_engine_set_seed",
     "random_engine_set_type",
+    "random_normal",
     "random_uniform",
     "randu",
     "release_random_engine",

arrayfire_wrapper/lib/create_and_modify_array/__init__.py

@@ -14,11 +14,13 @@
 
 __all__ += [
     "AFRandomEngineHandle",
+    "randn",
     "create_random_engine",
     "random_engine_get_seed",
     "random_engine_get_type",
     "random_engine_set_seed",
     "random_engine_set_type",
+    "random_normal",
     "random_uniform",
     "randu",
     "release_random_engine",
@@ -27,10 +29,12 @@
 from .create_array.random_number_generation import (
     AFRandomEngineHandle,
     create_random_engine,
+    randn,
     random_engine_get_seed,
     random_engine_get_type,
     random_engine_set_seed,
     random_engine_set_type,
+    random_normal,
     random_uniform,
     randu,
     release_random_engine,

arrayfire_wrapper/lib/create_and_modify_array/assignment_and_indexing/_indexing.py

@@ -77,7 +77,6 @@ def __init__(self, chunk: int | slice):
 
 
 class ParallelRange(_IndexSequence):
-
     """
     Class used to parallelize for loop.
 

arrayfire_wrapper/lib/create_and_modify_array/create_array/__init__.py

@@ -5,21 +5,25 @@
 
 __all__ += [
     "create_random_engine",
+    "randn",
     "random_engine_get_seed",
     "random_engine_get_type",
     "random_engine_set_seed",
     "random_engine_set_type",
+    "random_normal",
     "random_uniform",
     "randu",
     "release_random_engine",
 ]
 
 from .random_number_generation import (
     create_random_engine,
+    randn,
     random_engine_get_seed,
     random_engine_get_type,
     random_engine_set_seed,
     random_engine_set_type,
+    random_normal,
     random_uniform,
     randu,
     release_random_engine,

arrayfire_wrapper/lib/create_and_modify_array/create_array/random_number_generation.py

@@ -62,3 +62,23 @@ def random_uniform(shape: tuple[int, ...], dtype: Dtype, engine: AFRandomEngineH
     c_shape = CShape(*shape)
     call_from_clib(random_uniform.__name__, ctypes.pointer(out), 4, c_shape.c_array, dtype.c_api_value, engine)
     return out
+
+
+def randn(shape: tuple[int, ...], dtype: Dtype, /) -> AFArray:
+    """
+    source: https://arrayfire.org/docs/group__random__func__randn.htm#ga4925856392881453e4356a581c761ab9
+    """
+    out = AFArray.create_null_pointer()
+    c_shape = CShape(*shape)
+    call_from_clib(randn.__name__, ctypes.pointer(out), 4, c_shape.c_array, dtype.c_api_value)
+    return out
+
+
+def random_normal(shape: tuple[int, ...], dtype: Dtype, engine: AFRandomEngineHandle, /) -> AFArray:
+    """
+    source: https://arrayfire.org/docs/group__random__func__randu.htm#ga2ca76d970cfac076f9006755582a4a4c
+    """
+    out = AFArray.create_null_pointer()
+    c_shape = CShape(*shape)
+    call_from_clib(random_normal.__name__, ctypes.pointer(out), 4, c_shape.c_array, dtype.c_api_value, engine)
+    return out

arrayfire_wrapper/version.py

@@ -1,7 +1,7 @@
 import os
 
 _MAJOR = "0"
-_MINOR = "5"
+_MINOR = "6"
 # On main and in a nightly release the patch should be one ahead of the last
 # released build.
 _PATCH = "0"

dev-requirements.txt

@@ -1,24 +1,24 @@
 # Testing-related packages
 
 # Checks style, syntax, etc.
-flake8>=6.1.0
+flake8~=7.0.0
 
 # Static type checking
-mypy==1.7.1
+mypy==1.8.0
 
 # Check import order style
-isort>=5.13.2
+isort~=5.13.2
 
 # Automatic code formatting
-black>=23.12.0
+black~=24.1.1
 
 # Allows generation of coverage reports with pytest.
-pytest>=7.4.3
+pytest>=8.0.0
 pytest-cov>=4.1.0
-pytest-mock>=3.11.1
+pytest-mock>=3.12.0
 
 # Allows codecov to generate coverage reports
-coverage[toml]>=6.4
+coverage[toml]>=7.4.1
 codecov>=2.1.12
 
 # Package building

pyproject.toml

@@ -28,10 +28,10 @@ requires = [
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools.dynamic]
-version = { attr = "arrayfire_wrapper.__version__" }
+version = { attr = "arrayfire_wrapper.VERSION" }
 
 [project]
-name = "arrayfire-python-wrapper"
+name = "arrayfire-binary-python-wrapper"
 dynamic = ["version"]
 requires-python = ">=3.10"
 authors = [

scripts/build_package_without_binaries.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+
+# Run the Python script and capture the output and error
+output=$(python -m build 2>&1)
+
+# Define the expected error message
+expected_error="Could not load any ArrayFire libraries."
+
+# Check if the output contains the expected error message
+if echo "$output" | grep -q "$expected_error"; then
+  echo "Expected error received."
+  exit 0  # Exit with success as the error is expected
+else
+  echo "Unexpected output: $output"
+  exit 1  # Exit with failure as the output was not expected
+fi