Gabbi

Declarative HTTP Testing for Python

This project is maintained by cdent

Gabbi

Gabbi is a tool for running HTTP tests where requests and responses are represented in a declarative form.

It is under active development. See the YAML files for examples of working tests and the docs for more details on features and formats.

Purpose

Gabbi works to bridge the gap between human readable YAML files that represent HTTP requests and expected responses and the obscured realm of Python-based, object-oriented unit tests in the style of the unittest module and its derivatives.

Each YAML file represents an ordered list of HTTP requests along with the expected responses. This allows a single file to represent a process in the API being tested. For example:

At the same time it is still possible to ask gabbi to run just one request. If it is in a sequence of tests, those tests prior to it in the YAML file will be run (in order). In any single process any test will only be run once. Concurrency is handled such that one file runs in one process.

These features mean that it is possible to create tests that are useful for both humans (as tools for improving and developing APIs) and automated CI systems.

Install

Gabbi can be installed from PyPI using pip:

$ pip install -U gabbi