test(unit): add unit tests for untested source files

CHANGELOG.md

@@ -24,6 +24,9 @@
 - Add duration assertions: `assert_duration`, `assert_duration_less_than`, `assert_duration_greater_than`
 - Add `--tag` and `--exclude-tag` CLI flags for filtering tests by `# @tag` annotations
 
+### Tests
+- Add unit tests for `env.sh`, `math.sh`, `colors.sh`, `test_title.sh`, `console_header.sh`, and `doc.sh`
+
 ### Changed
 - Optimize Claude Code config for agentic efficiency: trim rules/skills, add shellcheck hook, path-scoped rule loading
 - Split Windows CI test jobs into parallel chunks to avoid timeouts

tests/unit/colors_test.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+
+# shellcheck disable=SC2155
+
+function test_sgr_with_no_arguments_returns_reset() {
+  local result
+  result=$(bashunit::sgr)
+
+  assert_equals $'\e[0m' "$result"
+}
+
+function test_sgr_with_single_code() {
+  local result
+  result=$(bashunit::sgr 31)
+
+  assert_equals $'\e[31m' "$result"
+}
+
+function test_sgr_with_multiple_codes() {
+  local result
+  result=$(bashunit::sgr 1 31)
+
+  assert_equals $'\e[1;31m' "$result"
+}
+
+function test_sgr_with_three_codes() {
+  local result
+  result=$(bashunit::sgr 1 4 32)
+
+  assert_equals $'\e[1;4;32m' "$result"
+}
+
+function test_sgr_bold_code() {
+  local result
+  result=$(bashunit::sgr 1)
+
+  assert_equals $'\e[1m' "$result"
+}

tests/unit/console_header_test.sh

@@ -0,0 +1,119 @@
+#!/usr/bin/env bash
+
+# shellcheck disable=SC2155
+
+function test_print_help_contains_usage() {
+  local output
+  output=$(bashunit::console_header::print_help)
+
+  assert_contains "Usage:" "$output"
+  assert_contains "bashunit" "$output"
+}
+
+function test_print_help_contains_commands() {
+  local output
+  output=$(bashunit::console_header::print_help)
+
+  assert_contains "Commands:" "$output"
+  assert_contains "test" "$output"
+  assert_contains "bench" "$output"
+  assert_contains "assert" "$output"
+  assert_contains "doc" "$output"
+  assert_contains "init" "$output"
+  assert_contains "learn" "$output"
+  assert_contains "watch" "$output"
+  assert_contains "upgrade" "$output"
+}
+
+function test_print_help_contains_examples() {
+  local output
+  output=$(bashunit::console_header::print_help)
+
+  assert_contains "Examples:" "$output"
+}
+
+function test_print_test_help_contains_options() {
+  local output
+  output=$(bashunit::console_header::print_test_help)
+
+  assert_contains "Options:" "$output"
+  assert_contains "--filter" "$output"
+  assert_contains "--parallel" "$output"
+  assert_contains "--verbose" "$output"
+  assert_contains "Coverage:" "$output"
+}
+
+function test_print_bench_help_contains_usage() {
+  local output
+  output=$(bashunit::console_header::print_bench_help)
+
+  assert_contains "Usage: bashunit bench" "$output"
+  assert_contains "Examples:" "$output"
+}
+
+function test_print_doc_help_contains_usage() {
+  local output
+  output=$(bashunit::console_header::print_doc_help)
+
+  assert_contains "Usage: bashunit doc" "$output"
+  assert_contains "filter" "$output"
+}
+
+function test_print_init_help_contains_usage() {
+  local output
+  output=$(bashunit::console_header::print_init_help)
+
+  assert_contains "Usage: bashunit init" "$output"
+  assert_contains "bootstrap.sh" "$output"
+}
+
+function test_print_learn_help_contains_lessons() {
+  local output
+  output=$(bashunit::console_header::print_learn_help)
+
+  assert_contains "Usage: bashunit learn" "$output"
+  assert_contains "tutorial" "$output"
+}
+
+function test_print_upgrade_help_contains_usage() {
+  local output
+  output=$(bashunit::console_header::print_upgrade_help)
+
+  assert_contains "Usage: bashunit upgrade" "$output"
+}
+
+function test_print_assert_help_contains_examples() {
+  local output
+  output=$(bashunit::console_header::print_assert_help)
+
+  assert_contains "Usage: bashunit assert" "$output"
+  assert_contains "equals" "$output"
+}
+
+function test_print_watch_help_contains_requirements() {
+  local output
+  output=$(bashunit::console_header::print_watch_help)
+
+  assert_contains "Usage: bashunit watch" "$output"
+  assert_contains "fswatch" "$output"
+  assert_contains "inotifywait" "$output"
+}
+
+function test_print_version_with_env_returns_empty_when_header_disabled() {
+  local original="$BASHUNIT_SHOW_HEADER"
+  export BASHUNIT_SHOW_HEADER="false"
+
+  local output
+  output=$(bashunit::console_header::print_version_with_env "")
+
+  assert_empty "$output"
+
+  export BASHUNIT_SHOW_HEADER="$original"
+}
+
+function test_print_version_shows_version_string() {
+  local output
+  output=$(bashunit::console_header::print_version "" "dummy_file.sh")
+
+  assert_contains "$BASHUNIT_VERSION" "$output"
+}

