Template index url

(cherry picked from commit 898ef27)

Author: NickCao

docs/source/conf.py

@@ -64,6 +64,14 @@ def get_controller_version():
     return asyncio.run(get_latest_compatible_controller_version(client_version=version))
 
 
+def get_index_url():
+    name = os.getenv("SPHINX_MULTIVERSION_NAME")
+    if name is None:
+        return "https://pkg.jumpstarter.dev/simple"
+    else:
+        return "https://pkg.jumpstarter.dev/{}/simple".format(name)
+
+
 myst_heading_anchors = 3
 myst_enable_extensions = [
     "substitution",
@@ -72,6 +80,7 @@ def get_controller_version():
     "requires_python": ">=3.11",
     "version": "latest",
     "controller_version": get_controller_version(),
+    "index_url": get_index_url(),
 }
 
 doctest_test_doctest_blocks = ""

docs/source/getting-started/installation/packages.md

@@ -20,19 +20,21 @@ tools you need to run an exporter or interact with your hardware as a client.
 Install the Python package using `pip` or a similar tool. You need Python
 {{requires_python}}:
 
-```shell
-$ pip3 install --extra-index-url https://pkg.jumpstarter.dev/simple/ jumpstarter-all
+```{code-block} shell
+:substitutions:
+$ pip3 install --extra-index-url {{index_url}} jumpstarter-all
 $ mkdir -p "${HOME}/.config/jumpstarter/"
 $ sudo mkdir /etc/jumpstarter
 ```
 
 The command above installs packages globally. For library usage, we recommend
 installing in a virtual environment instead:
 
-```shell
+```{code-block} shell
+:substitutions:
 $ python3 -m venv ~/.venv/jumpstarter
 $ source ~/.venv/jumpstarter/bin/activate
-$ pip3 install --extra-index-url https://pkg.jumpstarter.dev/simple/ jumpstarter-all
+$ pip3 install --extra-index-url {{index_url}} jumpstarter-all
 ```
 
 Additional package indexes are available, this is a complete list of our indexes:

packages/jumpstarter-cli-admin/jumpstarter_cli_admin/controller.py

@@ -1,5 +1,4 @@
 import aiohttp
-import click
 import semver
 from jumpstarter_cli_common.version import get_client_version
 from packaging.version import Version
@@ -23,13 +22,13 @@ async def get_latest_compatible_controller_version(
             ) as resp:
                 resp = await resp.json()
         except Exception as e:
-            raise click.ClickException(f"Failed to fetch controller versions: {e}") from e
+            raise RuntimeError(f"Failed to fetch controller versions: {e}") from e
 
     compatible = set()
     fallback = set()
 
     if not isinstance(resp, dict) or "tags" not in resp or not isinstance(resp["tags"], list):
-        raise click.ClickException("Unexpected response fetching controller version")
+        raise RuntimeError("Unexpected response fetching controller version")
 
     for tag in resp["tags"]:
         if not isinstance(tag, dict) or "name" not in tag: