1 unstable release

Uses new Rust 2024

new 0.1.1 Mar 10, 2025
0.1.0 Dec 26, 2018

#5 in #e2e

Custom license

24KB
424 lines

Catalyst

Catalyst is a lightweight and extensible API testing tool. It allows you to define and execute HTTP API tests through a declarative configuration file.

Features

  • Test Definition: Configure API test scenarios using a configuration file.
  • Variable Management: Chain tests by extracting and storing variables (e.g., cookies, JSON data).
  • Configuration Validation: Pre-run syntax and value checks for test configurations.

Installation

Add Catalyst to your Cargo.toml:

[dependencies]
catalyst = "0.1"

Usage

Create your test file in .catalyst/tests.toml

Example test configuration

[config]
base_url = "http://localhost:8080"
default_headers = { "User-Agent" = "Catalyst", "Content-Type" = "application/json" }

[[tests]]
name = "Example Test"
method = "GET"
endpoint = "/api/example"
expected_status = 200

Running Tests

Execute the tests from the command line:

catalyst run

To list all tests or validate your configuration, use:

catalyst list --verbose
catalyst validate

Dependencies

~8–19MB
~259K SLoC