chore: simplify coverage usage flags

Author: Chemaclass

docs/coverage.md

@@ -11,7 +11,7 @@ Enable coverage tracking with the `--coverage` flag:
 bashunit tests/ --coverage
 ```
 ```bash [With custom paths]
-bashunit tests/ --coverage --coverage-paths src/
+bashunit tests/ --coverage-paths src/
 ```
 ```bash [Output]
 bashunit - 0.30.0 | Tests: 5
@@ -61,6 +61,10 @@ The DEBUG trap adds overhead to test execution. For large test suites, consider
 | `--coverage-min <percent>` | Minimum coverage threshold (fails if below) |
 | `--no-coverage-report` | Disable LCOV file generation (console only) |
 
+::: tip Auto-enable
+Coverage is automatically enabled when using `--coverage-report`, `--coverage-report-html`, or `--coverage-min`. You don't need to specify `--coverage` explicitly with these options.
+:::
+
 ### Environment Variables
 
 You can also configure coverage via environment variables in your `.env` file:
@@ -133,7 +137,7 @@ Fail the test run if coverage drops below a threshold:
 
 ::: code-group
 ```bash [Command]
-bashunit tests/ --coverage --coverage-min 80
+bashunit tests/ --coverage-min 80
 ```
 ```[Output - Passing]
 Coverage Report
@@ -169,7 +173,7 @@ Generate a detailed HTML report showing line-by-line coverage:
 
 ::: code-group
 ```bash [Command]
-bashunit tests/ --coverage --coverage-report-html coverage/html
+bashunit tests/ --coverage-report-html coverage/html
 ```
 ```bash [.env]
 BASHUNIT_COVERAGE_REPORT_HTML=coverage/html
@@ -194,7 +198,7 @@ Generate coverage for CI tools like Codecov or Coveralls:
 ::: code-group
 ```yaml [GitHub Actions]
 - name: Run tests with coverage
-  run: bashunit tests/ --coverage --coverage-min 80
+  run: bashunit tests/ --coverage-min 80
 
 - name: Upload coverage to Codecov
   uses: codecov/codecov-action@v4

src/main.sh

@@ -8,6 +8,7 @@ function bashunit::main::cmd_test() {
   local raw_args=()
   local args=()
   local assert_fn=""
+  local _bashunit_coverage_opt_set=false
 
   # Parse test-specific options
   while [[ $# -gt 0 ]]; do
@@ -115,11 +116,13 @@ function bashunit::main::cmd_test() {
       --coverage-report)
         # shellcheck disable=SC2034
         BASHUNIT_COVERAGE_REPORT="$2"
+        _bashunit_coverage_opt_set=true
         shift
         ;;
       --coverage-min)
         # shellcheck disable=SC2034
         BASHUNIT_COVERAGE_MIN="$2"
+        _bashunit_coverage_opt_set=true
         shift
         ;;
       --no-coverage-report)
@@ -129,6 +132,7 @@ function bashunit::main::cmd_test() {
       --coverage-report-html)
         # shellcheck disable=SC2034
         BASHUNIT_COVERAGE_REPORT_HTML="$2"
+        _bashunit_coverage_opt_set=true
         shift
         ;;
       *)
@@ -138,6 +142,12 @@ function bashunit::main::cmd_test() {
     shift
   done
 
+  # Auto-enable coverage when any coverage output option is specified
+  if [[ "$_bashunit_coverage_opt_set" == true ]]; then
+    # shellcheck disable=SC2034
+    BASHUNIT_COVERAGE=true
+  fi
+
   # Expand positional arguments and extract inline filters
   # Skip filter parsing for assert mode - args are not file paths
   local inline_filter=""