chore: warning when enabling progress-bar when running in parallel

Author: Chemaclass

docs/command-line.md

@@ -346,6 +346,10 @@ Duration: 48 ms
 
 Enable the progress bar during test execution. By default, the progress bar is disabled.
 
+::: warning
+The progress bar cannot be used when running tests in parallel. If `--progress-bar` is combined with `--parallel`, a warning is printed and the bar is disabled.
+:::
+
 ::: code-group
 ```bash [Example]
 ./bashunit --progress-bar

docs/configuration.md

@@ -253,6 +253,10 @@ BASHUNIT_VERBOSE=true
 
 Controls whether the progress bar is rendered. `false` by default.
 
+::: warning
+The progress bar is disabled when tests run in parallel. Enabling `BASHUNIT_PROGRESS_BAR` while `BASHUNIT_PARALLEL_RUN` is `true` will print a warning and no bar will be shown.
+:::
+
 ::: code-group
 ```bash [Example]
 BASHUNIT_PROGRESS_BAR=true

src/progress.sh

@@ -9,6 +9,10 @@ function progress::init() {
   # Track the last rendered progress state so the bar can be redrawn
   export PROGRESS_CURRENT=0
 
+  if env::is_progress_bar_enabled && parallel::is_enabled; then
+    printf "%sWarning: Progress bar is not supported in parallel mode.%s\n" "${_COLOR_INCOMPLETE}" "${_COLOR_DEFAULT}"
+  fi
+
   if progress::enabled ; then
     progress::render 0 "$PROGRESS_TOTAL"
   fi