Update documentation

Author: github-actions[bot]

main/.doctrees/developers_guide/api.doctree

@@ -322,26 +322,17 @@ <h1>Source code for mache.spack.env</h1><div class="highlight"><pre>
         <span class="k">if</span> <span class="n">config</span><span class="o">.</span><span class="n">has_option</span><span class="p">(</span><span class="s1">&#39;spack&#39;</span><span class="p">,</span> <span class="s1">&#39;cray_compilers&#39;</span><span class="p">):</span>
             <span class="n">cray_compilers</span> <span class="o">=</span> <span class="n">section</span><span class="o">.</span><span class="n">getboolean</span><span class="p">(</span><span class="s1">&#39;cray_compilers&#39;</span><span class="p">)</span>
 
-    <span class="n">mod_env_commands</span> <span class="o">=</span> <span class="s1">&#39;module purge</span><span class="se">\n</span><span class="s1">&#39;</span>
-
-    <span class="k">for</span> <span class="n">shell_filename</span> <span class="ow">in</span> <span class="p">[</span>
-        <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">machine</span><span class="si">}</span><span class="s1">.</span><span class="si">{</span><span class="n">shell</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">,</span>
-        <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">machine</span><span class="si">}</span><span class="s1">_</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">.</span><span class="si">{</span><span class="n">shell</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">,</span>
-    <span class="p">]:</span>
-        <span class="n">path</span> <span class="o">=</span> <span class="p">(</span>
-            <span class="n">importlib_resources</span><span class="o">.</span><span class="n">files</span><span class="p">(</span><span class="s1">&#39;mache.spack.templates&#39;</span><span class="p">)</span> <span class="o">/</span> <span class="n">shell_filename</span>
-        <span class="p">)</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">path</span><span class="p">))</span> <span class="k">as</span> <span class="n">fp</span><span class="p">:</span>
-                <span class="n">template</span> <span class="o">=</span> <span class="n">Template</span><span class="p">(</span><span class="n">fp</span><span class="o">.</span><span class="n">read</span><span class="p">())</span>
-        <span class="k">except</span> <span class="ne">FileNotFoundError</span><span class="p">:</span>
-            <span class="c1"># there&#39;s nothing to add, which is fine</span>
-            <span class="k">continue</span>
-        <span class="n">shell_script</span> <span class="o">=</span> <span class="n">template</span><span class="o">.</span><span class="n">render</span><span class="p">(</span>
-            <span class="n">e3sm_lapack</span><span class="o">=</span><span class="n">include_e3sm_lapack</span><span class="p">,</span>
-            <span class="n">e3sm_hdf5_netcdf</span><span class="o">=</span><span class="n">include_e3sm_hdf5_netcdf</span><span class="p">,</span>
-        <span class="p">)</span>
-        <span class="n">mod_env_commands</span> <span class="o">=</span> <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">mod_env_commands</span><span class="si">}</span><span class="se">\n</span><span class="si">{</span><span class="n">shell_script</span><span class="si">}</span><span class="s1">&#39;</span>
+    <span class="n">mod_env_commands</span> <span class="o">=</span> <span class="n">get_spack_script</span><span class="p">(</span>
+        <span class="n">spack_path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+        <span class="n">env_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+        <span class="n">compiler</span><span class="o">=</span><span class="n">compiler</span><span class="p">,</span>
+        <span class="n">mpi</span><span class="o">=</span><span class="n">mpi</span><span class="p">,</span>
+        <span class="n">shell</span><span class="o">=</span><span class="n">shell</span><span class="p">,</span>
+        <span class="n">machine</span><span class="o">=</span><span class="n">machine</span><span class="p">,</span>
+        <span class="n">load_spack_env</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
+        <span class="n">include_e3sm_lapack</span><span class="o">=</span><span class="n">include_e3sm_lapack</span><span class="p">,</span>
+        <span class="n">include_e3sm_hdf5_netcdf</span><span class="o">=</span><span class="n">include_e3sm_hdf5_netcdf</span><span class="p">,</span>
+    <span class="p">)</span>
 
     <span class="n">mpicc</span><span class="p">,</span> <span class="n">mpicxx</span><span class="p">,</span> <span class="n">mpifc</span> <span class="o">=</span> <span class="n">_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>