tests/unit/doc_test.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+
+# shellcheck disable=SC2155
+
+function test_print_asserts_outputs_assertion_names() {
+  bashunit::mock bashunit::doc::get_embedded_docs \
+    cat ./tests/unit/fixtures/doc_sample.md
+
+  local output
+  output=$(bashunit::doc::print_asserts)
+
+  assert_contains "assert_equals" "$output"
+  assert_contains "assert_contains" "$output"
+}
+
+function test_print_asserts_with_filter_matches() {
+  bashunit::mock bashunit::doc::get_embedded_docs \
+    cat ./tests/unit/fixtures/doc_sample.md
+
+  local output
+  output=$(bashunit::doc::print_asserts "contains")
+
+  assert_contains "assert_contains" "$output"
+  assert_not_contains "assert_equals" "$output"
+}
+
+function test_print_asserts_with_no_matching_filter() {
+  bashunit::mock bashunit::doc::get_embedded_docs \
+    cat ./tests/unit/fixtures/doc_sample.md
+
+  local output
+  output=$(bashunit::doc::print_asserts "nonexistent")
+
+  assert_empty "$output"
+}
+
+function test_print_asserts_strips_markdown_links() {
+  bashunit::mock bashunit::doc::get_embedded_docs \
+    cat ./tests/unit/fixtures/doc_sample.md
+
+  local output
+  output=$(bashunit::doc::print_asserts "contains")
+
+  assert_not_contains "[" "$output"
+  assert_not_contains "]" "$output"
+}
+
+function test_get_embedded_docs_returns_content() {
+  local output
+  output=$(bashunit::doc::get_embedded_docs)
+
+  assert_not_empty "$output"
+}

tests/unit/env_test.sh

