README.md

A simple testing framework for bash scripts

Test your bash scripts in the fastest and simplest way.

Why bashunit

A lightweight, fast testing framework for Bash 3.0+, focused on developer experience. It ships hundreds of assertions plus spies, mocks, data providers, snapshots and more.

Quick start

Install the latest version into your project:

curl -s https://bashunit.com/install.sh | bash

Write a test in tests/example_test.sh:

#!/usr/bin/env bash

function test_bashunit_is_working() {
  assert_same "bashunit is working" "bashunit is working"
}

Run it:

./lib/bashunit tests/

Prefer learning by doing? Run ./lib/bashunit learn for an interactive tutorial.

Documentation

Full documentation, covering installation options, every feature and examples, lives at bashunit.com.

Contribute

Issues, ideas and pull requests are welcome. See the contribution guide to set up your environment.