feat: add run and toolbox-run commands for GNOME Shell with auto-detection

Author: leandromqrs

README.md

@@ -35,27 +35,31 @@ just install
 ## Commands
 
 ```
-just              # list all commands
-just build        # build everything (deps + CSS + TS + zip)
-just install      # build + install to GNOME Shell
-just quick        # rebuild + copy files (skip full install)
-just uninstall    # disable + remove extension
-just logs         # show recent extension logs
-just clean        # remove build artifacts
-just distclean    # remove artifacts + node_modules
-just validate     # type-check without emitting
-just lint         # run eslint
-just watch        # watch SCSS for changes
+just                # list all commands
+just build          # build everything (deps + CSS + TS + zip)
+just install        # build + install to GNOME Shell
+just quick          # rebuild + copy files (skip full install)
+just uninstall      # disable + remove extension
+just run            # build + install + run GNOME Shell (auto-detects --devkit or --nested)
+just toolbox-run    # same as run, but inside a toolbox
+just create-toolbox # create a Fedora toolbox for testing
+just logs           # show recent extension logs
+just clean          # remove build artifacts
+just distclean      # remove artifacts + node_modules
+just validate       # type-check without emitting
+just lint           # run eslint
+just watch          # watch SCSS for changes
 ```
 
 ## Testing
 
 ```bash
-# GNOME 49+
-dbus-run-session -- gnome-shell --devkit
+# Run directly on the host (builds, installs, and launches GNOME Shell)
+just run
 
-# GNOME 48 and earlier
-dbus-run-session -- gnome-shell --nested --wayland
+# Run inside a toolbox (useful when host lacks gnome-shell dev packages)
+just create-toolbox   # first time only
+just toolbox-run
 ```
 
 ## Adding a Module

justfile

@@ -1,5 +1,7 @@
 uuid := "aurora-shell@luminusos.github.io"
 ext_dir := env("HOME") / ".local/share/gnome-shell/extensions" / uuid
+toolbox_name := "gnome-shell-devel"
+toolbox_image := "registry.fedoraproject.org/fedora-toolbox:42"
 
 # List available commands
 default:
@@ -71,3 +73,38 @@ distclean: clean
 # Clean build + install
 all: clean build install
     @echo "Complete installation finished."
+
+# Run GNOME Shell with the extension (auto-detects --devkit or --nested)
+run: install
+    #!/usr/bin/env bash
+    set -e
+    if gnome-shell --help 2>&1 | grep -q -- --devkit; then
+        mode=--devkit
+    elif gnome-shell --help 2>&1 | grep -q -- --nested; then
+        mode=--nested
+    else
+        echo "Error: gnome-shell has neither --devkit nor --nested support" >&2
+        exit 1
+    fi
+    env XDG_CURRENT_DESKTOP=GNOME dbus-run-session gnome-shell "$mode"
+
+# Run GNOME Shell with the extension inside a toolbox (auto-detects --devkit or --nested)
+toolbox-run: install
+    #!/usr/bin/env bash
+    set -e
+    if toolbox --container {{ toolbox_name }} run gnome-shell --help 2>&1 | grep -q -- --devkit; then
+        mode=--devkit
+    elif toolbox --container {{ toolbox_name }} run gnome-shell --help 2>&1 | grep -q -- --nested; then
+        mode=--nested
+    else
+        echo "Error: gnome-shell has neither --devkit nor --nested support" >&2
+        exit 1
+    fi
+    toolbox --container {{ toolbox_name }} run \
+        env XDG_CURRENT_DESKTOP=GNOME dbus-run-session gnome-shell "$mode"
+
+# Create development toolbox for testing
+create-toolbox:
+    toolbox create --image {{ toolbox_image }} {{ toolbox_name }}
+    toolbox run --container {{ toolbox_name }} sudo dnf install -y gnome-shell glib2-devel
+    @echo "Toolbox '{{ toolbox_name }}' created successfully."