# Shared assertion helpers for the shell test scripts. Sourced, not run.
#
# Each test_*.sh increments PASS_COUNT/FAIL_COUNT/SKIP_COUNT as it goes and
# prints one line per check, so a caller sees passed/skipped/failed as
# separate numbers rather than a single pass/fail verdict -- a skip must
# never read as a pass.

PASS_COUNT=0
FAIL_COUNT=0
SKIP_COUNT=0

pass() { PASS_COUNT=$((PASS_COUNT + 1)); echo "PASS: $1"; }
fail() { FAIL_COUNT=$((FAIL_COUNT + 1)); echo "FAIL: $1" >&2; }
skip() { SKIP_COUNT=$((SKIP_COUNT + 1)); echo "SKIP: $1"; }

assert_success() {
  # assert_success <label> <command...>
  local label=$1; shift
  if "$@" >/tmp/assert_out.$$ 2>&1; then
    pass "$label"
  else
    fail "$label (exit $?, see /tmp/assert_out.$$)"
    cat /tmp/assert_out.$$ >&2
  fi
  rm -f /tmp/assert_out.$$
}

assert_failure() {
  # assert_failure <label> <command...> -- must exit non-zero
  local label=$1; shift
  if "$@" >/tmp/assert_out.$$ 2>&1; then
    fail "$label (expected non-zero exit, got 0)"
    cat /tmp/assert_out.$$ >&2
  else
    pass "$label"
  fi
  rm -f /tmp/assert_out.$$
}

assert_file_exists() {
  local label=$1 path=$2
  if [ -s "$path" ]; then
    pass "$label"
  else
    fail "$label (missing or empty: $path)"
  fi
}

assert_contains() {
  # assert_contains <label> <haystack-file-or-string> <needle>
  local label=$1 haystack=$2 needle=$3
  if [ -f "$haystack" ]; then
    haystack=$(cat "$haystack")
  fi
  if [[ "$haystack" == *"$needle"* ]]; then
    pass "$label"
  else
    fail "$label (expected to find '$needle')"
  fi
}

report_and_exit() {
  echo
  echo "passed=$PASS_COUNT skipped=$SKIP_COUNT failed=$FAIL_COUNT"
  [ "$FAIL_COUNT" -eq 0 ]
}