feat(cli): add --report-junit as an alias of --log-junit (#711)

Author: Chemaclass

CHANGELOG.md

@@ -6,6 +6,7 @@
 - GitHub Action `args` input: when set, runs `bashunit <args>` after installing, so a workflow can install and run the suite in a single step
 - Floating major tag for the GitHub Action: the release process now force-moves `v0` to each release, so workflows can pin `TypedDevs/bashunit@v0` to track the latest release within a major (#700)
 - `bashunit init` now scaffolds a `.github/workflows/tests.yml` CI workflow using the official action (existing files are left untouched) (#702)
+- `--report-junit <file>` flag as an alias of `--log-junit`, for naming parity with `--report-html` (#705)
 
 ### Changed
 - `install.sh` now verifies the release checksum by default (set `BASHUNIT_VERIFY_CHECKSUM=false` to opt out); it soft-skips with a warning when a checksum asset is unavailable unless verification was explicitly requested (#703)

docs/command-line.md

@@ -61,7 +61,7 @@ bashunit test tests/ --parallel --simple
 | `--exclude-tag <name>`         | Skip tests with matching `@tag` (repeatable)     |
 | `--output <format>`            | Output format (`tap` for TAP version 13)         |
 | `-w, --watch`                  | Watch files and re-run tests on change           |
-| `--log-junit <file>`           | Write JUnit XML report                           |
+| `--log-junit, --report-junit <file>` | Write JUnit XML report                     |
 | `--log-gha <file>`             | Write GitHub Actions workflow-commands log       |
 | `-j, --jobs <N>`               | Run tests in parallel with max N concurrent jobs |
 | `-p, --parallel`               | Run tests in parallel                            |

src/console_header.sh

@@ -108,7 +108,7 @@ Options:
   -f, --filter <name>         Only run tests matching the name
   --tag <name>                Only run tests with matching @tag (repeatable, OR logic)
   --exclude-tag <name>        Skip tests with matching @tag (repeatable, exclude wins)
-  --log-junit <file>          Write JUnit XML report
+  --log-junit, --report-junit <file>  Write JUnit XML report
   -j, --jobs <N>              Run tests in parallel with max N concurrent jobs
   -p, --parallel              Run tests in parallel (unlimited concurrency)
   --no-parallel               Run tests sequentially

src/main.sh

@@ -92,7 +92,7 @@ function bashunit::main::cmd_test() {
       set +o allexport
       shift
       ;;
-    --log-junit)
+    --log-junit | --report-junit)
       export BASHUNIT_LOG_JUNIT="$2"
       shift
       ;;

tests/acceptance/bashunit_log_junit_test.sh

@@ -20,3 +20,15 @@ function test_bashunit_when_log_junit_env() {
   assert_file_exists log-junit.xml
   rm log-junit.xml
 }
+
+function test_bashunit_report_junit_is_alias_of_log_junit() {
+  local test_file=./tests/acceptance/fixtures/test_bashunit_when_log_junit.sh
+  local report=report-junit-alias.xml
+
+  # The fixture contains failing tests by design, so the run exits non-zero;
+  # swallow it (we only care that --report-junit produced the file).
+  ./bashunit --no-parallel --env "$TEST_ENV_FILE" --report-junit "$report" "$test_file" >/dev/null 2>&1 || true
+  assert_file_exists "$report"
+  assert_file_contains "$report" "<testsuite"
+  rm "$report"
+}