Tavern

Spec sheet

What it does

Tavern is a pytest plugin, command-line tool, and Python library for automated API testing with YAML-based syntax.Read 9 Oct 2026 · tavern.readthedocs.io

Purpose

Tavern is a pytest plugin, command-line tool, and Python library for automated API testing using YAML syntax.Read 9 Oct 2026 · tavern.readthedocs.io

Audience

The project describes Tavern as a focused tool for developers to automate API tests.Read 9 Oct 2026 · tavern.readthedocs.io

Integrations

The documented default backends use requests for HTTP, paho-mqtt for MQTT, grpcio for gRPC, and gql for GraphQL.Read 9 Oct 2026 · tavern.readthedocs.io

Founded

2017Read 28 Sep 2026 · tavern.readthedocs.io

Assertions

Response checks can validate status codes, JSON bodies, headers, and redirect query parameters.Read 9 Oct 2026 · tavern.readthedocs.io

Backends

The documented default backends use requests for HTTP, paho-mqtt for MQTT, grpcio for gRPC, and gql for GraphQL.Read 9 Oct 2026 · tavern.readthedocs.io

CI use

The project documentation says Tavern can be integrated into test frameworks or continuous integration setups through its Python library or the tavern-ci command-line tool.Read 9 Oct 2026 · tavern.readthedocs.io

Community plugin

The plugins page lists tavern-grpc-web as a community-maintained backend for unary gRPC-Web calls over HTTP.Read 9 Oct 2026 · tavern.readthedocs.io

Development

The changelog lists version 3.6.0, dated 2026-05-31, as the latest release shown.Read 9 Oct 2026 · tavern.readthedocs.io

Extensibility

Tavern has a plugin system for changing how requests are made, and its documentation names plugins for Flask and FastAPI/Starlette test clients.Read 9 Oct 2026 · tavern.readthedocs.io

GraphQL

The plugin documentation lists GraphQL as a built-in request backend.Read 9 Oct 2026 · tavern.readthedocs.io

How to run

The documentation recommends using Tavern with pytest; it can also be run through the tavern-ci command-line interface or integrated using its Python library.Read 9 Oct 2026 · tavern.readthedocs.io

Limitations

Tavern does not have a GUI, API monitoring, or mock servers, according to its comparison with Postman and Insomnia.Read 9 Oct 2026 · tavern.readthedocs.io

Maintenance

The documentation names @michaelboulton as the current maintainer.Read 9 Oct 2026 · tavern.readthedocs.io

Notable limits

Tavern has no GUI and does not provide API monitoring or mock servers.Read 9 Oct 2026 · tavern.readthedocs.io

Project history

The project says Tavern was started in 2017.Read 9 Oct 2026 · tavern.readthedocs.io

Protocols

Tavern supports testing RESTful APIs, MQTT-based APIs, and gRPC services.Read 9 Oct 2026 · tavern.readthedocs.io

Pytest

The documentation recommends using Tavern with pytest, which can discover and run Tavern YAML test files.Read 9 Oct 2026 · tavern.readthedocs.io

Response checks

Response checks can include status codes, JSON, headers, and redirect query parameters.Read 9 Oct 2026 · tavern.readthedocs.io

Reusable data

Tests can save values from responses and reuse them in later requests, and can load variables from configuration files.Read 9 Oct 2026 · tavern.readthedocs.io

Reusable test data

Tests can use variables from configuration files or earlier stages, and can read environment variables for values such as passwords or bearer tokens.Read 9 Oct 2026 · tavern.readthedocs.io

Secrets

The documentation shows environment variables being used for credentials such as passwords or bearer tokens that should not be shipped with test code.Read 9 Oct 2026 · tavern.readthedocs.io

Security-related capability

The documentation shows using environment variables to keep passwords or bearer tokens out of test code shipped with the tests.Read 9 Oct 2026 · tavern.readthedocs.io

Supported APIs

Tavern supports testing RESTful APIs, MQTT-based APIs, and gRPC services.Read 9 Oct 2026 · tavern.readthedocs.io

Test format

Tests are defined in YAML as named tests containing one or more stages with requests and expected responses.Read 9 Oct 2026 · tavern.readthedocs.io

Test structure

Tests use YAML documents containing a test name and one or more stages with requests and expected responses.Read 9 Oct 2026 · tavern.readthedocs.io

Who it is for

The documentation describes Tavern as a focused tool for developers automating API tests.Read 9 Oct 2026 · tavern.readthedocs.io

Plans and prices

Every Tavern plan and price →

Where Specifiction places it

• API Testing Tools#21 of 347.9