Add utility script to run samples

Author: fmbenhassine

README.adoc

@@ -87,6 +87,33 @@ You can find complete tutorials and sample applications in the `spring-shell-sam
 - https://github.com/spring-projects/spring-shell/tree/main/spring-shell-samples/spring-shell-sample-non-interactive[Non-interactive Spring Shell application]
 - https://github.com/spring-projects/spring-shell/tree/main/spring-shell-samples/spring-shell-sample-secure-input[Spring Shell application to demonstrate secure input]
 
+A convenience script is provided to quickly launch any sample from the repository root:
+
+[source,bash]
+----
+$>./run-sample.sh
+----
+
+The script presents an interactive menu:
+
+[source]
+----
+Spring Shell Samples
+====================
+
+Select a sample to run:
+
+  1) hello-world       — Simple greeting shell application
+  2) non-interactive   — Non-interactive sample (runs 'hi' and exits)
+  3) petclinic         — Spring PetClinic shell application
+  4) secure-input      — Secure input / password prompt sample
+  5) spring-boot       — Spring Boot-based shell application
+
+Enter your choice [1-5]:
+----
+
+Enter the number corresponding to the sample you want to run and press Enter. The appropriate Maven command will be executed automatically.
+
 == Getting Help
 Are you having trouble with Spring Shell? We want to help!
 

run-sample.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+echo "Spring Shell Samples"
+echo "===================="
+echo ""
+echo "Select a sample to run:"
+echo ""
+echo "  1) hello-world       — Simple greeting shell application"
+echo "  2) non-interactive   — Non-interactive sample (runs 'hi' and exits)"
+echo "  3) petclinic         — Spring PetClinic shell application"
+echo "  4) secure-input      — Secure input / password prompt sample"
+echo "  5) spring-boot       — Spring Boot-based shell application"
+echo ""
+read -rp "Enter your choice [1-5]: " choice
+
+case "$choice" in
+  1)
+    echo ""
+    echo "Running: hello-world"
+    ./mvnw -pl org.springframework.shell:spring-shell-sample-hello-world \
+      exec:java -Dexec.mainClass=org.springframework.shell.samples.helloworld.SpringShellApplication
+    ;;
+  2)
+    echo ""
+    echo "Running: non-interactive"
+    ./mvnw -pl org.springframework.shell:spring-shell-sample-non-interactive \
+      spring-boot:run -Dspring-boot.run.arguments=hi
+    ;;
+  3)
+    echo ""
+    echo "Running: petclinic"
+    ./mvnw -pl org.springframework.shell:spring-shell-sample-petclinic \
+      exec:java -Dexec.mainClass=org.springframework.shell.samples.petclinic.SpringShellApplication
+    ;;
+  4)
+    echo ""
+    echo "Running: secure-input"
+    ./mvnw -pl org.springframework.shell:spring-shell-sample-secure-input \
+      spring-boot:run
+    ;;
+  5)
+    echo ""
+    echo "Running: spring-boot"
+    ./mvnw -pl org.springframework.shell:spring-shell-sample-spring-boot \
+      spring-boot:run
+    ;;
+  *)
+    echo "Invalid choice: '$choice'. Please enter a number between 1 and 5." >&2
+    exit 1
+    ;;
+esac