iamuzorr/yaatt repository overview

⁠🧪 YAATT - Yet Another API Test Tool

YAATT is a fast, simple, JSON-native API testing tool for developers and QA engineers who hate heavy, noisy frameworks.

No GUI, no Gherkin, no Postman clutter. Just JSON → tests → results.

⁠⚡ Quick Start

Pull the image

docker pull iamuzorr/yaatt:latest

⁠Run all tests

docker run -v $(pwd)/tests:/app/tests iamuzorr/yaatt

⁠Run a single test file

docker run -v $(pwd)/tests:/app/tests iamuzorr/yaatt example_test.json

⁠Dev mode (auto-reload on file changes)

docker run -v $(pwd)/tests:/app/tests iamuzorr/yaatt dev

⁠📝 Features

✅ JSON test files - human-readable, easy to diff in PRs

✅ Schema-backed - autocomplete and linting support

✅ No GUI required - write tests in your favorite editor

✅ Simple assertions - is_equal, is_not_empty

✅ Dockerized - runs anywhere Docker runs

⁠📦 Usage Example

Test file

{
  "name": "Get Products Test",
  "requests": {
    "get_products": {
      "method": "get",
      "url": "https://dummyjson.com/products/3"
    }
  },
  "assertions": [
    {
      "type": "is_equals",
      "property": "get_products.id",
      "value": 3
    }
  ]
}

⁠🧩 Motivation

YAATT exists to strip away complexity from API testing. Postman, Cucumber, Cypress - all have great features, but for many teams, they are too heavy, verbose, or opinionated.

YAATT keeps it simple: send requests, assert expectations, get results.