Best | Bash testing framework

Best is a lightweight Bash testing framework with a focus on simplicity.

Quick Start

# tests/unit/my-feature.test.sh

it "should compare two same values"; expect 1; to_be 1
it "should not compare two different values"; expect 1; not; to_be 2
it "should skip this test"; skip; expect 1; not; to_be 2
it "should be a todo item"; todo

$ best

./tests/unit/my-feature.test.sh
  ✓ should compare two same values
  ✓ should not compare two different values
  ↪ should skip this test
  todo should be a todo item

Passed: 2, Failed: 0, Skipped: 1, Todo: 1, Total: 4

Features

Simple, familiar API
Zero runtime dependencies
No ads, tracking, telemetry, or "AI"

Installation via Homebrew

Install

$ brew tap paulshryock/tap https://codeberg.org/paulshryock/homebrew-tap
$ brew trust --formula paulshryock/tap/best
$ brew install best

Upgrade

$ brew update
$ brew upgrade best

Uninstall

$ brew uninstall best
$ brew untrust --formula paulshryock/tap/best
$ brew untap paulshryock/tap

Strict No LLM / No AI Policy

Use of generative AI/LLMs is strictly forbidden for all contributions to Best. This includes bug reports and comments on the issue tracker.

License

GPL-3.0-or-later