How do I mock external commands in Bats?

You can mock commands by creating a temporary directory, adding it to the beginning of your PATH, and creating executable 'stub' files that simulate the behavior and exit codes of the real tools.

What is Bats in the context of shell scripting?

Bats (Bash Automated Testing System) is a TAP-compliant testing framework for Bash. It provides a simple way to verify that your shell scripts behave as expected by running assertions against exit codes and command output.

Is it possible to run Bats tests in a CI/CD pipeline?

Absolutely. Bats is TAP-compliant, making it compatible with most CI systems. This skill provides specific configurations for GitHub Actions and Makefiles to automate your testing process.

Can I use Bats to test scripts across different shells like dash or sh?

Yes, this skill includes patterns for testing shell compatibility by invoking your scripts with different shell interpreters (bash, sh, dash) within the Bats test environment.

Bats Shell Testing Patterns

Name: Bats Shell Testing Patterns
Author: EngineerWithAI

byEngineerWithAI

0•

Security & Testing

Implements robust automated testing for shell scripts using the Bash Automated Testing System (Bats) to ensure script reliability and maintainability.

This skill provides comprehensive guidance and standardized patterns for using Bats (Bash Automated Testing System) to perform unit and integration testing on shell scripts. It covers everything from basic exit code assertions and output verification to complex mocking of external commands and managing test fixtures. By applying these patterns, developers can implement test-driven development (TDD) for shell utilities, ensure cross-shell compatibility, and seamlessly integrate shell script validation into CI/CD pipelines, significantly reducing bugs in infrastructure and automation code.

Key Features

01Command stubbing and function mocking techniques to isolate script logic from external dependencies

02Dynamic fixture management for testing complex multi-file input and output scenarios

03Advanced assertion patterns for exit codes, string matching, and file system states

040 GitHub stars

05Robust setup and teardown logic for managing temporary test environments and resources

06Standardized integration patterns for GitHub Actions, Makefiles, and TAP-compliant reporters

Use Cases

01Developing and validating unit tests for custom CLI tools and system administration utilities

02Implementing automated quality gates for DevOps and infrastructure-as-code shell logic in CI/CD

03Refactoring legacy shell scripts with a comprehensive safety net of regression tests

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add engineerwithai/engineerwith-agents bats-testing-patterns

For use in Claude.ai and ChatGPT

Download Skill