Merge pull request #1420 from IntelPython/technical-debt

Code reorganization: Removes ocl kernel API, moves math, print into kernel_api_impl f2d3080

dev/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: ee0856cd8901afcdee8a609c09b13e10
+config: 43d692e764b5ecb846ef855ea62fba0f
 tags: 645f666f9bcd5a90fca523b33c5a78b7

dev/_sources/autoapi/numba_dpex/core/index.rst.txt

@@ -33,8 +33,6 @@ Overview
    :widths: auto
    :class: summarytable
 
-   * - :py:obj:`Array <numba_dpex.core.Array>`
-     - An array type for use inside our compiler pipeline.
    * - :py:obj:`DpctlSyclQueue <numba_dpex.core.DpctlSyclQueue>`
      - A Numba type to represent a dpctl.SyclQueue PyObject.
    * - :py:obj:`DpctlSyclEvent <numba_dpex.core.DpctlSyclEvent>`
@@ -100,40 +98,6 @@ Overview
 Classes
 -------
 
-.. py:class:: Array(dtype, ndim, layout, readonly=False, name=None, aligned=True, addrspace=None)
-
-   Bases: :py:obj:`Array`
-
-   An array type for use inside our compiler pipeline.
-
-
-   .. rubric:: Overview
-
-
-   .. list-table:: Methods
-      :header-rows: 0
-      :widths: auto
-      :class: summarytable
-
-      * - :py:obj:`copy <numba_dpex.core.Array.copy>`\ (dtype, ndim, layout, readonly, addrspace)
-        - \-
-      * - :py:obj:`is_precise <numba_dpex.core.Array.is_precise>`\ ()
-        - Whether this type is precise, i.e. can be part of a successful
-
-
-   .. rubric:: Members
-
-   .. py:method:: copy(dtype=None, ndim=None, layout=None, readonly=None, addrspace=None)
-
-
-   .. py:method:: is_precise()
-
-      Whether this type is precise, i.e. can be part of a successful
-      type inference.  Default implementation returns True.
-
-
-
-
 .. py:class:: DpctlSyclQueue(sycl_queue)
 
    Bases: :py:obj:`numba.types.Type`

dev/_sources/autoapi/numba_dpex/core/types/index.rst.txt

@@ -23,8 +23,6 @@ Overview
    :widths: auto
    :class: summarytable
 
-   * - :py:obj:`Array <numba_dpex.core.types.Array>`
-     - An array type for use inside our compiler pipeline.
    * - :py:obj:`DpctlSyclEvent <numba_dpex.core.types.DpctlSyclEvent>`
      - A Numba type to represent a dpctl.SyclEvent PyObject.
    * - :py:obj:`DpctlSyclQueue <numba_dpex.core.types.DpctlSyclQueue>`
@@ -90,40 +88,6 @@ Overview
 Classes
 -------
 
-.. py:class:: Array(dtype, ndim, layout, readonly=False, name=None, aligned=True, addrspace=None)
-
-   Bases: :py:obj:`Array`
-
-   An array type for use inside our compiler pipeline.
-
-
-   .. rubric:: Overview
-
-
-   .. list-table:: Methods
-      :header-rows: 0
-      :widths: auto
-      :class: summarytable
-
-      * - :py:obj:`copy <numba_dpex.core.types.Array.copy>`\ (dtype, ndim, layout, readonly, addrspace)
-        - \-
-      * - :py:obj:`is_precise <numba_dpex.core.types.Array.is_precise>`\ ()
-        - Whether this type is precise, i.e. can be part of a successful
-
-
-   .. rubric:: Members
-
-   .. py:method:: copy(dtype=None, ndim=None, layout=None, readonly=None, addrspace=None)
-
-
-   .. py:method:: is_precise()
-
-      Whether this type is precise, i.e. can be part of a successful
-      type inference.  Default implementation returns True.
-
-
-
-
 .. py:class:: DpctlSyclEvent
 
    Bases: :py:obj:`numba.types.Type`

dev/_sources/autoapi/numba_dpex/core/utils/cgutils_extra/index.rst.txt

@@ -26,6 +26,8 @@ Overview
    :widths: auto
    :class: summarytable
 
+   * - :py:obj:`declare_function <numba_dpex.core.utils.cgutils_extra.declare_function>`\ (context, builder, name, sig, cargs, mangler)
+     - Insert declaration for a opencl builtin function.
    * - :py:obj:`get_llvm_type <numba_dpex.core.utils.cgutils_extra.get_llvm_type>`\ (context, type)
      - Returns the LLVM Value corresponding to a Numba type.
    * - :py:obj:`get_llvm_ptr_type <numba_dpex.core.utils.cgutils_extra.get_llvm_ptr_type>`\ (type)
