Merge branch 'main' into gold/2021

Author: PokhodenkoSA

.github/workflows/conda-package.yml

@@ -1,6 +1,9 @@
 name: Conda package
 
-on: push
+on:
+  push:
+    branches:
+    tags:
 
 env:
   PACKAGE_NAME: numba-dppy
@@ -12,7 +15,7 @@ jobs:
 
     strategy:
       matrix:
-        python: ["3.8"]
+        python: [3.8, 3.9]
         integration_channels: [""]
         experimental: [true]  # packages are not available on -c intel yet
         artifact_name: [""]
@@ -68,7 +71,7 @@ jobs:
 
     strategy:
       matrix:
-        python: ["3.8"]
+        python: [3.8, 3.9]
         integration_channels: [""]
         experimental: [true]  # packages are not available on -c intel yet
         artifact_name: [""]
@@ -118,13 +121,15 @@ jobs:
 
     strategy:
       matrix:
-        python: ["3.8"]
+        python: [3.8, 3.9]
+        numba: [0.54, 0.55]
         integration_channels: [""]
         experimental: [true]  # packages are not available on -c intel yet
         artifact_name: [""]
         dependencies: [""]
         include:
           - python: "3.8"
+            numba: 0.54
             integration_channels: -c dppy/label/dev
             artifact_name: -c dppy_label_dev
             experimental: false  # current stable
@@ -171,7 +176,7 @@ jobs:
       - name: Install numba-dppy
         run: |
           CHANNELS="-c $GITHUB_WORKSPACE/channel ${{ env.CHANNELS }}"
-          conda install $PACKAGE_NAME pytest python=${{ matrix.python }} ${{ matrix.dependencies }} $CHANNELS
+          conda install $PACKAGE_NAME pytest python=${{ matrix.python }} numba=${{ matrix.numba }} ${{ matrix.dependencies }} $CHANNELS
           # Test installed packages
           conda list
       - name: Run tests
@@ -186,7 +191,7 @@ jobs:
 
     strategy:
       matrix:
-        python: ["3.8"]
+        python: [3.8, 3.9]
         integration_channels: [""]
         experimental: [true]  # packages are not available on -c intel yet
         artifact_name: [""]
@@ -248,17 +253,16 @@ jobs:
 
   upload_linux:
     needs: test_linux
-    if: ${{ github.ref == 'refs/heads/main' }}
+    if: ${{ github.ref }} == 'refs/heads/main' || ${{ github.ref }} == 'refs/heads/release*'
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python: ["3.8"]
+        python: [3.8, 3.9]
     steps:
       - name: Download artifact
         uses: actions/download-artifact@v2
         with:
-          # `-c dppy_label_dev`: packages not published on `-c intel` yet
-          name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Python ${{ matrix.python }} -c dppy_label_dev
+          name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Python ${{ matrix.python }}
 
       - name: Install anaconda-client
         run: conda install anaconda-client
@@ -274,17 +278,16 @@ jobs:
 
   upload_windows:
     needs: test_windows
-    if: ${{ github.ref == 'refs/heads/main' }}
+    if: ${{ github.ref }} == 'refs/heads/main' || ${{ github.ref }} == 'refs/heads/release*'
     runs-on: windows-latest
     strategy:
       matrix:
-        python: [3.8]
+        python: [3.8, 3.9]
     steps:
       - name: Download artifact
         uses: actions/download-artifact@v2
         with:
-          # `-c dppy_label_dev`: packages not published on `-c intel` yet
-          name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Python ${{ matrix.python }} -c dppy_label_dev
+          name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Python ${{ matrix.python }}
 
       - uses: conda-incubator/setup-miniconda@v2
         with:

.github/workflows/numba.yml

@@ -0,0 +1,76 @@
+name: Test w/ Numba PRs
+
+on:
+  workflow_dispatch:
+    inputs:
+      numba_pr:
+        description: Numba PR
+        required: true
+        default: 7177
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    env:
+      ID: ${{ github.event.inputs.numba_pr }}
+
+    steps:
+      - name: Checkout numba-dppy
+        uses: actions/checkout@v2
+        with: {path: numba-dppy}
+
+      - name: Checkout numba
+        uses: actions/checkout@v2
+        with:
+          repository: numba/numba
+          path: numba
+
+      # See https://docs.github.com/en/github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally
+      - name: Checkout numba PR
+        run: |
+          cd numba
+          git fetch origin pull/${{env.ID}}/head:pr${{env.ID}}
+          git checkout pr${{env.ID}}
+
+      - name: Add conda to system path
+        shell: bash
+        run: echo $CONDA/bin >> $GITHUB_PATH
+
+      - name: Configure environment
+        run: |
+          cd numba-dppy
+          conda env update -n base -f environment.yml --prune
+          conda remove -n base numba --force
+
+          conda list
+          which python
+
+      - name: Install numba
+        run: |
+          cd numba
+          git log -1
+          python setup.py develop
+
+      - name: Install numba-dppy
+        run: |
+          cd numba-dppy
+          git log -1
+          python setup.py develop
+
+      - name: Test installation
+        run: |
+          conda list
+
+          # echo "libintelocl.so" | tee /etc/OpenCL/vendors/intel-cpu.icd
+          export OCL_ICD_FILENAMES=libintelocl.so
+
+          python -c "import numba; print(numba.__file__)"
+          python -c "import numba_dppy; print(numba_dppy.__file__)"
+
+      - name: Test
+        run: |
+          # echo "libintelocl.so" | tee /etc/OpenCL/vendors/intel-cpu.icd
+          export OCL_ICD_FILENAMES=libintelocl.so
+
+          pytest -q -ra --disable-warnings --pyargs numba_dppy -vv

