Unify dpnp public API exports by refactoring dpnp_iface.py (#2665)

This PR proposes to refactor the export structure of `dpnp_iface.py` by
moving all python function exports into `dpnp/__init__.py`
Redundant `__all__` declarations and wildcard imports inside
`dpnp_iface.py` have been removed. 167c3e6

Author: github-actions[bot]

.buildinfo

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

_modules/dpnp/dpnp_array.html

@@ -14,14 +14,14 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_array &mdash; Data Parallel Extension for NumPy 0.20.0dev1+20.g21718ad6b85 documentation</title>
+  <title>dpnp.dpnp_array &mdash; Data Parallel Extension for NumPy 0.20.0dev1+21.g167c3e6dac6 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=e59714d7" />
 
 
       <script src="../../_static/jquery.js?v=5d32c60e"></script>
       <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-      <script src="../../_static/documentation_options.js?v=82fce378"></script>
+      <script src="../../_static/documentation_options.js?v=cb75ae26"></script>
       <script src="../../_static/doctools.js?v=9bcbadda"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>

_modules/dpnp/dpnp_array_api_info.html

@@ -14,14 +14,14 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_array_api_info &mdash; Data Parallel Extension for NumPy 0.20.0dev1+20.g21718ad6b85 documentation</title>
+  <title>dpnp.dpnp_array_api_info &mdash; Data Parallel Extension for NumPy 0.20.0dev1+21.g167c3e6dac6 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=e59714d7" />
 
 
       <script src="../../_static/jquery.js?v=5d32c60e"></script>
       <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-      <script src="../../_static/documentation_options.js?v=82fce378"></script>
+      <script src="../../_static/documentation_options.js?v=cb75ae26"></script>
       <script src="../../_static/doctools.js?v=9bcbadda"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>

_modules/dpnp/dpnp_flatiter.html

@@ -14,14 +14,14 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_flatiter &mdash; Data Parallel Extension for NumPy 0.20.0dev1+20.g21718ad6b85 documentation</title>
+  <title>dpnp.dpnp_flatiter &mdash; Data Parallel Extension for NumPy 0.20.0dev1+21.g167c3e6dac6 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=e59714d7" />
 
 
       <script src="../../_static/jquery.js?v=5d32c60e"></script>
       <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-      <script src="../../_static/documentation_options.js?v=82fce378"></script>
+      <script src="../../_static/documentation_options.js?v=cb75ae26"></script>
       <script src="../../_static/doctools.js?v=9bcbadda"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>

_modules/dpnp/dpnp_iface.html

@@ -14,14 +14,14 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_iface_arraycreation &mdash; Data Parallel Extension for NumPy 0.20.0dev1+20.g21718ad6b85 documentation</title>
+  <title>dpnp.dpnp_iface_arraycreation &mdash; Data Parallel Extension for NumPy 0.20.0dev1+21.g167c3e6dac6 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=e59714d7" />
 
 
       <script src="../../_static/jquery.js?v=5d32c60e"></script>
       <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-      <script src="../../_static/documentation_options.js?v=82fce378"></script>
+      <script src="../../_static/documentation_options.js?v=cb75ae26"></script>
       <script src="../../_static/doctools.js?v=9bcbadda"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -146,47 +146,6 @@ <h1>Source code for dpnp.dpnp_iface_arraycreation</h1><div class="highlight"><pr
 <span class="c1"># pylint: disable=no-name-in-module</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">.dpnp_utils</span><span class="w"> </span><span class="kn">import</span> <span class="n">get_usm_allocations</span><span class="p">,</span> <span class="n">map_dtype_to_device</span>
 
-<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span>
-    <span class="s2">&quot;arange&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;array&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;asanyarray&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;asarray&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;ascontiguousarray&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;asfortranarray&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;astype&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;copy&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;diag&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;diagflat&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;empty&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;empty_like&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;eye&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;frombuffer&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;fromfile&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;fromfunction&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;fromiter&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;fromstring&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;from_dlpack&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;full&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;full_like&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;geomspace&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;identity&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;linspace&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;loadtxt&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;logspace&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;meshgrid&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;mgrid&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;ogrid&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;ones&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;ones_like&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;trace&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;tri&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;tril&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;triu&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;vander&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;zeros&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;zeros_like&quot;</span><span class="p">,</span>
-<span class="p">]</span>
-
 
 <span class="k">def</span><span class="w"> </span><span class="nf">_get_empty_array</span><span class="p">(</span>
     <span class="n">a</span><span class="p">,</span>

_modules/dpnp/dpnp_iface_arraycreation.html

@@ -14,14 +14,14 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_iface_bitwise &mdash; Data Parallel Extension for NumPy 0.20.0dev1+20.g21718ad6b85 documentation</title>
+  <title>dpnp.dpnp_iface_bitwise &mdash; Data Parallel Extension for NumPy 0.20.0dev1+21.g167c3e6dac6 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=e59714d7" />
 
 
       <script src="../../_static/jquery.js?v=5d32c60e"></script>
       <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-      <script src="../../_static/documentation_options.js?v=82fce378"></script>
+      <script src="../../_static/documentation_options.js?v=cb75ae26"></script>
       <script src="../../_static/doctools.js?v=9bcbadda"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -134,21 +134,6 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
 <span class="kn">import</span><span class="w"> </span><span class="nn">dpnp.backend.extensions.ufunc._ufunc_impl</span><span class="w"> </span><span class="k">as</span><span class="w"> </span><span class="nn">ufi</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">dpnp.dpnp_algo.dpnp_elementwise_common</span><span class="w"> </span><span class="kn">import</span> <span class="n">DPNPBinaryFunc</span><span class="p">,</span> <span class="n">DPNPUnaryFunc</span>
 
-<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span>
-    <span class="s2">&quot;binary_repr&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;bitwise_and&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;bitwise_count&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;bitwise_invert&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;bitwise_left_shift&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;bitwise_not&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;bitwise_or&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;bitwise_right_shift&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;bitwise_xor&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;invert&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;left_shift&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;right_shift&quot;</span><span class="p">,</span>
-<span class="p">]</span>
-
 
 <div class="viewcode-block" id="binary_repr">
 <a class="viewcode-back" href="../../reference/generated/dpnp.binary_repr.html#dpnp.binary_repr">[docs]</a>