@@ -111,6 +113,25 @@ Classes
 
 Functions
 ---------
+.. py:function:: declare_function(context, builder, name, sig, cargs, mangler=mangle_c)
+
+   Insert declaration for a opencl builtin function.
+   Uses the Itanium mangler.
+
+   :param context:
+   :type context: target context
+   :param builder:
+   :type builder: llvm builder
+   :param name: symbol name
+   :type name: str
+   :param sig: function signature of the symbol being declared
+   :type sig: signature
+   :param cargs: C type names for the arguments
+   :type cargs: sequence of str
+   :param mangler: function to use to mangle the symbol
+   :type mangler: a mangler function
+
+
 .. py:function:: get_llvm_type(context, type)
 
    Returns the LLVM Value corresponding to a Numba type.

dev/_static/documentation_options.js

@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '0.22.1+259.g4deff1ad9',
+    VERSION: '0.22.1+266.gf2d308057',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',

dev/autoapi/index.html

@@ -15,7 +15,7 @@
     <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="numba_dpex.kernel_api" href="numba_dpex/kernel_api/index.html" /><link rel="prev" title="Common issues and tips" href="../user_guide/debugging/common_issues.html" />
 
     <!-- Generated with Sphinx 7.2.6 and Furo 2024.01.29 -->
-        <title>API Reference - numba-dpex 0.22.1+259.g4deff1ad9 documentation</title>
+        <title>API Reference - numba-dpex 0.22.1+266.gf2d308057 documentation</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=135e06be" />
     <link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
@@ -134,7 +134,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">numba-dpex 0.22.1+259.g4deff1ad9 documentation</div></a>
+      <a href="../index.html"><div class="brand">numba-dpex 0.22.1+266.gf2d308057 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -157,7 +157,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
 
 
-  <span class="sidebar-brand-text">numba-dpex 0.22.1+259.g4deff1ad9 documentation</span>
+  <span class="sidebar-brand-text">numba-dpex 0.22.1+266.gf2d308057 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -311,7 +311,7 @@ <h1>API Reference<a class="headerlink" href="#api-reference" title="Link to this
 
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=e9cac773"></script>
+</div><script src="../_static/documentation_options.js?v=3a0f61da"></script>
     <script src="../_static/doctools.js?v=888ff710"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=32e29ea5"></script>

dev/autoapi/numba_dpex/core/boxing/index.html

@@ -15,7 +15,7 @@
     <link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
     <!-- Generated with Sphinx 7.2.6 and Furo 2024.01.29 -->
-        <title>numba_dpex.core.boxing - numba-dpex 0.22.1+259.g4deff1ad9 documentation</title>
+        <title>numba_dpex.core.boxing - numba-dpex 0.22.1+266.gf2d308057 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=135e06be" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/graphviz.css?v=eafc0fe6" />
@@ -134,7 +134,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">numba-dpex 0.22.1+259.g4deff1ad9 documentation</div></a>
+      <a href="../../../../index.html"><div class="brand">numba-dpex 0.22.1+266.gf2d308057 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -157,7 +157,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
 
 
-  <span class="sidebar-brand-text">numba-dpex 0.22.1+259.g4deff1ad9 documentation</span>
+  <span class="sidebar-brand-text">numba-dpex 0.22.1+266.gf2d308057 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="../../../../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -765,7 +765,7 @@ <h2>Functions<a class="headerlink" href="#functions" title="Link to this heading
 
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=e9cac773"></script>
+</div><script src="../../../../_static/documentation_options.js?v=3a0f61da"></script>
     <script src="../../../../_static/doctools.js?v=888ff710"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=32e29ea5"></script>

dev/autoapi/numba_dpex/core/boxing/ranges/index.html

@@ -15,7 +15,7 @@
     <link rel="index" title="Index" href="../../../../../genindex.html" /><link rel="search" title="Search" href="../../../../../search.html" />
 
     <!-- Generated with Sphinx 7.2.6 and Furo 2024.01.29 -->
-        <title>numba_dpex.core.boxing.ranges - numba-dpex 0.22.1+259.g4deff1ad9 documentation</title>
+        <title>numba_dpex.core.boxing.ranges - numba-dpex 0.22.1+266.gf2d308057 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../../_static/styles/furo.css?v=135e06be" />
     <link rel="stylesheet" type="text/css" href="../../../../../_static/graphviz.css?v=eafc0fe6" />
