Release 0.23.0

Monday, August 4, 2025

🔧 New features

Support for .bash test files

You can now name your test files using the .bash extension. This aligns with shell scripting conventions and improves compatibility with syntax-aware editors.

Example

tests/example_test.bash

Execution

bashunit tests/

Custom test titles with set_test_title

Set a descriptive title for your test function using the new set_test_title function. This makes your output clearer and more expressive.

Example

function test_custom_named() {
  set_test_title "User-friendly title"
  assert_equal 1 1
}

Output

✓ User-friendly title

New assert_exec utility

Use assert_exec to verify command execution success or failure, along with optional assertions on stdout and stderr.

Example

function sample() {
  echo "out"
  echo "err" >&2
  return 1
}

function test_success() {
  assert_exec sample --exit 1 --stdout "out" --stderr "err"
}

function test_failure() {
  assert_exec sample --exit 0 --stdout "out" --stderr "err"
}

Output

✓ Passed: Success                                                          30 ms
✗ Failed: Failure
    Expected 'exit: 0
stdout: out
stderr: err'
    but got  'exit: 1
stdout: out
stderr: err'

🐛 Bugfix

Clock fallback for second-only resolution

The internal clock logic now detects and falls back when nanosecond resolution isn’t available, preventing inaccurate benchmarks on minimal environments.

🌾 Miscellaneous

• Enforced minimum supported Bash version: 3.2
• Updated docs for mocking usage with examples and explanations
• Skipped test report tracking unless explicitly requested via option or env

---

See the full changelog on GitHub