feat: add --quiet|--failures-only option

Author: Chemaclass

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 - Update docs mocks usage
 - Add support for `.bash` test files
+- Add `-q|--quiet|--failures-only` mode
 
 ## [0.22.3](https://github.com/TypedDevs/bashunit/compare/0.22.2...0.22.3) - 2025-07-27
 

bashunit

@@ -94,6 +94,9 @@ while [[ $# -gt 0 ]]; do
     --no-output)
       export BASHUNIT_NO_OUTPUT=true
       ;;
+    -q|--quiet|--failures-only)
+      export BASHUNIT_FAILURES_ONLY=true
+      ;;
     -vvv|--verbose)
       export BASHUNIT_VERBOSE=true
       ;;

docs/command-line.md

@@ -352,6 +352,18 @@ Run tests without printing any output. Exit code will be `0` if all tests pass o
 ```
 :::
 
+## Failures only
+
+> `bashunit --failures-only`
+
+Suppress all per-test output. Failures and summary are shown only after all tests finish.
+
+::: code-group
+```bash [Example]
+./bashunit tests --failures-only
+```
+:::
+
 ## Version
 
 > `bashunit --version`
@@ -442,6 +454,8 @@ Options:
                             Suppress all console output; rely on exit code.
   -s, --simple | --detailed
                             Choose console output style (default: detailed).
+  -q, --quiet | --failures-only
+                            Suppress per-test output and show failures at the end.
   -S, --stop-on-failure
                             Stop execution immediately on the first failing test.
   --upgrade

docs/configuration.md

@@ -266,6 +266,20 @@ BASHUNIT_NO_OUTPUT=true
 ```
 :::
 
+## Failures only
+
+> `BASHUNIT_FAILURES_ONLY=true|false`
+
+Suppress all per-test output. Failures and summary are shown only after all tests finish. Defaults to `false`.
+
+Similar as using `--failures-only` option on the [command line](/command-line#failures-only).
+
+::: code-group
+```bash [Example]
+BASHUNIT_FAILURES_ONLY=true
+```
+:::
+
 <script setup>
 import pkg from '../package.json'
 </script>

src/console_header.sh

@@ -100,6 +100,9 @@ Options:
   -s, --simple | --detailed
                             Choose console output style (default: detailed).
 
+  -q, --quiet | --failures-only
+                            Suppress per-test output and show failures at the end.
+
   -S, --stop-on-failure
                             Stop execution immediately on the first failing test.
 

src/env.sh

@@ -30,6 +30,7 @@ _DEFAULT_VERBOSE="false"
 _DEFAULT_BENCH_MODE="false"
 _DEFAULT_NO_OUTPUT="false"
 _DEFAULT_INTERNAL_LOG="false"
+_DEFAULT_FAILURES_ONLY="false"
 
 : "${BASHUNIT_PARALLEL_RUN:=${PARALLEL_RUN:=$_DEFAULT_PARALLEL_RUN}}"
 : "${BASHUNIT_SHOW_HEADER:=${SHOW_HEADER:=$_DEFAULT_SHOW_HEADER}}"
@@ -41,6 +42,7 @@ _DEFAULT_INTERNAL_LOG="false"
 : "${BASHUNIT_BENCH_MODE:=${BENCH_MODE:=$_DEFAULT_BENCH_MODE}}"
 : "${BASHUNIT_NO_OUTPUT:=${NO_OUTPUT:=$_DEFAULT_NO_OUTPUT}}"
 : "${BASHUNIT_INTERNAL_LOG:=${INTERNAL_LOG:=$_DEFAULT_INTERNAL_LOG}}"
+: "${BASHUNIT_FAILURES_ONLY:=${FAILURES_ONLY:=$_DEFAULT_FAILURES_ONLY}}"
 
 function env::is_parallel_run_enabled() {
   [[ "$BASHUNIT_PARALLEL_RUN" == "true" ]]
@@ -86,6 +88,10 @@ function env::is_no_output_enabled() {
   [[ "$BASHUNIT_NO_OUTPUT" == "true" ]]
 }
 
+function env::is_failures_only_enabled() {
+  [[ "$BASHUNIT_FAILURES_ONLY" == "true" ]]
+}
+
 function env::active_internet_connection() {
   if [[ "${BASHUNIT_NO_NETWORK:-}" == "true" ]]; then
     return 1
@@ -134,6 +140,7 @@ function env::print_verbose() {
     "BASHUNIT_STOP_ON_FAILURE"
     "BASHUNIT_SHOW_EXECUTION_TIME"
     "BASHUNIT_VERBOSE"
+    "BASHUNIT_FAILURES_ONLY"
   )
 
   local max_length=0

src/state.sh

@@ -193,6 +193,10 @@ function state::print_line() {
 
   state::add_test_output "[$type]$line"
 
+  if env::is_failures_only_enabled; then
+    return
+  fi
+
   if ! env::is_simple_output_enabled; then
     printf "%s\n" "$line"
     return

tests/acceptance/snapshots/bashunit_path_test_sh.test_bashunit_without_path_env_nor_argument.snapshot

@@ -43,6 +43,9 @@ Options:
   -s, --simple | --detailed
                             Choose console output style (default: detailed).
 
+  -q, --quiet | --failures-only
+                            Suppress per-test output and show failures at the end.
+
   -S, --stop-on-failure
                             Stop execution immediately on the first failing test.
 

tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_help.snapshot

@@ -42,6 +42,9 @@ Options:
   -s, --simple | --detailed
                             Choose console output style (default: detailed).
 
+  -q, --quiet | --failures-only
+                            Suppress per-test output and show failures at the end.
+
   -S, --stop-on-failure
                             Stop execution immediately on the first failing test.