bashunitA simple testing library for bash scripts

Write and run tests for your Bash scripts on Bash 3.0 and newer.

Flexible

Assertions, mocks, spies, data providers and snapshots to check your scripts' output and behavior.

Run in parallel or shard the suite across runners, run only what changed, measure coverage, and publish JUnit, TAP, JSON, HTML or Markdown reports.

Ask questions, report bugs, suggest features and contribute on GitHub.

Run the same tests on Linux, macOS and Windows via WSL.

Install bashunit and create folders for your script and test:

bash

curl -s https://bashunit.com/install.sh | bash
mkdir -p src tests

Save these two files:

src/greet.shtests/greet_test.sh

bash

#!/usr/bin/env bash

function greet() {
  printf 'Hello, %s!\n' "${1:-world}"
}

bash

#!/usr/bin/env bash

function set_up() {
  source src/greet.sh
}

function test_greet_by_name() {
  assert_same "Hello, Bash!" "$(greet Bash)"
}

Run your test:

bash

./lib/bashunit tests/

A passing run reports:

text

✓ Passed: Greet by name

Tests:      1 passed, 1 total
Assertions: 1 passed, 1 total

Continue with the Quickstart for other install methods and running options.