feat(ci): fail loud on bad download, add PATH + version outputs

install.sh now exits non-zero (and leaves no bogus binary) when a release
cannot be downloaded, via 'curl -fL' plus a post-download file check, instead
of silently printing success. Regression test added.

The action gains an 'add-to-path' input (default true) that appends the install
dir to $GITHUB_PATH so consumers run bare 'bashunit', and a 'version' output
exposing the installed version.

Author: Chemaclass

.github/workflows/test-action.yml

@@ -39,7 +39,10 @@ jobs:
       - name: Verify the binary is installed and runnable
         env:
           BASHUNIT_PATH: ${{ steps.bashunit.outputs.path }}
+          BASHUNIT_INSTALLED_VERSION: ${{ steps.bashunit.outputs.version }}
         run: |
           set -euo pipefail
           test -x "$BASHUNIT_PATH"
-          "$BASHUNIT_PATH" --version
+          test -n "$BASHUNIT_INSTALLED_VERSION"
+          # add-to-path defaults to true, so "bashunit" resolves on PATH
+          bashunit --version

CHANGELOG.md

@@ -7,6 +7,7 @@
 
 ### Fixed
 - `install.sh` creates nested target directories (`mkdir -p`), so non-existing parent folders no longer fail the install
+- `install.sh` now fails loudly (non-zero exit, no bogus binary) when a version cannot be downloaded, instead of silently reporting success
 
 ## [0.37.0](https://github.com/TypedDevs/bashunit/compare/0.36.0...0.37.0) - 2026-06-03
 

action.yml

@@ -15,11 +15,18 @@ inputs:
     description: 'Directory, relative to the workspace, where the bashunit binary is installed.'
     required: false
     default: lib
+  add-to-path:
+    description: 'Add the install directory to $GITHUB_PATH so you can run "bashunit" directly.'
+    required: false
+    default: 'true'
 
 outputs:
   path:
     description: Path to the installed bashunit binary, relative to the workspace.
     value: ${{ steps.install.outputs.path }}
+  version:
+    description: The installed bashunit version (e.g. "0.37.0").
+    value: ${{ steps.install.outputs.version }}
 
 runs:
   using: composite
@@ -29,6 +36,7 @@ runs:
       env:
         BASHUNIT_VERSION: ${{ inputs.version }}
         BASHUNIT_DIRECTORY: ${{ inputs.directory }}
+        BASHUNIT_ADD_TO_PATH: ${{ inputs.add-to-path }}
         BASHUNIT_ACTION_PATH: ${{ github.action_path }}
       run: |
         set -euo pipefail
@@ -42,3 +50,10 @@ runs:
         "$BASHUNIT_ACTION_PATH/install.sh" "$target_dir" "$BASHUNIT_VERSION"
 
         echo "path=$BASHUNIT_DIRECTORY/bashunit" >> "$GITHUB_OUTPUT"
+
+        version="$(NO_COLOR=1 "$target_dir/bashunit" --version | awk 'NR==1{print $NF}')"
+        echo "version=$version" >> "$GITHUB_OUTPUT"
+
+        if [ "$BASHUNIT_ADD_TO_PATH" = "true" ]; then
+          echo "$target_dir" >> "$GITHUB_PATH"
+        fi

docs/installation.md

@@ -239,11 +239,16 @@ jobs:
       # Pin to a commit SHA; the comment tracks the human-readable tag.
       - uses: TypedDevs/bashunit@<commit-sha> # {{ pkg.version }}
         with:
-          version: '{{ pkg.version }}' # or "latest"
+          version: '{{ pkg.version }}' # or "latest" (default)
           directory: lib               # optional, "lib" by default
-      - run: ./lib/bashunit tests
+          add-to-path: 'true'          # optional, "true" by default
+      # add-to-path puts the binary on $PATH, so just call "bashunit":
+      - run: bashunit tests
 ```
 
+**Inputs:** `version` (default `latest`), `directory` (default `lib`), `add-to-path` (default `true`).
+**Outputs:** `path` (binary path relative to the workspace), `version` (installed version).
+
 ```yaml [via install.sh]
 # .github/workflows/bashunit-tests.yml
 name: Tests

install.sh

@@ -44,12 +44,19 @@ function install() {
     echo "> Downloading the latest version: '$TAG'"
   fi
 
+  local url="$BASHUNIT_GIT_REPO/releases/download/$TAG/bashunit"
   if command -v curl >/dev/null 2>&1; then
-    curl -L -O -J "$BASHUNIT_GIT_REPO/releases/download/$TAG/bashunit" 2>/dev/null
+    curl -fL -O -J "$url" 2>/dev/null
   elif command -v wget >/dev/null 2>&1; then
-    wget "$BASHUNIT_GIT_REPO/releases/download/$TAG/bashunit" 2>/dev/null
+    wget "$url" 2>/dev/null
   else
-    echo "Cannot download bashunit: curl or wget not found."
+    echo "Cannot download bashunit: curl or wget not found." >&2
+    exit 1
+  fi
+
+  if [ ! -f "bashunit" ]; then
+    echo "Error: failed to download bashunit '$TAG' from $url" >&2
+    exit 1
   fi
   chmod u+x "bashunit"
 }

tests/acceptance/install_test.sh

@@ -109,6 +109,18 @@ function test_install_downloads_in_nested_folder() {
   assert_file_exists "$installed_bashunit"
 }
 
+function test_install_fails_loudly_on_unknown_version() {
+  if [[ "$ACTIVE_INTERNET" -eq 1 ]]; then
+    bashunit::skip "no internet connection" && return
+  fi
+  if [[ "$HAS_DOWNLOADER" -eq 0 ]]; then
+    bashunit::skip "curl or wget not installed" && return
+  fi
+
+  assert_general_error "$(./install.sh tmp_install 99.99.99 2>&1)"
+  assert_file_not_exists "./tmp_install/bashunit"
+}
+
 function test_install_downloads_the_given_version() {
   if [[ "$ACTIVE_INTERNET" -eq 1 ]]; then
     bashunit::skip "no internet connection" && return