Merge branch 'main' into feat/468-bash-support-3.0

 Conflicts:
	CHANGELOG.md
	src/runner.sh
	src/test_doubles.sh

Author: Chemaclass

CHANGELOG.md

@@ -2,17 +2,25 @@
 
 ## Unreleased
 
-- Add Project-wide `copilot-instructions.md`
-- Add `AGENTS.md` for external developer tools integration
-- Add two-way synchronization policy between `AGENTS.md` and `copilot-instructions.md` with automatic validation in task templates and PR checklist
-- Add tasks storage policy clarifying `.tasks/` (versioned) vs `.task/` (private scratch, git-ignored)
+- Add `assert_unsuccessful_code` assertion to check for non-zero exit codes
+- Fix bench tests missing test_file var
+- Fix compatibility with older python versions for clock::now
+- Support Bash 3.0 (Previously 3.2)
+
+## [0.25.0](https://github.com/TypedDevs/bashunit/compare/0.23.0...0.24.0) - 2025-10-05
+
+- Add AI developer tools integration and guidelines
+    - Add Project-wide `copilot-instructions.md`
+    - Add `AGENTS.md` for external developer tools integration
+    - Add tasks storage policy clarifying `.tasks/` (versioned) vs `.task/` (git-ignored)
 - Include `set_test_title` helper in the single-file library
 - Fix lifecycle hooks capture-and-report flow errors
-    - set_up
-    - tear_down
-    - set_up_before_script
-    - tear_down_after_script
-- Support Bash 3.0 (Previously 3.2)
+    - `set_up`, `tear_down`, `set_up_before_script`, `tear_down_after_script`
+- Fix false negative from `assert_have_been_called_with` with pipes
+- Fix preservation of trailing whitespace in final argument to `data_set`
+- Fix unbound variable error in `parse_data_provider_args` with `set -u`
+- Fix wrong assertion_failed name of test on failure
+- Fix test name interpolation on failure
 
 ## [0.24.0](https://github.com/TypedDevs/bashunit/compare/0.23.0...0.24.0) - 2025-09-14
 

bashunit

@@ -28,7 +28,7 @@ function _check_bash_version() {
 _check_bash_version
 
 # shellcheck disable=SC2034
-declare -r BASHUNIT_VERSION="0.24.0"
+declare -r BASHUNIT_VERSION="0.25.0"
 
 # shellcheck disable=SC2155
 declare -r BASHUNIT_ROOT_DIR="$(dirname "${BASH_SOURCE[0]}")"

docs/assertions.md

@@ -333,7 +333,7 @@ Reports an error if the exit code of `callable` is not equal to `expected`.
 
 If `callable` is not provided, it takes the last executed command or function instead.
 
-[assert_successful_code](#assert-successful-code), [assert_general_error](#assert-general-error) and [assert_command_not_found](#assert-command-not-found)
+[assert_successful_code](#assert-successful-code), [assert_unsuccessful_code](#assert-unsuccessful-code), [assert_general_error](#assert-general-error) and [assert_command_not_found](#assert-command-not-found)
 are more semantic versions of this assertion, for which you don't need to specify an exit code.
 
 ::: code-group
@@ -453,6 +453,45 @@ function test_failure() {
 ```
 :::
 
+## assert_unsuccessful_code
+> `assert_unsuccessful_code ["callable"]`
+
+Reports an error if the exit code of `callable` is not unsuccessful (non-zero).
+
+If `callable` is not provided, it takes the last executed command or function instead.
+
+[assert_exit_code](#assert-exit-code) is the full version of this assertion where you can specify the expected exit code.
+
+::: code-group
+```bash [Example]
+function test_success_with_callable() {
+  function foo() {
+    return 1
+  }
+
+  assert_unsuccessful_code "$(foo)"
+}
+
+function test_success_without_callable() {
+  function foo() {
+    return 2
+  }
+
+  foo # function took instead `callable`
+
+  assert_unsuccessful_code
+}
+
+function test_failure() {
+  function foo() {
+    return 0
+  }
+
+  assert_unsuccessful_code "$(foo)"
+}
+```
+:::
+
 ## assert_general_error
 > `assert_general_error ["callable"]`
 

install.sh

@@ -96,7 +96,7 @@ BASHUNIT_GIT_REPO="https://github.com/TypedDevs/bashunit"
 if is_git_installed; then
     LATEST_BASHUNIT_VERSION="$(get_latest_tag "$BASHUNIT_GIT_REPO")"
 else
-    LATEST_BASHUNIT_VERSION="0.24.0"
+    LATEST_BASHUNIT_VERSION="0.25.0"
 fi
 TAG="$LATEST_BASHUNIT_VERSION"
 

package.json

@@ -1,7 +1,7 @@
 {
   "name": "bashunit-docs",
-  "version": "0.24.0",
-  "checksum": "db65b663556ea1290879f09c653f9ff0e32372e41a4cdc1eb339a294a4095a02",
+  "version": "0.25.0",
+  "checksum": "baebbebf93a515f516598b14d5c42d02f4c5bc9933a4c1f59eca36122e109f2d",
   "description": "Docs for bashunit a simple testing library for bash scripts",
   "main": "index.js",
   "repository": "git@github.com:TypedDevs/bashunit.git",

src/assert.sh

@@ -380,6 +380,20 @@ function assert_successful_code() {
   state::add_assertions_passed
 }
 
+function assert_unsuccessful_code() {
+  local actual_exit_code=${3-"$?"}
+
+  if [[ "$actual_exit_code" -eq 0 ]]; then
+    local label
+    label="$(helper::normalize_test_function_name "${FUNCNAME[1]}")"
+    state::add_assertions_failed
+    console_results::print_failed_test "${label}" "${actual_exit_code}" "to be non-zero" "but was 0"
+    return
+  fi
+
+  state::add_assertions_passed
+}
+
 function assert_general_error() {
   local actual_exit_code=${3-"$?"}
   local expected_exit_code=1

src/bashunit.sh

@@ -10,7 +10,7 @@ function bashunit::assertion_failed() {
   local failure_condition_message=${3:-"but got "}
 
   local label
-  label="$(helper::normalize_test_function_name "${FUNCNAME[1]}")"
+  label="$(helper::normalize_test_function_name "${FUNCNAME[2]}")"
   state::add_assertions_failed
   console_results::print_failed_test "${label}" "${expected}" \
     "$failure_condition_message" "${actual}"

src/clock.sh

@@ -78,7 +78,7 @@ function clock::now() {
     python)
       python - <<'EOF'
 import time, sys
-sys.stdout.write(str(int(time.time() * 1_000_000_000)))
+sys.stdout.write(str(int(time.time() * 1000000000)))
 EOF
       ;;
     node)

src/globals.sh

@@ -128,5 +128,5 @@ function data_set() {
       printf ' %q' "$arg"
     fi
   done
-  printf '\n'
+  printf ' %q\n' ""
 }

src/helpers.sh

@@ -18,6 +18,15 @@ function helper::normalize_test_function_name() {
     return
   fi
 
+  if [[ -z "${interpolated_fn_name-}" && "${original_fn_name}" == *"::"* ]]; then
+    local state_interpolated_fn_name
+    state_interpolated_fn_name="$(state::get_current_test_interpolated_function_name)"
+
+    if [[ -n "$state_interpolated_fn_name" ]]; then
+      interpolated_fn_name="$state_interpolated_fn_name"
+    fi
+  fi
+
   if [[ -n "${interpolated_fn_name-}" ]]; then
     original_fn_name="$interpolated_fn_name"
   fi