Merge pull request #446 from TypedDevs/feat/no-output-option

Add --no-output option

Author: Chemaclass

CHANGELOG.md

@@ -2,12 +2,12 @@
 
 ## Unreleased
 
-- Add `--init [dir]` option to get you started quickly
-    - Init with custom directory updates `.env` with `BASHUNIT_BOOTSTRAP`
 - Fix process time always shows as 0 ms
 - Fixed terminal width detection first tput and fall back stty
 - Refactor clock optimizing the implementation used to get the time
-- Update and optimize `--help` message
+- Add `--init [dir]` option to get you started quickly
+- Optimize `--help` message
+- Add `--no-output` option
 
 ## [0.21.0](https://github.com/TypedDevs/bashunit/compare/0.20.0...0.21.0) - 2025-06-18
 

bashunit

@@ -91,6 +91,9 @@ while [[ $# -gt 0 ]]; do
       export BASHUNIT_REPORT_HTML="$2"
       shift
       ;;
+    --no-output)
+      export BASHUNIT_NO_OUTPUT=true
+      ;;
     -vvv|--verbose)
       export BASHUNIT_VERBOSE=true
       ;;
@@ -137,6 +140,10 @@ fi
 # shellcheck disable=SC1090
 [[ -f "${BASHUNIT_BOOTSTRAP:-}" ]] && source "$BASHUNIT_BOOTSTRAP"
 
+if [[ "${BASHUNIT_NO_OUTPUT:-false}" == true ]]; then
+  exec >/dev/null 2>&1
+fi
+
 set +eu
 
 #################

docs/command-line.md

@@ -340,6 +340,18 @@ Duration: 48 ms
 ```
 :::
 
+## No output
+
+> `bashunit --no-output`
+
+Run tests without printing any output. Exit code will be `0` if all tests pass or `1` otherwise.
+
+::: code-group
+```bash [Example]
+./bashunit tests --no-output
+```
+:::
+
 ## Version
 
 > `bashunit --version`
@@ -426,6 +438,8 @@ Options:
                             Run tests in parallel (default). Random execution order.
   -r, --report-html <file>
                             Write test results as an HTML report.
+  --no-output
+                            Suppress all console output; rely on exit code.
   -s, --simple | --detailed
                             Choose console output style (default: detailed).
   -S, --stop-on-failure

docs/configuration.md

@@ -247,6 +247,20 @@ BASHUNIT_VERBOSE=true
 ```
 :::
 
+## No output
+
+> `BASHUNIT_NO_OUTPUT=true|false`
+
+Suppress all console output. Defaults to `false`.
+
+Similar as using `--no-output` option on the [command line](/command-line#no-output).
+
+::: code-group
+```bash [Example]
+BASHUNIT_NO_OUTPUT=true
+```
+:::
+
 <script setup>
 import pkg from '../package.json'
 </script>

src/env.sh

@@ -28,6 +28,7 @@ _DEFAULT_STOP_ON_FAILURE="false"
 _DEFAULT_SHOW_EXECUTION_TIME="true"
 _DEFAULT_VERBOSE="false"
 _DEFAULT_BENCH_MODE="false"
+_DEFAULT_NO_OUTPUT="false"
 
 : "${BASHUNIT_PARALLEL_RUN:=${PARALLEL_RUN:=$_DEFAULT_PARALLEL_RUN}}"
 : "${BASHUNIT_SHOW_HEADER:=${SHOW_HEADER:=$_DEFAULT_SHOW_HEADER}}"
@@ -37,6 +38,7 @@ _DEFAULT_BENCH_MODE="false"
 : "${BASHUNIT_SHOW_EXECUTION_TIME:=${SHOW_EXECUTION_TIME:=$_DEFAULT_SHOW_EXECUTION_TIME}}"
 : "${BASHUNIT_VERBOSE:=${VERBOSE:=$_DEFAULT_VERBOSE}}"
 : "${BASHUNIT_BENCH_MODE:=${BENCH_MODE:=$_DEFAULT_BENCH_MODE}}"
+: "${BASHUNIT_NO_OUTPUT:=${NO_OUTPUT:=$_DEFAULT_NO_OUTPUT}}"
 
 function env::is_parallel_run_enabled() {
   [[ "$BASHUNIT_PARALLEL_RUN" == "true" ]]
@@ -74,6 +76,10 @@ function env::is_bench_mode_enabled() {
   [[ "$BASHUNIT_BENCH_MODE" == "true" ]]
 }
 
+function env::is_no_output_enabled() {
+  [[ "$BASHUNIT_NO_OUTPUT" == "true" ]]
+}
+
 function env::active_internet_connection() {
   if ping -c 1 -W 3 google.com &> /dev/null; then
     return 0

tests/acceptance/bashunit_no_output_test.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+function set_up_before_script() {
+  TEST_ENV_FILE="tests/acceptance/fixtures/.env.default"
+}
+
+function test_bashunit_no_output_success() {
+  local test_file=./tests/acceptance/fixtures/test_bashunit_when_a_test_passes.sh
+  local output
+  output=$(./bashunit --no-parallel --env "$TEST_ENV_FILE" "$test_file" --no-output)
+  assert_successful_code "$output"
+  assert_empty "$output"
+}
+
+function test_bashunit_no_output_failure() {
+  local test_file=./tests/acceptance/fixtures/test_bashunit_when_a_test_fail.sh
+  local output
+  output=$(./bashunit --no-parallel --env "$TEST_ENV_FILE" "$test_file" --no-output)
+  assert_general_error "$output"
+  assert_empty "$output"
+}