🍅 tomato - behavioral testing toolkit

---

Warning

v2 is currently under active development. This version contains breaking changes and may not be stable.

Looking for the stable version? v1 is available here, but will not receive future updates as development focuses on v2.

Use v2 at your own risk - APIs and features may change without notice.

---

Tomato is a language-agnostic behavioral testing framework that manages your test infrastructure automatically.

Features

• Built-in Container Orchestration - Automatically manage test containers with Testcontainers
• Clean State Testing - Reset resources between scenarios for reliable, isolated tests
• BDD/Gherkin Support - Write tests in plain English using Cucumber syntax
• Multiple Resource Types - HTTP, PostgreSQL, Redis, Kafka, WebSocket, Shell
• Auto-generated Documentation - Keep step docs in sync with code
• Application Runner - Start your app connected to test containers

Installation

Quick Install (recommended)

curl -fsSL https://raw.githubusercontent.com/tomatool/tomato/main/install.sh | sh

Homebrew

brew install tomatool/tap/tomato

GitHub Actions

- uses: tomatool/tomato@v2

See GitHub Action documentation for all options.

Go Install

go install github.com/tomatool/tomato@latest

From Source

git clone https://github.com/tomatool/tomato.git
cd tomato
go build -o tomato .
sudo mv tomato /usr/local/bin/

Quick Start

tomato init    # Initialize a new project
tomato run     # Run behavioral tests
tomato steps   # List available steps

Documentation

For complete documentation, visit tomatool.github.io/tomato

• Getting Started
• Configuration Reference
• Architecture
• Step Reference

License

Tomato is open source under the MIT License.