Merge pull request #428 from TypedDevs/feat/install-with-only-version-arg

Make installer args more flexible

Author: Chemaclass

CHANGELOG.md

@@ -10,6 +10,7 @@
 - Support placeholder `::ignore::` in snapshots
 - Add project overview docs
 - Improve clock performance
+- Make install.sh args more flexible
 
 ## [0.20.0](https://github.com/TypedDevs/bashunit/compare/0.19.1...0.20.0) - 2025-06-01
 

docs/installation.md

@@ -31,13 +31,13 @@ https://github.com/TypedDevs/bashunit/releases/download/{{ pkg.version }}/checks
 
 #### Define custom tag and folder
 
-The installation script can receive two optional arguments:
+The installation script can receive arguments (in any order):
 
 ```bash
 curl -s https://bashunit.typeddevs.com/install.sh | bash -s [dir] [version]
 ```
 - `[dir]`: the destiny directory to save the executable bashunit; `lib` by default
-- `[version]`: the [release](https://github.com/TypedDevs/bashunit/releases) to download, for instance `{{ pkg.version }}`; `latest` by default
+- `[version]`: the [release](https://github.com/TypedDevs/bashunit/releases) to download, for instance `{{ pkg.version }}`; `latest` by default.
 
 ::: tip
 You can use `beta` as `[version]` to get the next non-stable preview release.

install.sh

@@ -63,8 +63,33 @@ function install() {
 ######### MAIN ##########
 #########################
 
-DIR=${1-lib}
-VERSION=${2-latest}
+# Defaults
+DIR="lib"
+VERSION="latest"
+
+function is_version() {
+  [[ "$1" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ || "$1" == "latest" || "$1" == "beta" ]]
+}
+
+# Parse arguments flexibly
+if [[ $# -eq 1 ]]; then
+  if is_version "$1"; then
+    VERSION="$1"
+  else
+    DIR="$1"
+  fi
+elif [[ $# -eq 2 ]]; then
+  if is_version "$1"; then
+    VERSION="$1"
+    DIR="$2"
+  elif is_version "$2"; then
+    DIR="$1"
+    VERSION="$2"
+  else
+    echo "Invalid arguments. Expected version or directory." >&2
+    exit 1
+  fi
+fi
 
 BASHUNIT_GIT_REPO="https://github.com/TypedDevs/bashunit"
 if is_git_installed; then

tests/acceptance/install_test.sh

@@ -84,6 +84,29 @@ function test_install_downloads_the_given_version() {
     "$("$installed_bashunit" --env "$TEST_ENV_FILE" --version)"
 }
 
+function test_install_downloads_the_given_version_without_dir() {
+  if [[ "$ACTIVE_INTERNET" -eq 1 ]]; then
+    skip "no internet connection" && return
+  fi
+
+  local installed_bashunit="./lib/bashunit"
+  local output
+  output="$(./install.sh 0.19.0)"
+
+  assert_same \
+    "$(printf "%s\n" \
+      "> Downloading a concrete version: '0.19.0'" \
+      "> bashunit has been installed in the 'lib' folder" \
+    )" \
+    "$output"
+
+  assert_file_exists "$installed_bashunit"
+
+  assert_same \
+    "$(printf "\e[1m\e[32mbashunit\e[0m - 0.19.0")" \
+    "$("$installed_bashunit" --env "$TEST_ENV_FILE" --version)"
+}
+
 function test_install_downloads_the_non_stable_beta_version() {
   if [[ "$ACTIVE_INTERNET" -eq 1 ]]; then
     skip "no internet connection" && return