@@ -0,0 +1,161 @@
+#!/usr/bin/env bash
+
+# shellcheck disable=SC2155
+
+# @data_provider provide_boolean_flags_true
+function test_env_flag_returns_success_when_true() {
+  local var_name="$1"
+  local fn_name="$2"
+
+  local original_value="${!var_name}"
+  eval "export $var_name=true"
+
+  "$fn_name"
+  assert_successful_code "$?"
+
+  eval "export $var_name='$original_value'"
+}
+
+function provide_boolean_flags_true() {
+  bashunit::data_set "BASHUNIT_PARALLEL_RUN" "bashunit::env::is_parallel_run_enabled"
+  bashunit::data_set "BASHUNIT_SHOW_HEADER" "bashunit::env::is_show_header_enabled"
+  bashunit::data_set "BASHUNIT_HEADER_ASCII_ART" "bashunit::env::is_header_ascii_art_enabled"
+  bashunit::data_set "BASHUNIT_SIMPLE_OUTPUT" "bashunit::env::is_simple_output_enabled"
+  bashunit::data_set "BASHUNIT_STOP_ON_FAILURE" "bashunit::env::is_stop_on_failure_enabled"
+  bashunit::data_set "BASHUNIT_SHOW_EXECUTION_TIME" "bashunit::env::is_show_execution_time_enabled"
+  bashunit::data_set "BASHUNIT_INTERNAL_LOG" "bashunit::env::is_internal_log_enabled"
+  bashunit::data_set "BASHUNIT_VERBOSE" "bashunit::env::is_verbose_enabled"
+  bashunit::data_set "BASHUNIT_BENCH_MODE" "bashunit::env::is_bench_mode_enabled"
+  bashunit::data_set "BASHUNIT_NO_OUTPUT" "bashunit::env::is_no_output_enabled"
+  bashunit::data_set "BASHUNIT_SHOW_SKIPPED" "bashunit::env::is_show_skipped_enabled"
+  bashunit::data_set "BASHUNIT_SHOW_INCOMPLETE" "bashunit::env::is_show_incomplete_enabled"
+  bashunit::data_set "BASHUNIT_STRICT_MODE" "bashunit::env::is_strict_mode_enabled"
+  bashunit::data_set "BASHUNIT_STOP_ON_ASSERTION_FAILURE" "bashunit::env::is_stop_on_assertion_failure_enabled"
+  bashunit::data_set "BASHUNIT_SKIP_ENV_FILE" "bashunit::env::is_skip_env_file_enabled"
+  bashunit::data_set "BASHUNIT_LOGIN_SHELL" "bashunit::env::is_login_shell_enabled"
+  bashunit::data_set "BASHUNIT_FAILURES_ONLY" "bashunit::env::is_failures_only_enabled"
+  bashunit::data_set "BASHUNIT_SHOW_OUTPUT_ON_FAILURE" "bashunit::env::is_show_output_on_failure_enabled"
+  bashunit::data_set "BASHUNIT_NO_PROGRESS" "bashunit::env::is_no_progress_enabled"
+  bashunit::data_set "BASHUNIT_NO_COLOR" "bashunit::env::is_no_color_enabled"
+  bashunit::data_set "BASHUNIT_COVERAGE" "bashunit::env::is_coverage_enabled"
+}
+
+# @data_provider provide_boolean_flags_false
+function test_env_flag_returns_failure_when_false() {
+  local var_name="$1"
+  local fn_name="$2"
+
+  local original_value="${!var_name}"
+  eval "export $var_name=false"
+
+  if "$fn_name"; then
+    eval "export $var_name='$original_value'"
+    fail "Expected $fn_name to return failure when $var_name=false"
+    return
+  fi
+
+  eval "export $var_name='$original_value'"
+}
+
+function provide_boolean_flags_false() {
+  bashunit::data_set "BASHUNIT_PARALLEL_RUN" "bashunit::env::is_parallel_run_enabled"
+  bashunit::data_set "BASHUNIT_SHOW_HEADER" "bashunit::env::is_show_header_enabled"
+  bashunit::data_set "BASHUNIT_SIMPLE_OUTPUT" "bashunit::env::is_simple_output_enabled"
+  bashunit::data_set "BASHUNIT_STOP_ON_FAILURE" "bashunit::env::is_stop_on_failure_enabled"
+  bashunit::data_set "BASHUNIT_VERBOSE" "bashunit::env::is_verbose_enabled"
+  bashunit::data_set "BASHUNIT_NO_OUTPUT" "bashunit::env::is_no_output_enabled"
+  bashunit::data_set "BASHUNIT_STRICT_MODE" "bashunit::env::is_strict_mode_enabled"
+  bashunit::data_set "BASHUNIT_NO_COLOR" "bashunit::env::is_no_color_enabled"
+  bashunit::data_set "BASHUNIT_COVERAGE" "bashunit::env::is_coverage_enabled"
+}
+
+function test_is_dev_mode_enabled_when_dev_log_set() {
+  local original="$BASHUNIT_DEV_LOG"
+  export BASHUNIT_DEV_LOG="/tmp/dev.log"
+
+  bashunit::env::is_dev_mode_enabled
+  assert_successful_code "$?"
+
+  export BASHUNIT_DEV_LOG="$original"
+}
+
+function test_is_dev_mode_disabled_when_dev_log_empty() {
+  local original="$BASHUNIT_DEV_LOG"
+  export BASHUNIT_DEV_LOG=""
+
+  if bashunit::env::is_dev_mode_enabled; then
+    export BASHUNIT_DEV_LOG="$original"
+    fail "Expected is_dev_mode_enabled to return failure when BASHUNIT_DEV_LOG is empty"
+    return
+  fi
+
+  export BASHUNIT_DEV_LOG="$original"
+}
+
+function test_is_tap_output_enabled_when_format_is_tap() {
+  local original="$BASHUNIT_OUTPUT_FORMAT"
+  export BASHUNIT_OUTPUT_FORMAT="tap"
+
+  bashunit::env::is_tap_output_enabled
+  assert_successful_code "$?"
+
+  export BASHUNIT_OUTPUT_FORMAT="$original"
+}
+
+function test_is_tap_output_disabled_when_format_is_not_tap() {
+  local original="$BASHUNIT_OUTPUT_FORMAT"
+  export BASHUNIT_OUTPUT_FORMAT=""
+
+  if bashunit::env::is_tap_output_enabled; then
+    export BASHUNIT_OUTPUT_FORMAT="$original"
+    fail "Expected is_tap_output_enabled to return failure when format is empty"
+    return
+  fi
+
+  export BASHUNIT_OUTPUT_FORMAT="$original"
+}
+
+function test_active_internet_connection_returns_failure_when_no_network() {
+  local original="${BASHUNIT_NO_NETWORK:-}"
+  export BASHUNIT_NO_NETWORK="true"
+
+  if bashunit::env::active_internet_connection; then
+    export BASHUNIT_NO_NETWORK="$original"
+    fail "Expected active_internet_connection to fail when BASHUNIT_NO_NETWORK=true"
+    return
+  fi
+
+  export BASHUNIT_NO_NETWORK="$original"
+}
+
+function test_find_terminal_width_returns_a_number() {
+  local result
+  result=$(bashunit::env::find_terminal_width)
+
+  assert_matches "^[0-9]+$" "$result"
+}
+
+function test_find_terminal_width_fallback_returns_100() {
+  bashunit::mock tput true
+  bashunit::mock stty true
+
+  local result
+  result=$(bashunit::env::find_terminal_width)
+
+  assert_equals "100" "$result"
+}
+
+function test_print_verbose_outputs_env_var_names() {
+  local original="$BASHUNIT_VERBOSE"
+  export BASHUNIT_VERBOSE="true"
+
+  local output
+  output=$(bashunit::env::print_verbose)
+
+  assert_contains "BASHUNIT_DEFAULT_PATH" "$output"
+  assert_contains "BASHUNIT_PARALLEL_RUN" "$output"
+  assert_contains "BASHUNIT_VERBOSE" "$output"
+  assert_contains "BASHUNIT_COVERAGE" "$output"
+
+  export BASHUNIT_VERBOSE="$original"
+}