Update documentation

Author: github-actions[bot]

main/.doctrees/developers_guide/api.doctree

@@ -93,6 +93,14 @@ <h1>Source code for mache.spack.env</h1><div class="highlight"><pre>
 <span class="kn">from</span><span class="w"> </span><span class="nn">mache.spack.shared</span><span class="w"> </span><span class="kn">import</span> <span class="n">_get_modules</span><span class="p">,</span> <span class="n">_get_yaml_data</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">mache.version</span><span class="w"> </span><span class="kn">import</span> <span class="n">__version__</span>
 
+<span class="n">MPI_COMPILERS</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="s1">&#39;gnu&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;mpicc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">,</span> <span class="s1">&#39;mpifc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpif90&#39;</span><span class="p">},</span>
+    <span class="s1">&#39;intel&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;mpicc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">,</span> <span class="s1">&#39;mpifc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpif90&#39;</span><span class="p">},</span>
+    <span class="s1">&#39;oneapi-ifx&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;mpicc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">,</span> <span class="s1">&#39;mpifc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpif90&#39;</span><span class="p">},</span>
+    <span class="s1">&#39;impi&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;mpicc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpiicc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">:</span> <span class="s1">&#39;mpiicpc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpifc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpiifort&#39;</span><span class="p">},</span>
+    <span class="s1">&#39;cray&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;mpicc&#39;</span><span class="p">:</span> <span class="s1">&#39;cc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">:</span> <span class="s1">&#39;CC&#39;</span><span class="p">,</span> <span class="s1">&#39;mpifc&#39;</span><span class="p">:</span> <span class="s1">&#39;ftn&#39;</span><span class="p">},</span>
+<span class="p">}</span>
+
 
 <div class="viewcode-block" id="make_spack_env">
 <a class="viewcode-back" href="../../../developers_guide/generated/mache.spack.make_spack_env.html#mache.spack.make_spack_env">[docs]</a>
@@ -378,29 +386,23 @@ <h1>Source code for mache.spack.env</h1><div class="highlight"><pre>
 <span class="k">def</span><span class="w"> </span><span class="nf">_get_mpi_compilers</span><span class="p">(</span><span class="n">machine</span><span class="p">,</span> <span class="n">compiler</span><span class="p">,</span> <span class="n">mpi</span><span class="p">,</span> <span class="n">cray_compilers</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Get a list of compilers from a yaml file&quot;&quot;&quot;</span>
 
-    <span class="n">mpi_compilers</span> <span class="o">=</span> <span class="p">{</span>
-        <span class="s1">&#39;gnu&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;mpicc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">,</span> <span class="s1">&#39;mpifc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpif90&#39;</span><span class="p">},</span>
-        <span class="s1">&#39;intel&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;mpicc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">:</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">,</span> <span class="s1">&#39;mpifc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpif90&#39;</span><span class="p">},</span>
-        <span class="s1">&#39;impi&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;mpicc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpiicc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">:</span> <span class="s1">&#39;mpiicpc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpifc&#39;</span><span class="p">:</span> <span class="s1">&#39;mpiifort&#39;</span><span class="p">},</span>
-        <span class="s1">&#39;cray&#39;</span><span class="p">:</span> <span class="p">{</span><span class="s1">&#39;mpicc&#39;</span><span class="p">:</span> <span class="s1">&#39;cc&#39;</span><span class="p">,</span> <span class="s1">&#39;mpicxx&#39;</span><span class="p">:</span> <span class="s1">&#39;CC&#39;</span><span class="p">,</span> <span class="s1">&#39;mpifc&#39;</span><span class="p">:</span> <span class="s1">&#39;ftn&#39;</span><span class="p">},</span>
-    <span class="p">}</span>
-
     <span class="n">mpi_compiler</span> <span class="o">=</span> <span class="kc">None</span>
     <span class="c1"># first, get mpi compilers based on compiler</span>
-    <span class="k">if</span> <span class="n">compiler</span> <span class="ow">in</span> <span class="n">mpi_compilers</span><span class="p">:</span>
-        <span class="n">mpi_compiler</span> <span class="o">=</span> <span class="n">mpi_compilers</span><span class="p">[</span><span class="n">compiler</span><span class="p">]</span>
+    <span class="k">if</span> <span class="n">compiler</span> <span class="ow">in</span> <span class="n">MPI_COMPILERS</span><span class="p">:</span>
+        <span class="n">mpi_compiler</span> <span class="o">=</span> <span class="n">MPI_COMPILERS</span><span class="p">[</span><span class="n">compiler</span><span class="p">]</span>
 
     <span class="c1"># next, get mpi compilers based on mpi (higher priority)</span>
-    <span class="k">if</span> <span class="n">mpi</span> <span class="ow">in</span> <span class="n">mpi_compilers</span><span class="p">:</span>
-        <span class="n">mpi_compiler</span> <span class="o">=</span> <span class="n">mpi_compilers</span><span class="p">[</span><span class="n">mpi</span><span class="p">]</span>
+    <span class="k">if</span> <span class="n">mpi</span> <span class="ow">in</span> <span class="n">MPI_COMPILERS</span><span class="p">:</span>
+        <span class="n">mpi_compiler</span> <span class="o">=</span> <span class="n">MPI_COMPILERS</span><span class="p">[</span><span class="n">mpi</span><span class="p">]</span>
 
     <span class="c1"># finally, get mpi compilers if this is a cray machine (highest priority)</span>
     <span class="k">if</span> <span class="n">cray_compilers</span><span class="p">:</span>
-        <span class="n">mpi_compiler</span> <span class="o">=</span> <span class="n">mpi_compilers</span><span class="p">[</span><span class="s1">&#39;cray&#39;</span><span class="p">]</span>
+        <span class="n">mpi_compiler</span> <span class="o">=</span> <span class="n">MPI_COMPILERS</span><span class="p">[</span><span class="s1">&#39;cray&#39;</span><span class="p">]</span>
 
     <span class="k">if</span> <span class="n">mpi_compiler</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
         <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-            <span class="sa">f</span><span class="s2">&quot;Couldn&#39;t figure out MPI compilers for </span><span class="si">{</span><span class="n">machine</span><span class="si">}</span><span class="s2"> </span><span class="si">{</span><span class="n">compiler</span><span class="si">}</span><span class="s2"> </span><span class="si">{</span><span class="n">mpi</span><span class="si">}</span><span class="s2">&quot;</span>
+            <span class="sa">f</span><span class="s2">&quot;Couldn&#39;t figure out MPI compiler wrappers for </span><span class="si">{</span><span class="n">machine</span><span class="si">}</span><span class="s2"> &quot;</span>
+            <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">compiler</span><span class="si">}</span><span class="s1"> </span><span class="si">{</span><span class="n">mpi</span><span class="si">}</span><span class="s1">&#39;</span>
         <span class="p">)</span>
 
     <span class="k">return</span> <span class="n">mpi_compiler</span><span class="p">[</span><span class="s1">&#39;mpicc&#39;</span><span class="p">],</span> <span class="n">mpi_compiler</span><span class="p">[</span><span class="s1">&#39;mpicxx&#39;</span><span class="p">],</span> <span class="n">mpi_compiler</span><span class="p">[</span><span class="s1">&#39;mpifc&#39;</span><span class="p">]</span>