feat: pass arguments to mocked functions

Previously arguments passed to mocked functions were lost, e.g. when
mocking `docker` we had no chance to differentiate between `docker stop`
and `docker inspect`.

Pass all arguments from the caller to the mocked function now in order
to make mocking more flexible.

Author: carlfriedrich

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## Unreleased
+
+- Pass arguments to mocked functions
+
 ## [0.26.0](https://github.com/TypedDevs/bashunit/compare/0.25.0...0.26.0) - 2025-11-02
 
 - Add `assert_unsuccessful_code` assertion to check for non-zero exit codes

docs/test-doubles.md

@@ -75,6 +75,36 @@ function test_example() {
 ```
 :::
 
+All arguments passed to the original call are forwarded to the mocked function, so you can mock different behavior depending on the arguments.
+
+::: code-group
+```bash [Example]
+mockTool() {
+  if [[ "$1" == "--version" ]]; then
+    echo "1.2.3"
+    return 0
+  else
+    echo "tool: '$1' is not a valid command."
+    return 1
+  fi
+}
+
+test_example() {
+  local output
+  mock tool mockTool
+
+  output="$(tool --version)"
+  assert_successful_code
+  assert_same "1.2.3" "${output}"
+
+  output="$(tool foo)"
+  assert_general_error
+  assert_contains "is not a valid command" "${output}"
+}
+
+```
+:::
+
 ## spy
 > `spy "function"`
 

src/test_doubles.sh

@@ -27,7 +27,7 @@ function mock() {
   shift
 
   if [[ $# -gt 0 ]]; then
-    eval "function $command() { $* ; }"
+    eval "function $command() { $* \"\$@\"; }"
   else
     eval "function $command() { echo \"$($CAT)\" ; }"
   fi