Merge branch 'main' into lease-transfer

Author: bennyz

.devcontainer/Dockerfile

@@ -9,7 +9,5 @@ COPY --from=ghcr.io/astral-sh/uv:latest /uv  /bin/uv
 COPY --from=ghcr.io/astral-sh/uv:latest /uvx /bin/uvx
 COPY ./.python-version ./
 
-RUN uv python pin "$(cat .python-version)"
-
 # Install required tools for development
 RUN apt-get update && apt-get install -y iperf3 libusb-dev

.devcontainer/devcontainer.json

@@ -5,7 +5,7 @@
 		"dockerfile": "Dockerfile"
 	},
 	"postCreateCommand": "make sync",
-	"postStartCommand": "uv run pre-commit install",
+	"postStartCommand": "uv python pin 3.12 && uv run pre-commit install",
 	"remoteUser": "vscode",
 	// Mount USB devices to devcontainer for tests
 	"mounts": [

.github/workflows/documentation.yaml

@@ -42,7 +42,9 @@ jobs:
           version: "latest"
 
       - name: Install Python
-        run: uv python install
+        run: |
+          uv python pin 3.12
+          uv python install
 
       - name: Setup Pages
         id: pages
@@ -80,7 +82,9 @@ jobs:
           version: "latest"
 
       - name: Install Python
-        run: uv python install
+        run: |
+          uv python pin 3.12
+          uv python install
 
       - name: Build the documentation for the current version (no warnings allowed)
         run: make sync && make docs

.python-version

@@ -3,6 +3,17 @@
 [![Matrix](https://img.shields.io/matrix/jumpstarter%3Amatrix.org?color=blue)](https://matrix.to/#/#jumpstarter:matrix.org)
 [![Etherpad](https://img.shields.io/badge/Etherpad-Notes-blue?logo=etherpad)](https://etherpad.jumpstarter.dev/pad-lister)
 [![Community Meeting](https://img.shields.io/badge/Weekly%20Meeting-Google%20Meet-blue?logo=google-meet)](https://meet.google.com/gzd-hhbd-hpu)
+![GitHub Release](https://img.shields.io/github/v/release/jumpstarter-dev/jumpstarter)
+![PyPI - Version](https://img.shields.io/pypi/v/jumpstarter)
+![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/jumpstarter-dev/jumpstarter/total)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/jumpstarter-dev/jumpstarter)
+
+[![E2E Tests](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/e2e.yaml/badge.svg)](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/e2e.yaml)
+[![Tests](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/pytest.yaml/badge.svg)](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/pytest.yaml)
+[![documentation](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/documentation.yaml/badge.svg)](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/documentation.yaml)<br>
+[![Wheels](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/publish.yaml/badge.svg)](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/publish.yaml)
+[![Flashing bundles](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/build_oci_bundle.yaml/badge.svg)](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/build_oci_bundle.yaml)
+[![Containers](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/build.yaml/badge.svg)](https://github.com/jumpstarter-dev/jumpstarter/actions/workflows/build.yaml)
 
 A free, open source tool for automated testing on real and virtual hardware with
 CI/CD integration. Simplify device automation with consistent rules across local

README.md

@@ -42,6 +42,7 @@ Drivers that provide various communication interfaces:
   Protocol
 * **[TFTP](tftp.md)** (`jumpstarter-driver-tftp`) - Trivial File Transfer
   Protocol
+* **[VNC](vnc.md)** (`jumpstarter-driver-vnc`) - VNC (Virtual Network Computing) remote desktop protocol
 
 ### Storage and Data Drivers
 
@@ -111,5 +112,6 @@ tmt.md
 tftp.md
 uboot.md
 ustreamer.md
+vnc.md
 yepkit.md
 ```

docs/source/reference/package-apis/drivers/index.md

@@ -0,0 +1 @@
+../../../../../packages/jumpstarter-driver-vnc/README.md

docs/source/reference/package-apis/drivers/vnc.md

@@ -35,6 +35,7 @@ dependencies = [
   "jumpstarter-driver-tmt",
   "jumpstarter-driver-uboot",
   "jumpstarter-driver-ustreamer",
+  "jumpstarter-driver-vnc",
   "jumpstarter-driver-yepkit",
   "jumpstarter-imagehash",
   "jumpstarter-kubernetes",

packages/jumpstarter-all/pyproject.toml

@@ -22,9 +22,17 @@ def create():
 @opt_selector
 @opt_duration_partial(required=True)
 @opt_begin_time
+@click.option(
+    "--lease-id",
+    type=str,
+    default=None,
+    help="Optional lease ID to request (if not provided, server will generate one)",
+)
 @opt_output_all
 @handle_exceptions_with_reauthentication(relogin_client)
-def create_lease(config, selector: str, duration: timedelta, begin_time: datetime | None, output: OutputType):
+def create_lease(
+    config, selector: str, duration: timedelta, begin_time: datetime | None, lease_id: str | None, output: OutputType
+):
     """
     Create a lease
 
@@ -48,8 +56,14 @@ def create_lease(config, selector: str, duration: timedelta, begin_time: datetim
         $$ exit
         $ jmp delete lease "${JMP_LEASE}"
 
+    You can also specify a unique custom lease ID:
+
+    .. code-block:: bash
+
+        $ jmp create lease -l foo=bar --duration 1d --lease-id my-custom-lease-id
+
     """
 
-    lease = config.create_lease(selector=selector, duration=duration, begin_time=begin_time)
+    lease = config.create_lease(selector=selector, duration=duration, begin_time=begin_time, lease_id=lease_id)
 
     model_print(lease, output)

packages/jumpstarter-cli/jumpstarter_cli/create.py

@@ -20,7 +20,7 @@ def _run_shell_with_lease(lease, exporter_logs, config, command):
     def launch_remote_shell(path: str) -> int:
         return launch_shell(
             path, lease.exporter_name, config.drivers.allow, config.drivers.unsafe,
-            config.shell.use_profiles, command=command
+            config.shell.use_profiles, command=command, lease=lease
         )
 
     with lease.serve_unix() as path: