BATS Assertion Libraries comparison

README.md

"Who would dare assert that we know all there is to be known?" ~ Galileo Galilei

Introduction

At the time of this writing there are 3 separate libraries that offer assertions for the Bash Automated Testing System (otherwise known as BATS).

These are:

• jasonkarns/bats-assert
• thingsym/bats-assertion
• ztombol/bats-assert

This page shows a comparison of the functions each projects offers.

Legend

Symbol	Meaning
JBA	jasonkarns/bats-assert
TBA	thingsym/bats-assertion
ZBA	ztombol/bats-assert
foo	Affirmatory function
foo	Negatory function
👍	Function present
☝️	Other function can be used
✌️	Alias present

Assert comparison Table

Function Name	Also Known As	JBA	TBA	ZBA
fail	flunk	✌️		☝️ 1
assert		👍		👍
refute		👍		👍
assert_contains	assert_output_contains	👍		☝️ 2
refute_contains	refute_output_contains	👍		☝️ 2
assert_equal		👍	👍	👍
refute_equal	assert_fail_equal		✌️
assert_line		👍		👍
refute_line		👍		👍
assert_lines_equal			👍
refute_lines_equal	assert_fail_lines_equal		✌️
assert_lines_match			👍
refute_lines_match	assert_fail_lines_match		✌️
assert_match			👍
refute_match	assert_fail_match		✌️
assert_output		👍		👍
refute_output				👍
assert_success		👍	👍	👍
refute_success	assert_failure	✌️	✌️	✌️
assert_starts_with		👍		☝️ 3
refute_starts_with				☝️ 3
assert_status			👍	☝️ 4
TOTAL (Per project)		12	11	15

• ¹ ZBA supports fail through its dependency on bats-support
• ² ZBA supports assert_contains by using assert_output --partial or assert_output --regex options
• ³ ZBA supports assert_starts_with by using assert_contains with a /^.../ regex. (same with refute_starts_with)
• ⁴ ZBA supports asserting an explicit status "N" using assert_failure N

Summary

22 Function present across all projects

Cool! Added. I've also added fail for ZBA (through bats-support).