README.md

@@ -18,9 +18,9 @@ https://intelpython.github.io/dpnp/
 
 ## Dependencies
 
-* numba 0.54.*
-* dpctl 0.10.*
-* dpnp 0.8.* (optional)
+* numba 0.54.* or 0.55.*
+* dpctl 0.11.*
+* dpnp 0.9.* (optional)
 * llvm-spirv 11.* (SPIRV generation from LLVM IR)
 * spirv-tools
 * packaging

conda-recipe/meta.yaml

@@ -18,17 +18,17 @@ requirements:
         - python
         - setuptools
         - cython
-        - numba 0.54*
-        - dpctl >=0.10*
-        - dpnp >=0.8*              # [linux]
+        - numba 0.54*|0.55*
+        - dpctl 0.10*|0.11*
+        - dpnp 0.8*|0.9*           # [linux]
         - wheel
     run:
         - python
-        - numba 0.54*
-        - dpctl >=0.10*
+        - numba 0.54*|0.55*
+        - dpctl 0.10*|0.11*
         - spirv-tools
         - llvm-spirv 11.*
-        - dpnp >=0.8*              # [linux]
+        - dpnp 0.8*|0.9*           # [linux]
         - packaging
 
 test:

docs/user_guides/debugging/debugging_environment.rst

@@ -18,10 +18,6 @@ Configure debugging environment
         conda create numba-dppy-dev numba-dppy
         conda activate numba-dppy-dev
 
-    .. note::
-
-        Debugging features were tested with the following packages: ``numba-dppy=0.14``, ``dpctl=0.8``, ``numba=0.53``.
-
 3) Activate NEO drivers (optional).
 
     If you want to use the local NEO driver, activate the variables for it. See the :ref:`NEO-driver`.

docs/user_guides/getting_started.rst

@@ -6,7 +6,7 @@ Installation
 
 Numba-dppy depends on following components:
 
-* numba 0.54.* (`Numba`_)
+* numba 0.54.* or 0.55.* (`Numba`_)
 * dpctl 0.9.* (`Intel Python dpctl`_)
 * dpnp >=0.6.* (optional, `Intel Python DPNP`_)
 * `llvm-spirv`_ (SPIRV generation from LLVM IR)

environment.yml

@@ -11,9 +11,9 @@ dependencies:
   - gxx_linux-64
   - dpcpp_linux-64
   - cython
-  - numba 0.54*
-  - dpctl 0.10*
-  - dpnp 0.8*
+  - numba 0.55*
+  - dpctl 0.11*
+  - dpnp 0.9*
   - spirv-tools
   # - llvm-spirv 11.*
   - packaging

numba_dppy/__init__.py

@@ -517,6 +517,7 @@ def main():
 
 import numba.testing
 
+from numba_dppy.interop import asarray
 from numba_dppy.retarget import offload_to_sycl_device
 
 from . import config

numba_dppy/interop.py

@@ -0,0 +1,41 @@
+# Copyright 2021 Intel Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Support for interoperability."""
+
+import dpctl.tensor as dpt
+
+
+def asarray(container):
+    """Convert container supported by interoperability to numba-dppy container.
+    Currently used dpctl.tensor.asarray().
+    """
+    try:
+        return dpt.asarray(container)
+    except:
+        pass
+
+    # Workaround for dpnp_array if dpctl asarray() does not support it.
+    try:
+        from dpnp.dpnp_array import dpnp_array
+
+        if isinstance(container, dpnp_array) and hasattr(container, "_array_obj"):
+            import warnings
+
+            warnings.warn("asarray() uses internals from dpnp.")
+            return container._array_obj
+    except:
+        pass
+
+    raise NotImplementedError("dpctl asarray() does not support " + type(container))

numba_dppy/tests/integration/test_dpnp_interop.py

@@ -89,8 +89,8 @@ def data_parallel_sum(a, b, c):
     global_size = 1021
 
     with dppy.offload_to_sycl_device(offload_device):
-        a = dpnp.arange(global_size, dtype=dtype)
-        b = dpnp.arange(global_size, dtype=dtype)
-        c = dpnp.ones_like(a)
+        a = dppy.asarray(dpnp.arange(global_size, dtype=dtype))
+        b = dppy.asarray(dpnp.arange(global_size, dtype=dtype))
+        c = dppy.asarray(dpnp.ones_like(a))
 
         data_parallel_sum[global_size, dppy.DEFAULT_LOCAL_SIZE](a, b, c)