skogai-bats-testing

What problem does it solve?

The skogai Bats testing system makes it easy to write repeatable, isolated, and readable tests for Bash shell scripts so developers can catch regressions, verify behavior across environments, and avoid workspace pollution from test artifacts.

Core Features & Use Cases

• Assertion helpers for common checks like exit status, output contents, and file/directory existence.
• Test isolation utilities including setup_test_dir and teardown_test_dir to avoid leaking temporary files and state.
• Fixtures, stubbing, and mocking support for faking commands, functions, and environment variables in unit tests.
• CI and integration patterns such as GitHub Actions and Makefile targets to run bats suites in automated pipelines.
• Use Cases: unit-testing script functions without executing main, validating file operations, testing git interactions, and creating TAP output for CI.

Quick Start

Install bats, source the testing-framework test-helper, and run bats tests/*.bats to execute the skogai test suite.