session: report more meaningful errors on why virtualenv creation failed

virtualenv fails if the destination directory contains unicode characters or spaces. A more descriptive error is printed if it's likely that that was the case. I didn't precheck the directory path for not supported characters because if this problem is fixed by upstream we wouldn't want execution to fail.
tox-dev · Jul 15, 2017 · da05e97 · da05e97
1 parent acc2e51
commit da05e97
Showing 1 changed file with 13 additions and 2 deletions.
diff --git a/tox/session.py b/tox/session.py
@@ -449,8 +449,19 @@ def setupenv(self, venv):
             envlog = self.resultlog.get_envlog(venv.name)
             try:
                 status = venv.update(action=action)
-            except tox.exception.InvocationError:
-                status = sys.exc_info()[1]
+            except FileNotFoundError as e:
+                status = (
+                    "Error creating virtualenv. "
+                    "Note that spaces in path are not supported by virtualenv. "
+                    "Error details: %r" % e
+                )
+            except tox.exception.InvocationError as e:
+                status = (
+                    "Error creating virtualenv. "
+                    "Note that some special characters (such as ':' and unicode symbols) "
+                    "in path are not supported by virtualenv. "
+                    "Error details: %r" % e
+                )
             if status:
                 commandlog = envlog.get_commandlog("setup")
                 commandlog.add_command(["setup virtualenv"], str(status), 1)