feat(cli): add TAP output format via --output tap

Adds TAP version 13 compliant output with --output tap flag.
Includes test plan, ok/not ok lines, YAML diagnostics for
failures, and proper SKIP/TODO directives.

Author: Chemaclass

src/console_header.sh

@@ -114,6 +114,7 @@ Options:
   -r, --report-html <file>    Write HTML report
   -s, --simple                Simple output (dots)
   --detailed                  Detailed output (default)
+  --output <format>           Output format: tap (TAP version 13)
   -R, --run-all               Run all assertions (don't stop on first failure)
   -S, --stop-on-failure       Stop on first failure
   -vvv, --verbose             Show execution details

src/console_results.sh

@@ -12,6 +12,14 @@ function bashunit::console_results::render_result() {
     return 1
   fi
 
+  if bashunit::env::is_tap_output_enabled; then
+    printf "1..%d\n" "$_BASHUNIT_TOTAL_TESTS_COUNT"
+    if [[ $_BASHUNIT_TESTS_FAILED -gt 0 ]]; then
+      return 1
+    fi
+    return 0
+  fi
+
   if bashunit::env::is_simple_output_enabled; then
     printf "\n\n"
   fi
@@ -176,6 +184,10 @@ function bashunit::console_results::print_hook_completed() {
     return
   fi
 
+  if bashunit::env::is_tap_output_enabled; then
+    return
+  fi
+
   if bashunit::parallel::is_enabled; then
     return
   fi

src/env.sh

@@ -64,6 +64,7 @@ _BASHUNIT_DEFAULT_FAILURES_ONLY="false"
 _BASHUNIT_DEFAULT_NO_COLOR="false"
 _BASHUNIT_DEFAULT_SHOW_OUTPUT_ON_FAILURE="true"
 _BASHUNIT_DEFAULT_NO_PROGRESS="false"
+_BASHUNIT_DEFAULT_OUTPUT_FORMAT=""
 
 : "${BASHUNIT_PARALLEL_RUN:=${PARALLEL_RUN:=$_BASHUNIT_DEFAULT_PARALLEL_RUN}}"
 : "${BASHUNIT_PARALLEL_JOBS:=0}"
@@ -85,6 +86,7 @@ _BASHUNIT_DEFAULT_NO_PROGRESS="false"
 : "${BASHUNIT_FAILURES_ONLY:=${FAILURES_ONLY:=$_BASHUNIT_DEFAULT_FAILURES_ONLY}}"
 : "${BASHUNIT_SHOW_OUTPUT_ON_FAILURE:=${SHOW_OUTPUT_ON_FAILURE:=$_BASHUNIT_DEFAULT_SHOW_OUTPUT_ON_FAILURE}}"
 : "${BASHUNIT_NO_PROGRESS:=${NO_PROGRESS:=$_BASHUNIT_DEFAULT_NO_PROGRESS}}"
+: "${BASHUNIT_OUTPUT_FORMAT:=${OUTPUT_FORMAT:=$_BASHUNIT_DEFAULT_OUTPUT_FORMAT}}"
 # Support NO_COLOR standard (https://no-color.org)
 if [[ -n "${NO_COLOR:-}" ]]; then
   BASHUNIT_NO_COLOR="true"
@@ -180,6 +182,10 @@ function bashunit::env::is_coverage_enabled() {
   [[ "$BASHUNIT_COVERAGE" == "true" ]]
 }
 
+function bashunit::env::is_tap_output_enabled() {
+  [[ "$BASHUNIT_OUTPUT_FORMAT" == "tap" ]]
+}
+
 function bashunit::env::active_internet_connection() {
   if [[ "${BASHUNIT_NO_NETWORK:-}" == "true" ]]; then
     return 1

src/main.sh

@@ -48,6 +48,10 @@ function bashunit::main::cmd_test() {
     --detailed)
       export BASHUNIT_SIMPLE_OUTPUT=false
       ;;
+    --output)
+      export BASHUNIT_OUTPUT_FORMAT="$2"
+      shift
+      ;;
     --debug)
       local output_file="${2:-}"
       if [[ -n "$output_file" && "${output_file:0:1}" != "-" ]]; then
@@ -605,7 +609,11 @@ function bashunit::main::exec_tests() {
     bashunit::parallel::init
   fi
 
-  bashunit::console_header::print_version_with_env "$filter" "${test_files[@]}"
+  if bashunit::env::is_tap_output_enabled; then
+    printf "TAP version 13\n"
+  else
+    bashunit::console_header::print_version_with_env "$filter" "${test_files[@]}"
+  fi
 
   if bashunit::env::is_verbose_enabled; then
     if bashunit::env::is_simple_output_enabled; then
@@ -631,9 +639,11 @@ function bashunit::main::exec_tests() {
     printf "\r%sStop on failure enabled...%s\n" "${_BASHUNIT_COLOR_SKIPPED}" "${_BASHUNIT_COLOR_DEFAULT}"
   fi
 
-  bashunit::console_results::print_failing_tests_and_reset
-  bashunit::console_results::print_incomplete_tests_and_reset
-  bashunit::console_results::print_skipped_tests_and_reset
+  if ! bashunit::env::is_tap_output_enabled; then
+    bashunit::console_results::print_failing_tests_and_reset
+    bashunit::console_results::print_incomplete_tests_and_reset
+    bashunit::console_results::print_skipped_tests_and_reset
+  fi
   bashunit::console_results::render_result
   exit_code=$?
 

src/runner.sh

@@ -525,7 +525,9 @@ function bashunit::runner::render_running_file_header() {
     return
   fi
 
-  if ! bashunit::env::is_simple_output_enabled; then
+  if bashunit::env::is_tap_output_enabled; then
+    printf "# %s\n" "$script"
+  elif ! bashunit::env::is_simple_output_enabled; then
     if bashunit::env::is_verbose_enabled; then
       printf "\n${_BASHUNIT_COLOR_BOLD}%s${_BASHUNIT_COLOR_DEFAULT}\n" "Running $script"
     else

src/state.sh

@@ -272,6 +272,11 @@ function bashunit::state::print_line() {
     return
   fi
 
+  if bashunit::env::is_tap_output_enabled; then
+    bashunit::state::print_tap_line "$type" "$line"
+    return
+  fi
+
   if ! bashunit::env::is_simple_output_enabled; then
     printf "%s\n" "$line"
     return
@@ -300,3 +305,61 @@ function bashunit::state::print_line() {
     fi
   fi
 }
+
+function bashunit::state::print_tap_line() {
+  local type=$1
+  local line=$2
+
+  local clean_line
+  clean_line=$(printf "%s" "$line" | sed 's/\x1B\[[0-9;]*[mK]//g')
+  local test_name="${clean_line#*: }"
+  test_name="${test_name%%$'\n'*}"
+  # Strip trailing whitespace and duration
+  test_name=$(printf "%s" "$test_name" | \
+    sed 's/[[:space:]]*[0-9][0-9]*m\{0,1\}[[:space:]]*[0-9.]*[ms]*[[:space:]]*$//')
+
+  case "$type" in
+  successful)
+    printf "ok %d - %s\n" "$_BASHUNIT_TOTAL_TESTS_COUNT" "$test_name"
+    ;;
+  failure | failed | failed_snapshot | error)
+    printf "not ok %d - %s\n" "$_BASHUNIT_TOTAL_TESTS_COUNT" "$test_name"
+    local detail_line
+    printf "  ---\n"
+    while IFS= read -r detail_line; do
+      detail_line=$(printf "%s" "$detail_line" | sed 's/\x1B\[[0-9;]*[mK]//g')
+      if [[ -n "$detail_line" \
+        && "$detail_line" != *"Failed:"* \
+        && "$detail_line" != *"Error:"* ]]; then
+        local trimmed="${detail_line#"${detail_line%%[![:space:]]*}"}"
+        printf "  %s\n" "$trimmed"
+      fi
+    done <<< "$clean_line"
+    printf "  ...\n"
+    ;;
+  skipped)
+    local skip_name="${test_name%%   *}"
+    local skip_reason="${test_name#"$skip_name"}"
+    skip_reason="${skip_reason#"${skip_reason%%[![:space:]]*}"}"
+    if [[ -n "$skip_reason" ]]; then
+      printf "ok %d - %s # SKIP %s\n" \
+        "$_BASHUNIT_TOTAL_TESTS_COUNT" "$skip_name" "$skip_reason"
+    else
+      printf "ok %d - %s # SKIP\n" \
+        "$_BASHUNIT_TOTAL_TESTS_COUNT" "$test_name"
+    fi
+    ;;
+  incomplete)
+    printf "ok %d - %s # TODO incomplete\n" \
+      "$_BASHUNIT_TOTAL_TESTS_COUNT" "$test_name"
+    ;;
+  snapshot)
+    printf "ok %d - %s # snapshot\n" \
+      "$_BASHUNIT_TOTAL_TESTS_COUNT" "$test_name"
+    ;;
+  *)
+    printf "not ok %d - %s\n" \
+      "$_BASHUNIT_TOTAL_TESTS_COUNT" "$test_name"
+    ;;
+  esac
+}