Show HN: Rocketship – Open-source E2E testing for event-driven systems

4 days ago 3

E2E API Testing For Any Cloud Environment

Run Enterprise-Grade e2e Tests With a Single Command

🚀 Rocketship is an open‑source testing engine that can verify complex, API-driven scenarios that are made by your customers— or your systems. Today's world is filled with event-driven micro-services that can be hard to test. Rocketship brings durable execution backed by Temporal to your testing infra, and offers an extensible plugin system so you can add the APIs and protocols that matter to you.

Define your test scenarios as declarative YAML specs -> and have Rocketship run them locally or in your cloud environment.

Core features:

Rocketship CLI Run the engine locally or connect to a remote address.
Deploy-Ready Images Need long-running, highly-scalable tests? Or just want to save test history? Host Rocketship on your own infra.
Declarative YAML Define your test scenarios as declarative YAML specs.
Durable Execution Need a test step to retry? Or a test to run for 10 hours? No problem!
Plugin Ecosystem Add the APIs and protocols that matter to you.

brew install temporal # pre-req for if you want to run the local engine

curl -Lo /usr/local/bin/rocketship https://github.com/rocketship-ai/rocketship/releases/latest/download/rocketship-darwin-arm64 && chmod +x /usr/local/bin/rocketship # for arm64 macos

For detailed installation instructions for other platforms and optional aliases, see the Installation Guide.

cat > simple-test.yaml << 'EOF' name: "Simple Test Suite" description: "A simple test suite!" version: "v1.0.0" tests: - name: "Test 1" steps: - name: "Create a test user" plugin: "http" config: method: "POST" url: "https://tryme.rocketship.sh/users" body: | { "name": "Test User", "email": "[email protected]" } assertions: - type: "json_path" path: ".name" expected: "Test User" - name: "Test 2" steps: - name: "Create a test order" plugin: "http" config: method: "POST" url: "https://tryme.rocketship.sh/orders" body: | { "product": "Test Product", "quantity": 1 } assertions: - type: "status_code" expected: 200 EOF

rocketship run -af simple-test.yaml # starts the local engine, runs the tests, shuts the engine down

The examples use a hosted test server at tryme.rocketship.sh that you can use:

Test CRUD operations for a resource type
Resources are isolated based off your IP
FYI: Resource cleanup is done hourly (every :00)

https://docs.rocketship.sh

I have a ton of ideas for Rocketship, and I'm open to any and all suggestions. Here are just some of the things you can expect in weeks not years:

LLM Browser Testing Support A plugin powered by Workflow Use to build & run deterministic browser tests.
Smoke Testing A test suite-wide configuration to schedule tests to run on a cadence.
Environment Variables & Secrets Pass in environment variables to your tests. Reach APIs requiring authentication.
Core AWS Plugins Add support for AWS services like S3, SQS, SNS, etc. Other providers to follow.
Agentic Friendly Testing Vibe code in peace. Have your agent iteratively test your codebase for regressions.

I would love to build this with you! I'm looking to start a community for 🚀. Reach out to me on LinkedIn and let's chat. A great first contribution is building a plugin for your favorite API. If you want to contribute to Rocketship, start by reading Contributing to Rocketship.

Rocketship is distributed under the MIT license.

Read Entire Article