_modules/dpnp/dpnp_iface_bitwise.html

@@ -14,14 +14,14 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_iface_counting &mdash; Data Parallel Extension for NumPy 0.20.0dev1+20.g21718ad6b85 documentation</title>
+  <title>dpnp.dpnp_iface_counting &mdash; Data Parallel Extension for NumPy 0.20.0dev1+21.g167c3e6dac6 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=e59714d7" />
 
 
       <script src="../../_static/jquery.js?v=5d32c60e"></script>
       <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-      <script src="../../_static/documentation_options.js?v=82fce378"></script>
+      <script src="../../_static/documentation_options.js?v=cb75ae26"></script>
       <script src="../../_static/doctools.js?v=9bcbadda"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -128,8 +128,6 @@ <h1>Source code for dpnp.dpnp_iface_counting</h1><div class="highlight"><pre>
 
 <span class="kn">import</span><span class="w"> </span><span class="nn">dpnp</span>
 
-<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;count_nonzero&quot;</span><span class="p">]</span>
-
 
 <div class="viewcode-block" id="count_nonzero">
 <a class="viewcode-back" href="../../reference/generated/dpnp.count_nonzero.html#dpnp.count_nonzero">[docs]</a>

_modules/dpnp/dpnp_iface_counting.html

@@ -14,14 +14,14 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_iface_functional &mdash; Data Parallel Extension for NumPy 0.20.0dev1+20.g21718ad6b85 documentation</title>
+  <title>dpnp.dpnp_iface_functional &mdash; Data Parallel Extension for NumPy 0.20.0dev1+21.g167c3e6dac6 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=e59714d7" />
 
 
       <script src="../../_static/jquery.js?v=5d32c60e"></script>
       <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-      <script src="../../_static/documentation_options.js?v=82fce378"></script>
+      <script src="../../_static/documentation_options.js?v=cb75ae26"></script>
       <script src="../../_static/doctools.js?v=9bcbadda"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -136,8 +136,6 @@ <h1>Source code for dpnp.dpnp_iface_functional</h1><div class="highlight"><pre>
 <span class="c1"># pylint: disable=no-name-in-module</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">dpnp.dpnp_utils</span><span class="w"> </span><span class="kn">import</span> <span class="n">get_usm_allocations</span>
 
-<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;apply_along_axis&quot;</span><span class="p">,</span> <span class="s2">&quot;apply_over_axes&quot;</span><span class="p">,</span> <span class="s2">&quot;piecewise&quot;</span><span class="p">]</span>
-
 
 <div class="viewcode-block" id="apply_along_axis">
 <a class="viewcode-back" href="../../reference/generated/dpnp.apply_along_axis.html#dpnp.apply_along_axis">[docs]</a>

_modules/dpnp/dpnp_iface_functional.html

@@ -14,14 +14,14 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_iface_histograms &mdash; Data Parallel Extension for NumPy 0.20.0dev1+20.g21718ad6b85 documentation</title>
+  <title>dpnp.dpnp_iface_histograms &mdash; Data Parallel Extension for NumPy 0.20.0dev1+21.g167c3e6dac6 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=e59714d7" />
 
 
       <script src="../../_static/jquery.js?v=5d32c60e"></script>
       <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-      <script src="../../_static/documentation_options.js?v=82fce378"></script>
+      <script src="../../_static/documentation_options.js?v=cb75ae26"></script>
       <script src="../../_static/doctools.js?v=9bcbadda"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -142,15 +142,6 @@ <h1>Source code for dpnp.dpnp_iface_histograms</h1><div class="highlight"><pre>
 <span class="c1"># pylint: disable=no-name-in-module</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">.dpnp_utils</span><span class="w"> </span><span class="kn">import</span> <span class="n">get_usm_allocations</span>
 
-<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span>
-    <span class="s2">&quot;bincount&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;digitize&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;histogram&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;histogram_bin_edges&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;histogram2d&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;histogramdd&quot;</span><span class="p">,</span>
-<span class="p">]</span>
-
 <span class="c1"># range is a keyword argument to many functions, so save the builtin so they can</span>
 <span class="c1"># use it.</span>
 <span class="n">_range</span> <span class="o">=</span> <span class="nb">range</span>