Package: python3-rocm-docs
Version: 1.17.1-9
Severity: important
Tags: patch
Dear maintainer,
python3-rocm-docs generally assumes internet access, and hard-fails in
two cases, of which one can be worked around by setting the envvar
ROCM_DOCS_REMOTE_DETAILS.j
I have attached a proposed workaround for the other, by introducing an
envvar for this as well, ROCM_DOCS_SKIP_UPDATE_THEME_CONFIGS.
They way I see it, the skipped part is trivial. It just modifies the
theme based on whether this is a release, a candidate, latest, etc.
I tested this patch with rocrand 6.4 documentation build, and all looked
fine.
Best,
Christian
From: Christian Kastner <c...@debian.org>
Date: Tue, 24 Jun 2025 07:17:28 +0200
Subject: Add option to skip theme update
It's possible for the host to not have internet access, so
_update_theme_configs either needs a way to exit early, or it needs to
handle the failed request.
This implements the former in a user-configurable way.
---
src/rocm_docs/projects.py | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/src/rocm_docs/projects.py b/src/rocm_docs/projects.py
index 7aff032..9a0a261 100644
--- a/src/rocm_docs/projects.py
+++ b/src/rocm_docs/projects.py
@@ -342,6 +342,10 @@ def _update_theme_configs(
app: Sphinx, current_project: _Project | None, current_branch: str
) -> None:
"""Update configurations for use in theme.py"""
+ # In case of no internet access
+ if "ROCM_DOCS_SKIP_UPDATE_THEME_CONFIGS" in os.environ:
+ return
+
if latest_version := os.getenv('latest_version') is None:
latest_version = requests.get(
"https://raw.githubusercontent.com/ROCm/rocm-docs-core/data/latest_version.txt";
