docs: make parallel builds configurable with environment variable

vpratz · vpratz · commit 717c76eca1cd · 2024-12-17T13:53:35.000Z
diff --git a/docsrc/Makefile b/docsrc/Makefile
@@ -25,7 +25,7 @@ dev:
 	@cp .nojekyll ../docs/.nojekyll
 
 github:
-	@sphinx-polyversion -vv poly.py
+	@BF_DOCS_SYNCHRONOUS_BUILDS=1 sphinx-polyversion -vv poly.py
 	@echo 'Copying docs to ../docs'
 	@cp -a _build_polyversion/. ../docs
 	@cp .nojekyll ../docs/.nojekyll
diff --git a/docsrc/poly.py b/docsrc/poly.py
@@ -24,7 +24,8 @@
 logger = getLogger(__name__)
 
 #: Whether to build the docs in parallel
-PARALLEL_BUILDS = False
+PARALLEL_BUILDS = os.environ.get("BF_DOCS_SYNCHRONOUS_BUILDS", "0") != "1"
+print(PARALLEL_BUILDS, "parallel")
 
 #: Determine repository root directory
 root = Git.root(Path(__file__).parent)
@@ -77,6 +78,7 @@ def data(driver, rev, env):
     for b in branches:
         if b.name == "master":
             latest = b
+            break
 
     # sort tags and branches by date, newest first
     return {
@@ -92,6 +94,10 @@ def root_data(driver):
     revisions = driver.builds
     branches, tags = refs_by_type(revisions)
     latest = max(tags or branches)
+    for b in branches:
+        if b.name == "master":
+            latest = b
+            break
     return {"revisions": revisions, "latest": latest}
 
 
@@ -230,7 +236,7 @@ async def __call__(self, path: Path) -> None:
 creator = LocalVenvCreator()
 
 
-def selector(rev, keys):
+async def selector(rev, keys):
     """Select configuration based on revision"""
     # map all v1 revisions to one configuration
     if rev.name.startswith("v1."):
diff --git a/docsrc/polyversion/templates/index.html b/docsrc/polyversion/templates/index.html
@@ -2,7 +2,7 @@
 
 <html>
     <head>
-        <title>Redirecting to master branch</title>
+    <title>Redirecting to {{ latest.name }} branch/version</title>
         <meta charset="utf-8" />
         <meta
             http-equiv="refresh"