@@ -134,7 +134,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../../index.html"><div class="brand">numba-dpex 0.22.1+259.g4deff1ad9 documentation</div></a>
+      <a href="../../../../../index.html"><div class="brand">numba-dpex 0.22.1+266.gf2d308057 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -157,7 +157,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../../index.html">
 
 
-  <span class="sidebar-brand-text">numba-dpex 0.22.1+259.g4deff1ad9 documentation</span>
+  <span class="sidebar-brand-text">numba-dpex 0.22.1+266.gf2d308057 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="../../../../../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -356,7 +356,7 @@ <h2>Functions<a class="headerlink" href="#functions" title="Link to this heading
 
     </aside>
   </div>
-</div><script src="../../../../../_static/documentation_options.js?v=e9cac773"></script>
+</div><script src="../../../../../_static/documentation_options.js?v=3a0f61da"></script>
     <script src="../../../../../_static/doctools.js?v=888ff710"></script>
     <script src="../../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../../_static/scripts/furo.js?v=32e29ea5"></script>

dev/autoapi/numba_dpex/core/boxing/usm_ndarray/index.html

@@ -15,7 +15,7 @@
     <link rel="index" title="Index" href="../../../../../genindex.html" /><link rel="search" title="Search" href="../../../../../search.html" />
 
     <!-- Generated with Sphinx 7.2.6 and Furo 2024.01.29 -->
-        <title>numba_dpex.core.boxing.usm_ndarray - numba-dpex 0.22.1+259.g4deff1ad9 documentation</title>
+        <title>numba_dpex.core.boxing.usm_ndarray - numba-dpex 0.22.1+266.gf2d308057 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../../_static/styles/furo.css?v=135e06be" />
     <link rel="stylesheet" type="text/css" href="../../../../../_static/graphviz.css?v=eafc0fe6" />
@@ -134,7 +134,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../../index.html"><div class="brand">numba-dpex 0.22.1+259.g4deff1ad9 documentation</div></a>
+      <a href="../../../../../index.html"><div class="brand">numba-dpex 0.22.1+266.gf2d308057 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -157,7 +157,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../../index.html">
 
 
-  <span class="sidebar-brand-text">numba-dpex 0.22.1+259.g4deff1ad9 documentation</span>
+  <span class="sidebar-brand-text">numba-dpex 0.22.1+266.gf2d308057 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="../../../../../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -363,7 +363,7 @@ <h2>Functions<a class="headerlink" href="#functions" title="Link to this heading
 
     </aside>
   </div>
-</div><script src="../../../../../_static/documentation_options.js?v=e9cac773"></script>
+</div><script src="../../../../../_static/documentation_options.js?v=3a0f61da"></script>
     <script src="../../../../../_static/doctools.js?v=888ff710"></script>
     <script src="../../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../../_static/scripts/furo.js?v=32e29ea5"></script>

dev/autoapi/numba_dpex/core/config/index.html

@@ -15,7 +15,7 @@
     <link rel="index" title="Index" href="../../../../genindex.html" /><link rel="search" title="Search" href="../../../../search.html" />
 
     <!-- Generated with Sphinx 7.2.6 and Furo 2024.01.29 -->
-        <title>numba_dpex.core.config - numba-dpex 0.22.1+259.g4deff1ad9 documentation</title>
+        <title>numba_dpex.core.config - numba-dpex 0.22.1+266.gf2d308057 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/styles/furo.css?v=135e06be" />
     <link rel="stylesheet" type="text/css" href="../../../../_static/graphviz.css?v=eafc0fe6" />
@@ -134,7 +134,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../../../index.html"><div class="brand">numba-dpex 0.22.1+259.g4deff1ad9 documentation</div></a>
+      <a href="../../../../index.html"><div class="brand">numba-dpex 0.22.1+266.gf2d308057 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -157,7 +157,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../../../index.html">
 
 
-  <span class="sidebar-brand-text">numba-dpex 0.22.1+259.g4deff1ad9 documentation</span>
+  <span class="sidebar-brand-text">numba-dpex 0.22.1+266.gf2d308057 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="../../../../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -398,7 +398,7 @@ <h2>Attributes<a class="headerlink" href="#attributes" title="Link to this headi
 
     </aside>
   </div>
-</div><script src="../../../../_static/documentation_options.js?v=e9cac773"></script>
+</div><script src="../../../../_static/documentation_options.js?v=3a0f61da"></script>
     <script src="../../../../_static/doctools.js?v=888ff710"></script>
     <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../../../_static/scripts/furo.js?v=32e29ea5"></script>