Support Bash 3.0

.github/CONTRIBUTING.md

@@ -31,7 +31,7 @@ Contributions are licensed under the [MIT License](https://github.com/TypedDevs/
 
 ### Prerequisites
 
-- Bash 3.2+
+- Bash 3.0+
 - Git
 - Make
 - [ShellCheck](https://github.com/koalaman/shellcheck#installing)

.github/workflows/tests-bash-3.0.yml

@@ -0,0 +1,101 @@
+name: Bash 3.0 Compatibility
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-image:
+    name: "Build Bash 3.0 Image"
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Build Bash 3.0 Docker image
+        run: |
+          docker build -t bashunit-bash3 -f - . <<'EOF'
+          FROM debian:bullseye-slim
+
+          RUN apt-get update && apt-get install -y \
+              build-essential \
+              curl \
+              ca-certificates \
+              bison \
+              git \
+              procps \
+              && rm -rf /var/lib/apt/lists/*
+
+          WORKDIR /tmp
+          RUN curl -LO https://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz \
+              && tar xzf bash-3.0.tar.gz \
+              && cd bash-3.0 \
+              && curl -fsSL -o support/config.guess 'https://raw.githubusercontent.com/gcc-mirror/gcc/master/config.guess' \
+              && curl -fsSL -o support/config.sub 'https://raw.githubusercontent.com/gcc-mirror/gcc/master/config.sub' \
+              && chmod +x support/config.guess support/config.sub \
+              && ./configure --prefix=/opt/bash-3.0 \
+              && make \
+              && make install \
+              && rm -rf /tmp/bash-3.0*
+
+          WORKDIR /bashunit
+          CMD ["/opt/bash-3.0/bin/bash", "--version"]
+          EOF
+
+      - name: Save Docker image
+        run: docker save bashunit-bash3 -o /tmp/bashunit-bash3.tar
+
+      - name: Upload Docker image artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: bashunit-bash3-image
+          path: /tmp/bashunit-bash3.tar
+          retention-days: 1
+
+  test:
+    name: "Bash 3.0 - ${{ matrix.name }}"
+    runs-on: ubuntu-latest
+    needs: build-image
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: "Sequential"
+            flags: ""
+          - name: "Parallel"
+            flags: "--parallel"
+          - name: "Simple"
+            flags: "--simple"
+          - name: "Simple Parallel"
+            flags: "--simple --parallel"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Download Docker image artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: bashunit-bash3-image
+          path: /tmp
+
+      - name: Load Docker image
+        run: docker load --input /tmp/bashunit-bash3.tar
+
+      - name: Verify Bash 3.0 version
+        run: docker run --rm bashunit-bash3 /opt/bash-3.0/bin/bash --version
+
+      - name: Run tests with Bash 3.0 (${{ matrix.name }})
+        run: |
+          docker run --rm \
+            -v "$(pwd)":/bashunit \
+            -w /bashunit \
+            bashunit-bash3 \
+            /opt/bash-3.0/bin/bash ./bashunit ${{ matrix.flags }} tests/

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+### Changed
+- Lower minimum Bash version requirement from 3.2 to 3.0
+
 ### Added
 - Add Claude Code configuration with custom skills, agents, and rules
     - Custom skills for TDD workflow, test fixes, assertions, coverage, and releases

README.md

@@ -43,7 +43,7 @@ You can find the complete documentation for **bashunit** online, including insta
 
 ## Requirements
 
-bashunit requires **Bash 3.2** or newer.
+bashunit requires **Bash 3.0** or newer.
 
 ## Contribute
 

bashunit

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-declare -r BASHUNIT_MIN_BASH_VERSION="3.2"
+declare -r BASHUNIT_MIN_BASH_VERSION="3.0"
 
 function _check_bash_version() {
   local current_version
@@ -16,10 +16,10 @@ function _check_bash_version() {
     current_version="$(bash --version | head -n1 | cut -d' ' -f4 | cut -d. -f1,2)"
   fi
 
-  local major minor
-  IFS=. read -r major minor _ <<< "$current_version"
+  local major
+  IFS=. read -r major _ <<<"$current_version"
 
-  if (( major < 3 )) || { (( major == 3 )) && (( minor < 2 )); }; then
+  if ((major < 3)); then
     printf 'Bashunit requires Bash >= %s. Current version: %s\n' "$BASHUNIT_MIN_BASH_VERSION" "$current_version" >&2
     exit 1
   fi
@@ -41,16 +41,16 @@ export BASHUNIT_WORKING_DIR
 # Early scan for flags that must be set before loading env.sh
 for arg in "$@"; do
   case "$arg" in
-    --skip-env-file)
-      export BASHUNIT_SKIP_ENV_FILE=true
-      ;;
-    -l|--login)
-      export BASHUNIT_LOGIN_SHELL=true
-      ;;
-    --no-color)
-      # shellcheck disable=SC2034
-      BASHUNIT_NO_COLOR=true
-      ;;
+  --skip-env-file)
+    export BASHUNIT_SKIP_ENV_FILE=true
+    ;;
+  -l | --login)
+    export BASHUNIT_LOGIN_SHELL=true
+    ;;
+  --no-color)
+    # shellcheck disable=SC2034
+    BASHUNIT_NO_COLOR=true
+    ;;
   esac
 done
 
@@ -88,39 +88,39 @@ bashunit::clock::init
 _SUBCOMMAND=""
 
 case "${1:-}" in
-  test|bench|doc|init|learn|upgrade|assert)
-    _SUBCOMMAND="$1"
-    shift
-    ;;
-  -v|--version)
-    bashunit::console_header::print_version
-    exit 0
-    ;;
-  -h|--help)
-    bashunit::console_header::print_help
-    exit 0
-    ;;
-  -*)
-    # Flag without subcommand → assume "test"
-    _SUBCOMMAND="test"
-    ;;
-  "")
-    # No arguments → assume "test" (uses BASHUNIT_DEFAULT_PATH)
-    _SUBCOMMAND="test"
-    ;;
-  *)
-    # Path argument → assume "test"
-    _SUBCOMMAND="test"
-    ;;
+test | bench | doc | init | learn | upgrade | assert)
+  _SUBCOMMAND="$1"
+  shift
+  ;;
+-v | --version)
+  bashunit::console_header::print_version
+  exit 0
+  ;;
+-h | --help)
+  bashunit::console_header::print_help
+  exit 0
+  ;;
+-*)
+  # Flag without subcommand → assume "test"
+  _SUBCOMMAND="test"
+  ;;
+"")
+  # No arguments → assume "test" (uses BASHUNIT_DEFAULT_PATH)
+  _SUBCOMMAND="test"
+  ;;
+*)
+  # Path argument → assume "test"
+  _SUBCOMMAND="test"
+  ;;
 esac
 
 # Route to subcommand handler
 case "$_SUBCOMMAND" in
-  test)    bashunit::main::cmd_test "$@" ;;
-  bench)   bashunit::main::cmd_bench "$@" ;;
-  doc)     bashunit::main::cmd_doc "$@" ;;
-  init)    bashunit::main::cmd_init "$@" ;;
-  learn)   bashunit::main::cmd_learn "$@" ;;
-  upgrade) bashunit::main::cmd_upgrade "$@" ;;
-  assert)  bashunit::main::cmd_assert "$@" ;;
+test) bashunit::main::cmd_test "$@" ;;
+bench) bashunit::main::cmd_bench "$@" ;;
+doc) bashunit::main::cmd_doc "$@" ;;
+init) bashunit::main::cmd_init "$@" ;;
+learn) bashunit::main::cmd_learn "$@" ;;
+upgrade) bashunit::main::cmd_upgrade "$@" ;;
+assert) bashunit::main::cmd_assert "$@" ;;
 esac