Bats 1.8.0

Released: 2022-09-15

Added:

• using external formatters via --formatter <absolute path> (also works for
  --report-formatter) (Allow specifiyng external formatter via absolute path #602)
• running only tests that failed in the last run via --filter-status failed (Add --filter-status failed for running only failed tests from the last completed run #483)
• variable BATS_TEST_RETRIES that specifies how often a test should be
  reattempted before it is considered failed (Add BATS_TEST_RETRIES #618)
• Docker tags latest-no-faccessat2 and <bats-version\>-no-faccessat2 for
  avoiding bash: bats: No such file or directory on docker<20.10 (or
  runc<v1.0.0-rc93) (Fix docker: bats not found #622)
• BATS_TEST_TIMEOUT variable to force a timeout on test (including setup()) (Add timeout support #491)
• also print (nonempty) $stderr (from run --separate-stderr) with
  --print-output-on-failure (Also print $stderr (from run --separate-stderr) for --print-output-on-failure #631)
• # bats test_tags=<tag list>/# bats file_tags=<tag list> and
  --filter-tags <tag list> for tagging tests for execution filters (Tagging tests #642)
• warning BW03: inform about setup_file in wrong file (.bats instead of setup_suite.bash) (Fix lacking documentation of setup_suite #652)

Documentation

• update gotcha about negated statements: Recommend using run ! on Bats
  versions >=1.5.0 (docs/gotchas: Update recommendation for negative statements #593)
• add documentation for bats_require_minimum_version (Document bats_require_minimum_version #595)
• improve documentation about setup_file (Fix lacking documentation of setup_suite #652)

Fixed:

• added missing shebang (warnings.bash: Add shebang #597)
• remaining instances of run -<N> being incorrectly documented as run =<N> (Fix additional leftover instances of run =<N> #599)
• allow --gather-test-outputs-in <directory> to work with existing, empty
  directories (Allow empty directories for --gather-test-outputs-in #603)
  • also add --clean-and-gather-test-outputs-in <directory> for improved UX
• double slashes in paths derived from TMPDIR on MacOS (Fix // in some paths and add regression test #607)
• fix load in teardown marking failed tests as not run (Fix load in teardown after failure exits test #612)
• fix unset variable errors (with set -u) and add regression test (Global nounset test #621)
• teardown_file errors don't swallow setup_file errors anymore, the behavior
  is more like teardown's now (only return/last command can trigger teardown
  errors) (Don't let teardown_file errors eat setup_file errors #623)
• upgraded from deprecated CI envs for MacOS (10 -> 11,12) and Ubuntu
  (18.04 -> 22.04) (Update github runner images #630)
• add /usr/lib/bats as default value for BATS_LIB_PATH (Add default path for 'BATS_LIB_PATH' environment variable' #628)
• fix unset variable in bats-formatter-junit when setup_file fails (Fix unset variable in bats-format-junit when setup_file fails #632)
• unify error behavior of teardown/teardown_file/teardown_suite functions:
  only fail via return code, not via ERREXIT (Sync teardown_suite midway error behavior with other teardowns #633)
• fix unbound variable errors with set -u on setup_suite failures (Fix further unbound variable errors #643)
• fix load not being available in setup_suite (Fix load not being available in setup_suite #644)
• fix RPM spec, add regression test (RPM build check #648)
• fix handling of IFS by run (Fix a problem that run always fails with IFS=_ #650)
• only print setup_file's stderr on errors (Only print setup_suite's stdout/err on errors #649)

Documentation

• fix typos, spelling and links (bats.7.ronn: Fix mispelling #596, Misc. link/spelling fixes #604, Spelling #619, chore: Fix a typo in tutorial #627)
• fix redirection order of an example in the tutorial (Minor fix in Tutorial documentation #617)