Improve the error message for invalid Pythons.

Refs #30
astral-sh · Jan 20, 2024 · e6512f6 · e6512f6
1 parent e6717de
commit e6512f6
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 4 deletions.
diff --git a/docs/guide/installation.md b/docs/guide/installation.md
@@ -19,7 +19,8 @@ a specific version download a binary directly
 ## Customized Installation
 
 On some platforms there is some limited support for customizing the installation
-experience.
+experience.  This for instance can be necessary on certain Linux environments such
+as Alpine where the Rye provided Python interpreter is not supported.
 
 === "Linux"
 

diff --git a/rye/src/bootstrap.rs b/rye/src/bootstrap.rs
@@ -122,9 +122,14 @@ pub fn ensure_self_venv(output: CommandOutput) -> Result<PathBuf, Error> {
     venv_cmd.arg(&venv_dir);
     set_proxy_variables(&mut venv_cmd);
 
-    let status = venv_cmd
-        .status()
-        .with_context(|| format!("unable to create self venv using {}", py_bin.display()))?;
+    let status = venv_cmd.status().with_context(|| {
+        format!(
+            "unable to create self venv using {}. It might be that \
+             the used Python build is incompatible with this machine. \
+             For more information see https://rye-up.com/guide/installation/",
+            py_bin.display()
+        )
+    })?;
     if !status.success() {
         bail!("failed to initialize virtualenv in {}", venv_dir.display());
     }