Add opt-in uv-build Python prebuilt installs

.github/workflows/vfox-test.yaml

@@ -63,6 +63,30 @@ jobs:
               exit 1
           fi
 
+      - name: Install Python 3.10.20 with uv-build
+        if: matrix.mirror == ''
+        env:
+          VFOX_PYTHON_USE_UV_BUILD: "1"
+        run: |
+          eval "$(vfox activate bash)"
+          vfox install python@3.10.20
+          vfox use -g python@3.10.20
+          vfox current
+
+      - name: Check uv-build python 3.10.20
+        if: matrix.mirror == ''
+        run: |
+          eval "$(vfox activate bash)"
+          python_version=$(python -c 'import sys;print(sys.version)')
+          echo $python_version
+
+          if [[ ! $python_version == 3.10.20* ]]; then
+              exit 1
+          fi
+
+          python -m pip --version
+          pip --version
+
   test-on-windows:
     runs-on: ${{ matrix.os }}
     strategy:
@@ -118,3 +142,44 @@ jobs:
           if ($python_version -notlike "${{ matrix.python-version }}*") {
               exit 1
           }
+
+      - name: Install Python 3.10.20 with uv-build
+        if: runner.os == 'Windows' && matrix.mirror == ''
+        env:
+          VFOX_PYTHON_USE_UV_BUILD: "1"
+        run: |
+          Invoke-Expression "$(vfox activate pwsh)"
+          vfox install python@3.10.20
+          if ($LASTEXITCODE -ne 0) {
+            exit $LASTEXITCODE
+          }
+          vfox use -g python@3.10.20
+          if ($LASTEXITCODE -ne 0) {
+            exit $LASTEXITCODE
+          }
+          vfox current
+          $python_version = $(python -c 'import sys;print(sys.version)')
+          if ($LASTEXITCODE -ne 0) {
+              Write-Error "failed to run python after uv-build install"
+              exit $LASTEXITCODE
+          }
+          Write-Output $python_version
+
+          if ($python_version -notlike "3.10.20*") {
+              Write-Error "expected uv-build python 3.10.20, got $python_version"
+              exit 1
+          }
+
+      - name: Check uv-build python 3.10.20
+        if: runner.os == 'Windows' && matrix.mirror == ''
+        run: |
+          Invoke-Expression "$(vfox activate pwsh)"
+          $python_version = $(python -c 'import sys;print(sys.version)')
+          Write-Output $python_version
+
+          if ($python_version -notlike "3.10.20*") {
+              exit 1
+          }
+
+          python -m pip --version
+          pip --version

README.md

@@ -20,3 +20,18 @@ is `https://www.python.org/ftp/python/`.
 ```bash
 export VFOX_PYTHON_MIRROR=https://mirrors.huaweicloud.com/python/
 ```
+
+## uv-build
+
+Set `VFOX_PYTHON_USE_UV_BUILD=1` to install prebuilt Python archives from the
+vfox vault uv-build endpoint instead of building from pyenv/python-build.
+
+On Linux, libc is detected automatically. Set `VFOX_PYTHON_UV_LIBC=gnu` or
+`VFOX_PYTHON_UV_LIBC=musl` to override detection.
+
+Set `VFOX_PYTHON_UV_BUILD_MIRROR` to download uv-build archives from a mirror.
+For example:
+
+```bash
+export VFOX_PYTHON_UV_BUILD_MIRROR=https://registry.npmmirror.com/-/binary/python-build-standalone/
+```

hooks/available.lua

@@ -1,8 +1,12 @@
 require("util")
 function PLUGIN:Available(ctx)
+    if useUvBuild() then
+        return parseVersionFromUvBuild()
+    end
+
     if OS_TYPE == "windows" then
         return parseVersion()
     else
         return parseVersionFromPyenv()
     end
-end
+end

hooks/post_install.lua

@@ -1,5 +1,9 @@
 require("util")
 function PLUGIN:PostInstall(ctx)
+    if useUvBuild() then
+        return uvBuildInstall(ctx)
+    end
+
     if OS_TYPE == "windows" then
         return windowsInstall(ctx)
     else

hooks/pre_install.lua

@@ -6,6 +6,10 @@ function PLUGIN:PreInstall(ctx)
         version = self:Available({})[1].version
     end
 
+    if useUvBuild() then
+        return uvBuildPreInstall(version)
+    end
+
     if OS_TYPE == "windows" and not checkIsReleaseVersion(version) then
         error("The current version is not released")
         return

hooks/pre_use.lua

@@ -34,7 +34,7 @@ function PLUGIN:PreUse(ctx)
         }
     end
 
-    local installPath = targetVersion.path
+    local installPath = resolvePythonInstallPath(targetVersion.path, version)
     print("Checking Python installation at: " .. installPath)
 
     -- Perform health check