RESTest 2.4.0

RESTest 2.4.0 can be pointed at an API that is not yours: it stops when the API refuses it, waits when the API asks it to, and keeps to a rate you give it. Its modules are also on Maven Central; the command line, plans and dictionaries are the same as in 2.3.0, a run can end with one exit code more, 5, and report.json only gains members.

What is new

• A run the API refuses stops at once: when every request of the opening lap is answered 401, the run stops, says which key is missing or was refused, and ends with 5.
• Waiting when the API asks: an operation answered 429, or 503 with Retry-After, is left alone for as long as the API says.
• A rate to keep to: --set engine.mostRequestsPerMinute=300 keeps a run to five requests a second, evenly spaced.
• On Maven Central, as es.us.isa.restest:restest-*. What every 2.x version keeps is the command line, its exit codes and the names of the files a run writes (What frozen means); the modules' Java code is not part of that promise.
• Fixes: both reports are kept when a value quoted in a fault is cut inside an emoji; F920 and F921 are reported again on operations whose shape RESTest does not fully understand; every Jackson library is on a version with no known flaw.

What a run sends and checks can be tuned or switched off: see settings and switches. What RESTest does not do yet is in known limitations.

Install

With Homebrew, on macOS and Linux:

brew install isa-group/tap/restest

With Docker:

docker run --rm ghcr.io/isa-group/restest:2.4.0 version

With Java 21 or later, from one of the archives below:

tar -xzf restest-2.4.0.tgz
restest-2.4.0/bin/restest version

From the source:

git clone --branch v2.4.0 https://github.com/isa-group/RESTest.git
cd RESTest
./mvnw -q install -DskipTests
./restest version

README · Manual · Reference · All changes