Keploy logo
Groovy logo

Keploy as a Groovy testing framework

Keploy tests Groovy services by recording real HTTP and database traffic from a running process, then replaying it as assertions. There is no Spock interaction to declare and nothing to mock by hand, because capture happens below the JVM at the socket.

Generate Groovy tests free
keploy record -c "java -jar build/libs/app.jar"
18.4K+VS Code1.2M+300M+mocks created

What Keploy gives a Groovy team

Any Groovy service, unchanged

Keploy runs the assembled JAR. Grails, Spring Boot with Groovy, Ratpack and Micronaut all record identically.

  • Groovy 3 and 4
  • Grails, Spring Boot, Ratpack
  • Gradle or Maven
  • No plugin needed
The problem

Why Groovy integration tests slow teams down

The friction is rarely the assertions. It is everything around them — spinning up dependencies, keeping mocks honest, and repairing tests after every refactor.

Three ways to do it

Testing Groovy: by hand, with Spock, or with Keploy

Spock describes the exchange by hand and still needs the dependency supplied. Keploy records both halves once and replays them with nothing running.

Select any row for the full comparison, with code.

Same coverage, three costs

What you write for Groovy vs what Keploy records

All three produce the same assertion. Only the third still passes after the next refactor without anyone editing it.

By hand2–4 hours
OrderControllerSpec.groovy
hand-written
import spock.lang.Specification
 
class OrderControllerSpec extends Specification {
 
def repository = Mock(OrderRepository)
def payments = Mock(PaymentClient)
def controller = new OrderController(repository, payments)
 
def "confirms an order"() {
given:
// Interaction described here, then asserted against that description.
repository.findById("o-1") >> new Order("o-1", 4200, "NEW")
payments.authorize(_) >> new Auth("AUTHORIZED")
 
when:
def res = controller.confirm("o-1")
 
then:
res.status == "CONFIRMED"
}
}

A Spock mock returns objects, so the JDBC driver never runs.

Spock1–2 hours
OrderControllerWireMockSpec.groovy
tool-assisted
import spock.lang.Specification
import static com.github.tomakehurst.wiremock.client.WireMock.*
 
class OrderControllerWireMockSpec extends Specification {
 
@Shared wireMock = new WireMockServer(8787)
 
def setupSpec() {
wireMock.start()
// One stub mapping per outbound URL, written by hand.
stubFor(post(urlEqualTo("/v1/payment_intents/tok_123/confirm"))
.willReturn(okJson('{"status":"AUTHORIZED"}')))
}
 
// A real Postgres is still needed, migrated and seeded per run.
def "confirms an order"() {
expect:
controller.confirm("o-1").status == "CONFIRMED"
}
}

WireMock serves the upstream. The database is still a real one.

With Keploy~5 minutes
keploy/test-set-0/test-1.yaml
auto-generated
version: api.keploy.io/v1beta1
kind: Http
name: test-1
spec:
req:
method: POST
url: /orders/o-1/confirm
resp:
status_code: 200
body: '{"id":"o-1","status":"CONFIRMED","total":4200}'
assertions:
noise:
- body.confirmedAt
---
kind: Postgres
spec:
query: select id, total, status from orders where id = $1
rows:
- { id: "o-1", total: 4200, status: "NEW" }
---
kind: Http
spec:
request:
url: https://api.payments.example.com/v1/payment_intents/tok_123/confirm
response:
body: '{"status":"AUTHORIZED"}'

Recorded from one real request. Nothing here was typed by hand.

Times are estimates for authoring one endpoint’s coverage from scratch, not measurements.

Keploy vs the alternatives

Groovy testing tools, compared

The options a team on the JVM actually reaches for, and where each one genuinely wins. Select a row for the full comparison.

Best in classStrongPartialNot covered

Assessments reflect each tool’s documented behaviour, not benchmark measurements.

How it works

Record your Groovy app once, replay it forever

Keploy sits below your Groovy process at the network layer. It watches the calls your app already makes, then serves them back on replay so tests run with no dependencies attached.

Keploy records a GET call to /api/v1/orders/{id} on a Groovy service and captures the dependency calls it makes.

An example shape of a captured call. Your own endpoints and dependencies come from your real traffic, so nothing here has to be written by hand.
Mock coverage

What Keploy mocks for Groovy, with zero config

6 of the 6 dependencies a typical Groovy service talks to are stubbed from the recording itself — no mock classes, no fixture files, no containers in CI.

Quick start

Your first Groovy test suite in under five minutes

Every command below runs against your existing Groovy service. Nothing in your source tree changes.

  1. 1Install the Keploy CLI

    A single binary. It needs a Linux kernel with eBPF support, or Docker on macOS and Windows — and it adds nothing to your project's dependencies.

    curl -sSL https://keploy.io/install.sh | bash
  2. 2Record your service

    Pass the command you already use to start the app. Keploy runs it and watches every socket it opens.

    keploy record -c "java -jar build/libs/app.jar"
  3. 3Exercise the paths you care about

    Use curl, your frontend, or an existing smoke script. Every request becomes a test case with its Groovy calls captured alongside it.

    curl -X POST localhost:8080/orders/o-1/confirm
    curl localhost:8080/orders/o-1
  4. 4Replay in CI

    Replay serves the recorded dependency responses, so the job needs no service containers and no Docker daemon.

    keploy test -c "java -jar build/libs/app.jar" --delay 20

Ready to try it on your own Groovy service?

Ecosystem

Works with the rest of your Groovy stack

Keploy records at the network layer, so framework and driver choices inside your Groovy app do not change how it captures traffic.

FAQ

Groovy testing with Keploy: common questions

Join our GlobalCommunity

Connect with developers worldwide. Follow updates, ask questions, share feedback, and ship faster with other Keploy builders.

1.2M+Installs
18.4K+GitHub
100K+Devs
300M+Mocks
1K+Contributors
#1OSS Trending
4.9★★★★★from 500+ reviews onG2GartnerVS CodeChrome
★★★★★

Best report of integration and API tests I've seen — which we don't get from RestAssured.

G2
★★★★★

Future of microservices testing. I don't write tests now!

G2 · 5/5
★★★★★

An amazing product that simplifies the automation.

Gartner · 4.0
XGitHubSlackYouTubeLinkedIn
Built by developers, for developers.Let's build the future, together.