feat: lower bash support from 3.2 to 3.0

Author: Chemaclass

.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/copilot-instructions.md

@@ -28,7 +28,7 @@ An open-source **library** providing a fast, portable Bash testing framework: **
 * Minimal overhead, plain Bash test files.
 * Rich **assertions**, **test doubles (mock/spy)**, **data providers**, **snapshots**, **skip/todo**, **globals utilities**, **custom assertions**, **benchmarks**, and **standalone** runs.
 
-**Compatibility**: Bash 3.2+ (macOS, Linux, WSL). No external dependencies beyond standard Unix tools.
+**Compatibility**: Bash 3.0+ (macOS, Linux, WSL). No external dependencies beyond standard Unix tools.
 
 ---
 
@@ -284,7 +284,7 @@ We practice two nested feedback loops to deliver behavior safely and quickly.
 
 ### Compatibility & Portability
 ```bash
-# ✅ GOOD - Works on Bash 3.2+
+# ✅ GOOD - Works on Bash 3.0+
 [[ -n "${var:-}" ]] && echo "set"
 array=("item1" "item2")
 
@@ -1000,7 +1000,7 @@ Use this template for internal changes, fixes, refactors, documentation.
 - **All tests pass** (`./bashunit tests/`)
 - **Shellcheck passes** with existing exceptions (`shellcheck -x $(find . -name "*.sh")`)
 - **Code formatted** (`shfmt -w .`)
-- **Bash 3.2+ compatible** (no `declare -A`, no `readarray`, no `${var^^}`)
+- **Bash 3.0+ compatible** (no `declare -A`, no `readarray`, no `${var^^}`)
 - **Follows established module namespacing** patterns
 
 ### ✅ Testing (following observed patterns)

CHANGELOG.md

@@ -12,6 +12,7 @@
     - tear_down
     - set_up_before_script
     - tear_down_after_script
+- Support Bash 3.0 (Previously 3.2)
 
 ## [0.24.0](https://github.com/TypedDevs/bashunit/compare/0.23.0...0.24.0) - 2025-09-14
 

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
@@ -19,7 +19,7 @@ function _check_bash_version() {
   local major minor
   IFS=. read -r major minor _ <<< "$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

build.sh

@@ -71,7 +71,8 @@ function build::process_file() {
     sourced_file=$(eval echo "$sourced_file")
 
     # Handle relative paths if necessary
-    if [[ ! "$sourced_file" =~ ^/ ]]; then
+    local absolute_path_pattern='^/'
+    if [[ ! "$sourced_file" =~ $absolute_path_pattern ]]; then
       sourced_file="$(dirname "$file")/$sourced_file"
     fi
 

install.sh

@@ -68,7 +68,8 @@ DIR="lib"
 VERSION="latest"
 
 function is_version() {
-  [[ "$1" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ || "$1" == "latest" || "$1" == "beta" ]]
+  local version_pattern='^[0-9]+\.[0-9]+\.[0-9]+$'
+  [[ "$1" =~ $version_pattern || "$1" == "latest" || "$1" == "beta" ]]
 }
 
 # Parse arguments flexibly

src/assert.sh

@@ -51,10 +51,12 @@ function assert_false() {
 
 function run_command_or_eval() {
   local cmd="$1"
+  local eval_pattern='^eval'
+  local alias_pattern='^alias'
 
-  if [[ "$cmd" =~ ^eval ]]; then
+  if [[ "$cmd" =~ $eval_pattern ]]; then
     eval "${cmd#eval }" &> /dev/null
-  elif [[ "$(command -v "$cmd")" =~ ^alias ]]; then
+  elif [[ "$(command -v "$cmd")" =~ $alias_pattern ]]; then
     eval "$cmd" &> /dev/null
   else
     "$cmd" &> /dev/null

src/benchmark.sh

@@ -16,21 +16,27 @@ function benchmark::parse_annotations() {
   local annotation
   annotation=$(awk "/function[[:space:]]+${fn_name}[[:space:]]*\(/ {print prev; exit} {prev=\$0}" "$script")
 
-  if [[ $annotation =~ @revs=([0-9]+) ]]; then
+  local revs_pattern='@revs=([0-9]+)'
+  local revolutions_pattern='@revolutions=([0-9]+)'
+  local its_pattern='@its=([0-9]+)'
+  local iterations_pattern='@iterations=([0-9]+)'
+  local max_ms_pattern='@max_ms=([0-9.]+)'
+
+  if [[ $annotation =~ $revs_pattern ]]; then
     revs="${BASH_REMATCH[1]}"
-  elif [[ $annotation =~ @revolutions=([0-9]+) ]]; then
+  elif [[ $annotation =~ $revolutions_pattern ]]; then
     revs="${BASH_REMATCH[1]}"
   fi
 
-  if [[ $annotation =~ @its=([0-9]+) ]]; then
+  if [[ $annotation =~ $its_pattern ]]; then
     its="${BASH_REMATCH[1]}"
-  elif [[ $annotation =~ @iterations=([0-9]+) ]]; then
+  elif [[ $annotation =~ $iterations_pattern ]]; then
     its="${BASH_REMATCH[1]}"
   fi
 
-  if [[ $annotation =~ @max_ms=([0-9.]+) ]]; then
+  if [[ $annotation =~ $max_ms_pattern ]]; then
     max_ms="${BASH_REMATCH[1]}"
-  elif [[ $annotation =~ @max_ms=([0-9.]+) ]]; then
+  elif [[ $annotation =~ $max_ms_pattern ]]; then
     max_ms="${BASH_REMATCH[1]}"
   fi
 

src/clock.sh

@@ -37,8 +37,9 @@ function clock::_choose_impl() {
   attempts+=("date")
   if ! check_os::is_macos && ! check_os::is_alpine; then
     local result
+    local number_pattern='^[0-9]+$'
     result=$(date +%s%N 2>/dev/null)
-    if [[ "$result" != *N && "$result" =~ ^[0-9]+$ ]]; then
+    if [[ "$result" != *N && "$result" =~ $number_pattern ]]; then
       _CLOCK_NOW_IMPL="date"
       return 0
     fi

src/helpers.sh

@@ -160,7 +160,8 @@ function helper::find_files_recursive() {
   local pattern="${2:-*[tT]est.sh}"
 
   local alt_pattern=""
-  if [[ $pattern == *test.sh ]] || [[ $pattern =~ \[tT\]est\.sh$ ]]; then
+  local test_pattern='\[tT\]est\.sh$'
+  if [[ $pattern == *test.sh ]] || [[ $pattern =~ $test_pattern ]]; then
     alt_pattern="${pattern%.sh}.bash"
   fi
 
@@ -187,7 +188,8 @@ function helper::normalize_variable_name() {
 
   normalized_string="${input_string//[^a-zA-Z0-9_]/_}"
 
-  if [[ ! $normalized_string =~ ^[a-zA-Z_] ]]; then
+  local valid_start_pattern='^[a-zA-Z_]'
+  if [[ ! $normalized_string =~ $valid_start_pattern ]]; then
     normalized_string="_$normalized_string"
   fi