capture output from sphinx-build on failure

twisted · Aug 10, 2021 · 44762ac · 44762ac
1 parent 48aea96
commit 44762ac
Showing 1 changed file with 15 additions and 12 deletions.
diff --git a/src/twisted/python/_release.py b/src/twisted/python/_release.py
@@ -398,18 +398,21 @@ def build(self, docDir, buildDir=None, version=""):
 
         doctreeDir = buildDir.child("doctrees")
 
-        output = runCommand(
-            [
-                "sphinx-build",
-                "-q",
-                "-b",
-                "html",
-                "-d",
-                doctreeDir.path,
-                docDir.path,
-                buildDir.path,
-            ]
-        ).decode("utf-8")
+        try:
+            output = runCommand(
+                [
+                    "sphinx-build",
+                    "-q",
+                    "-b",
+                    "html",
+                    "-d",
+                    doctreeDir.path,
+                    docDir.path,
+                    buildDir.path,
+                ]
+            ).decode("utf-8")
+        except CalledProcessError as e:
+            raise Exception(f"stdout={e.stdout.decode()}\n\nstderr={e.stderr.decode()}")
 
         # Delete the doctrees, as we don't want them after the docs are built
         doctreeDir.remove()