WSO2 Contract Test Runner

What WSO2 Contract Test Runner is

WSO2 Contract Test Runner is an open-source library for checking live REST API endpoints against consumer-defined contracts. It sends requests to endpoints and compares their responses with expected responses described in JSON files. A contract can specify a request, expected response, assertions, and optional post-conditions. Supported checks include status codes, JSON body and header paths, exact values, regular expressions, empty values, structure, arrays, and objects. Suite configuration can schedule contracts before or after tests; those set to run before a suite execute synchronously before the suite tests. Post-conditions can extract response values into suite-scoped or global environment variables for other contracts. Contracts can also pause for a specified number of seconds after assertions finish. The documented workflow runs tests in Docker, using contract and configuration files placed in a mounted volume. The sample request uses bearer authorization and a cookie supplied through environment variables. The project is Apache-2.0 licensed and no paid plans are listed. XML path support is listed as a todo.