Skip to content

Zoidberg

Zoidberg is a CLI tool to test Woosmap APIs. It can:

  • Run smoke tests on the CI
  • Run scenarios on a dedicated environment
  • Replay captured traffic on a dedicated environment

It can also run any of these against two environments at once and diff the results — see IsoFunctional Testing.

How it works

flowchart LR
    Config[artillery.yml / nibbler capture] --> Zoidberg
    Zoidberg -->|GET / POST| API[Woosmap API]
    API --> Zoidberg
    Zoidberg --> Report[Assertions / Stats / Iso diff]

Quick Start

Run it straight from the source:

go run ./cmd/zoidberg --help

Run the smoke tests of a product (a directory containing an artillery.yml):

zoidberg smokeTests -d ./zoidberg_tests

Replay nibbler-captured traffic against an environment:

zoidberg replay -d ./path/to/nibbler/data

Next Steps