Update documentation

Author: github-actions[bot]

main/.doctrees/developers_guide/api.doctree

@@ -97,12 +97,29 @@ <h1>Source code for mache.deploy.bootstrap</h1><div class="highlight"><pre>
 
 <span class="kn">import</span><span class="w"> </span><span class="nn">argparse</span>
 <span class="kn">import</span><span class="w"> </span><span class="nn">os</span>
+<span class="kn">import</span><span class="w"> </span><span class="nn">platform</span>
 <span class="kn">import</span><span class="w"> </span><span class="nn">shlex</span>
 <span class="kn">import</span><span class="w"> </span><span class="nn">shutil</span>
 <span class="kn">import</span><span class="w"> </span><span class="nn">subprocess</span>
 <span class="kn">import</span><span class="w"> </span><span class="nn">sys</span>
 <span class="kn">from</span><span class="w"> </span><span class="nn">pathlib</span><span class="w"> </span><span class="kn">import</span> <span class="n">Path</span>
 
+<span class="n">CONDA_PLATFORM_MAP</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="p">(</span><span class="s1">&#39;linux&#39;</span><span class="p">,</span> <span class="s1">&#39;x86_64&#39;</span><span class="p">):</span> <span class="s1">&#39;linux-64&#39;</span><span class="p">,</span>
+    <span class="p">(</span><span class="s1">&#39;linux&#39;</span><span class="p">,</span> <span class="s1">&#39;aarch64&#39;</span><span class="p">):</span> <span class="s1">&#39;linux-aarch64&#39;</span><span class="p">,</span>
+    <span class="p">(</span><span class="s1">&#39;linux&#39;</span><span class="p">,</span> <span class="s1">&#39;ppc64le&#39;</span><span class="p">):</span> <span class="s1">&#39;linux-ppc64le&#39;</span><span class="p">,</span>
+    <span class="p">(</span><span class="s1">&#39;osx&#39;</span><span class="p">,</span> <span class="s1">&#39;x86_64&#39;</span><span class="p">):</span> <span class="s1">&#39;osx-64&#39;</span><span class="p">,</span>
+    <span class="p">(</span><span class="s1">&#39;osx&#39;</span><span class="p">,</span> <span class="s1">&#39;arm64&#39;</span><span class="p">):</span> <span class="s1">&#39;osx-arm64&#39;</span><span class="p">,</span>
+<span class="p">}</span>
+
+<span class="n">LOCAL_MACHE_SOURCE_ENV</span> <span class="o">=</span> <span class="s1">&#39;MACHE_LOCAL_SOURCE_PATH&#39;</span>
+<span class="n">PIXI_ENV_VARS_TO_UNSET</span> <span class="o">=</span> <span class="p">(</span>
+    <span class="s1">&#39;PIXI_PROJECT_MANIFEST&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;PIXI_PROJECT_ROOT&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;PIXI_ENVIRONMENT_NAME&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;PIXI_IN_SHELL&#39;</span><span class="p">,</span>
+<span class="p">)</span>
+
 
 <div class="viewcode-block" id="check_call">
 <a class="viewcode-back" href="../../../developers_guide/generated/mache.deploy.bootstrap.check_call.html#mache.deploy.bootstrap.check_call">[docs]</a>
@@ -297,7 +314,7 @@ <h1>Source code for mache.deploy.bootstrap</h1><div class="highlight"><pre>
 <span class="sd">    running a nested shell process.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="n">hook_cmd</span> <span class="o">=</span> <span class="p">(</span>
-        <span class="s1">&#39;env -u PIXI_PROJECT_MANIFEST -u PIXI_PROJECT_ROOT &#39;</span>
+        <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">build_pixi_env_unset_prefix</span><span class="p">()</span><span class="si">}</span><span class="s1"> &#39;</span>
         <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">shlex</span><span class="o">.</span><span class="n">quote</span><span class="p">(</span><span class="n">pixi_exe</span><span class="p">)</span><span class="si">}</span><span class="s1"> shell-hook -s bash -m &#39;</span>
         <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">shlex</span><span class="o">.</span><span class="n">quote</span><span class="p">(</span><span class="n">pixi_toml</span><span class="p">)</span><span class="si">}</span><span class="s1">&#39;</span>
     <span class="p">)</span>
@@ -463,7 +480,7 @@ <h1>Source code for mache.deploy.bootstrap</h1><div class="highlight"><pre>
 
         <span class="n">cmd_install</span> <span class="o">=</span> <span class="p">(</span>
             <span class="sa">f</span><span class="s1">&#39;cd &quot;</span><span class="si">{</span><span class="n">bootstrap_dir</span><span class="si">}</span><span class="s1">&quot; &amp;&amp; &#39;</span>
-            <span class="s1">&#39;env -u PIXI_PROJECT_MANIFEST -u PIXI_PROJECT_ROOT &#39;</span>
+            <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">build_pixi_env_unset_prefix</span><span class="p">()</span><span class="si">}</span><span class="s1"> &#39;</span>
             <span class="sa">f</span><span class="s1">&#39;&quot;</span><span class="si">{</span><span class="n">pixi_exe</span><span class="si">}</span><span class="s1">&quot; install&#39;</span>
         <span class="p">)</span>
         <span class="n">check_call</span><span class="p">(</span><span class="n">cmd_install</span><span class="p">,</span> <span class="n">log_filename</span><span class="p">,</span> <span class="n">quiet</span><span class="p">)</span>
@@ -490,7 +507,7 @@ <h1>Source code for mache.deploy.bootstrap</h1><div class="highlight"><pre>
 
         <span class="n">cmd_install</span> <span class="o">=</span> <span class="p">(</span>
             <span class="sa">f</span><span class="s1">&#39;cd &quot;</span><span class="si">{</span><span class="n">bootstrap_dir</span><span class="si">}</span><span class="s1">&quot; &amp;&amp; &#39;</span>
-            <span class="s1">&#39;env -u PIXI_PROJECT_MANIFEST -u PIXI_PROJECT_ROOT &#39;</span>
+            <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">build_pixi_env_unset_prefix</span><span class="p">()</span><span class="si">}</span><span class="s1"> &#39;</span>
             <span class="sa">f</span><span class="s1">&#39;&quot;</span><span class="si">{</span><span class="n">pixi_exe</span><span class="si">}</span><span class="s1">&quot; install&#39;</span>
         <span class="p">)</span>
         <span class="n">check_call</span><span class="p">(</span><span class="n">cmd_install</span><span class="p">,</span> <span class="n">log_filename</span><span class="p">,</span> <span class="n">quiet</span><span class="p">)</span>
@@ -679,6 +696,23 @@ <h1>Source code for mache.deploy.bootstrap</h1><div class="highlight"><pre>
     <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">home</span><span class="p">,</span> <span class="s1">&#39;.pixi&#39;</span><span class="p">,</span> <span class="s1">&#39;bin&#39;</span><span class="p">,</span> <span class="s1">&#39;pixi&#39;</span><span class="p">)</span>
 
 
+<span class="k">def</span><span class="w"> </span><span class="nf">build_pixi_env_unset_prefix</span><span class="p">():</span>
+    <span class="k">return</span> <span class="s1">&#39;env &#39;</span> <span class="o">+</span> <span class="s1">&#39; &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;-u </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s1">&#39;</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">PIXI_ENV_VARS_TO_UNSET</span><span class="p">)</span>
+
+
+<span class="k">def</span><span class="w"> </span><span class="nf">_get_pixi_platform</span><span class="p">():</span>
+    <span class="n">system</span> <span class="o">=</span> <span class="n">platform</span><span class="o">.</span><span class="n">system</span><span class="p">()</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
+    <span class="k">if</span> <span class="n">system</span> <span class="o">==</span> <span class="s1">&#39;darwin&#39;</span><span class="p">:</span>
+        <span class="n">system</span> <span class="o">=</span> <span class="s1">&#39;osx&#39;</span>
+    <span class="n">machine</span> <span class="o">=</span> <span class="n">platform</span><span class="o">.</span><span class="n">machine</span><span class="p">()</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="k">return</span> <span class="n">CONDA_PLATFORM_MAP</span><span class="p">[(</span><span class="n">system</span><span class="p">,</span> <span class="n">machine</span><span class="p">)]</span>
+    <span class="k">except</span> <span class="ne">KeyError</span> <span class="k">as</span> <span class="n">exc</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="s1">&#39;Unsupported platform for pixi bootstrap: </span><span class="si">{</span><span class="n">system</span><span class="si">}</span><span class="s1"> </span><span class="si">{</span><span class="n">machine</span><span class="si">}</span><span class="s1">&#39;</span>
+        <span class="p">)</span> <span class="kn">from</span><span class="w"> </span><span class="nn">exc</span>
+
+
 <span class="k">def</span><span class="w"> </span><span class="nf">_install_pixi</span><span class="p">(</span><span class="o">*</span><span class="p">,</span> <span class="n">log_filename</span><span class="p">,</span> <span class="n">quiet</span><span class="p">,</span> <span class="n">pixi_bin_dir</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
     <span class="n">env_prefix_parts</span> <span class="o">=</span> <span class="p">[</span>
         <span class="c1"># Avoid modifying shell rc files during bootstrap.</span>
@@ -782,6 +816,7 @@ <h1>Source code for mache.deploy.bootstrap</h1><div class="highlight"><pre>
         <span class="s1">&#39;[workspace]&#39;</span><span class="p">,</span>
         <span class="sa">f</span><span class="s1">&#39;name = &quot;</span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s1">&quot;&#39;</span><span class="p">,</span>
         <span class="s1">&#39;channels = [&quot;conda-forge&quot;]&#39;</span><span class="p">,</span>
+        <span class="sa">f</span><span class="s1">&#39;platforms = [&quot;</span><span class="si">{</span><span class="n">_get_pixi_platform</span><span class="p">()</span><span class="si">}</span><span class="s1">&quot;]&#39;</span><span class="p">,</span>
         <span class="s1">&#39;channel-priority = &quot;strict&quot;&#39;</span><span class="p">,</span>
         <span class="s1">&#39;&#39;</span><span class="p">,</span>
         <span class="s1">&#39;[dependencies]&#39;</span><span class="p">,</span>
@@ -822,6 +857,32 @@ <h1>Source code for mache.deploy.bootstrap</h1><div class="highlight"><pre>
 
     <span class="n">build_root</span><span class="o">.</span><span class="n">mkdir</span><span class="p">(</span><span class="n">parents</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
 
+    <span class="n">local_source</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">LOCAL_MACHE_SOURCE_ENV</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">local_source</span><span class="p">:</span>
+        <span class="n">source_repo</span> <span class="o">=</span> <span class="n">Path</span><span class="p">(</span>
+            <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">expanduser</span><span class="p">(</span><span class="n">local_source</span><span class="p">))</span>
+        <span class="p">)</span><span class="o">.</span><span class="n">resolve</span><span class="p">()</span>
+        <span class="k">if</span> <span class="ow">not</span> <span class="n">source_repo</span><span class="o">.</span><span class="n">is_dir</span><span class="p">():</span>
+            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span>
+                <span class="sa">f</span><span class="s1">&#39;Local mache source override does not exist: </span><span class="si">{</span><span class="n">source_repo</span><span class="si">}</span><span class="s1">&#39;</span>
+            <span class="p">)</span>
+
+        <span class="k">try</span><span class="p">:</span>
+            <span class="n">os</span><span class="o">.</span><span class="n">symlink</span><span class="p">(</span><span class="n">source_repo</span><span class="p">,</span> <span class="n">repo_dir</span><span class="p">,</span> <span class="n">target_is_directory</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+        <span class="k">except</span> <span class="ne">OSError</span><span class="p">:</span>
+            <span class="n">shutil</span><span class="o">.</span><span class="n">copytree</span><span class="p">(</span>
+                <span class="n">source_repo</span><span class="p">,</span>
+                <span class="n">repo_dir</span><span class="p">,</span>
+                <span class="n">ignore</span><span class="o">=</span><span class="n">shutil</span><span class="o">.</span><span class="n">ignore_patterns</span><span class="p">(</span>
+                    <span class="s1">&#39;.git&#39;</span><span class="p">,</span>
+                    <span class="s1">&#39;.pixi&#39;</span><span class="p">,</span>
+                    <span class="s1">&#39;deploy_tmp&#39;</span><span class="p">,</span>
+                    <span class="s1">&#39;__pycache__&#39;</span><span class="p">,</span>
+                    <span class="s1">&#39;*.pyc&#39;</span><span class="p">,</span>
+                <span class="p">),</span>
+            <span class="p">)</span>
+        <span class="k">return</span>
+
     <span class="n">commands</span> <span class="o">=</span> <span class="p">(</span>
         <span class="sa">f</span><span class="s1">&#39;cd &quot;</span><span class="si">{</span><span class="n">build_root</span><span class="si">!s}</span><span class="s1">&quot; &amp;&amp; &#39;</span>
         <span class="o">+</span> <span class="s2">&quot;GIT_SSH_COMMAND=&#39;ssh -oBatchMode=yes&#39; git clone &quot;</span>

main/.doctrees/environment.pickle

@@ -110,6 +110,7 @@ <h1>Source code for mache.deploy.run</h1><div class="highlight"><pre>
 <span class="kn">from</span><span class="w"> </span><span class="nn">mache.jigsaw</span><span class="w"> </span><span class="kn">import</span> <span class="n">deploy_jigsawpy</span>
 
 <span class="kn">from</span><span class="w"> </span><span class="nn">.bootstrap</span><span class="w"> </span><span class="kn">import</span> <span class="p">(</span>
+    <span class="n">build_pixi_env_unset_prefix</span><span class="p">,</span>
     <span class="n">build_pixi_shell_hook_prefix</span><span class="p">,</span>
     <span class="n">check_call</span><span class="p">,</span>
     <span class="n">check_location</span><span class="p">,</span>
@@ -1084,7 +1085,7 @@ <h1>Source code for mache.deploy.run</h1><div class="highlight"><pre>
     <span class="c1"># - Otherwise pixi uses its own defaults (typically under $HOME).</span>
     <span class="n">cmd</span> <span class="o">=</span> <span class="p">(</span>
         <span class="sa">f</span><span class="s1">&#39;cd </span><span class="si">{</span><span class="n">shlex</span><span class="o">.</span><span class="n">quote</span><span class="p">(</span><span class="n">project_dir</span><span class="p">)</span><span class="si">}</span><span class="s1"> &amp;&amp; &#39;</span>
-        <span class="s1">&#39;env -u PIXI_PROJECT_MANIFEST -u PIXI_PROJECT_ROOT &#39;</span>
+        <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">build_pixi_env_unset_prefix</span><span class="p">()</span><span class="si">}</span><span class="s1"> &#39;</span>
         <span class="sa">f</span><span class="s1">&#39;</span><span class="si">{</span><span class="n">shlex</span><span class="o">.</span><span class="n">quote</span><span class="p">(</span><span class="n">pixi_exe</span><span class="p">)</span><span class="si">}</span><span class="s1"> install&#39;</span>
     <span class="p">)</span>
     <span class="n">check_call</span><span class="p">(</span><span class="n">cmd</span><span class="p">,</span> <span class="n">log_filename</span><span class="o">=</span><span class="n">log_filename</span><span class="p">,</span> <span class="n">quiet</span><span class="o">=</span><span class="n">quiet</span><span class="p">)</span>