:spock-release-version: 2.4-M4 :spock-release-date: 2024-03-21 :spock-snapshot-version: 2.4

https://github.com/spockframework/spock/blob/master/LICENSE[image:https://img.shields.io/badge/License-Apache%202.0-blue.svg[License]] https://search.maven.org/search?q=g:org.spockframework[image:https://img.shields.io/maven-central/v/org.spockframework/spock-core.svg?label=Maven%20Central[Maven Central]] https://github.com/spockframework/spock/actions/workflows/release.yml[image:https://img.shields.io/github/actions/workflow/status/spockframework/spock/release.yml?branch=master[GitHub Workflow Status (branch)]] https://jitpack.io/#org.spockframework/spock[image:https://jitpack.io/v/org.spockframework/spock.svg[Jitpack]] https://codecov.io/gh/spockframework/spock[image:https://codecov.io/gh/spockframework/spock/branch/master/graph/badge.svg[Codecov]] https://gitter.im/spockframework/spock?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge[image:https://badges.gitter.im/spockframework/spock.svg[Gitter]] https://ge.spockframework.org/scans[image:https://img.shields.io/badge/Revved%20up%20by-Develocity-06A0CE?logo=Gradle&labelColor=02303A[Revved up by Develocity]]

image::docs/images/spock-main-logo.png[width=100px,float=right]

== Spock Framework

Spock is a BDD-style developer testing and specification framework for Java and https://groovy-lang.org/[Groovy] applications.To learn more about Spock, visit https://spockframework.org[https://spockframework.org].To run a sample spec in your browser use the https://groovyconsole.dev/[Groovy Web Console].

=== Latest Versions

• The latest 2.x release version is {spock-release-version} ({spock-release-version}-groovy-2.5, {spock-release-version}-groovy-3.0, {spock-release-version}-groovy-4.0), released on {spock-release-date}.
• The current development version is {spock-snapshot-version}-SNAPSHOT ({spock-snapshot-version}-groovy-2.5-SNAPSHOT, {spock-snapshot-version}-groovy-3.0-SNAPSHOT, , {spock-snapshot-version}-groovy-4.0-SNAPSHOT).

NOTE: Spock 2.x is based on the JUnit 5 Platform and require Java 8+/groovy-2.5+ (Groovy 3.0 or 4.0 is recommended, especially in projects using Java 12+).

Releases are available from https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.spockframework%22[Maven Central]. Development snapshots are available from https://oss.sonatype.org/content/repositories/snapshots/org/spockframework/[Sonatype OSS].

==== Ad-Hoc Intermediate Releases

For intermediate stable builds we recommend to use https://jitpack.io/#org.spockframework/spock[Jitpack] (go here for instructions):

. Add https://jitpack.io[https://jitpack.io] as a repository . Use org.spockframework.spock as groupId and the normal artifact-id

[source,groovy,subs="attributes"]

repositories { // ... maven { url 'https://jitpack.io' } }

dependencies { testImplementation 'org.spockframework.spock:spock-core:spock-{spock-release-version}' testImplementation 'org.spockframework.spock:spock-spring:spock-{spock-release-version}' }

[start=3] . For intermediate releases you can also use the commit-hash as version, e.g. compile com.github.spockframework.spock:spock-core:d91bf785a1

=== Modules

• spock-core -- Core framework. This is the only mandatory module.
• spock-specs -- Specifications for spock-core, implemented using Spock. Not required for using Spock.
• spock-spring -- Integration with the https://docs.spring.io/spring/docs/4.1.5.RELEASE/spring-framework-reference/html/testing.html#testcontext-framework[Spring TestContext Framework].
• spock-tapestry -- Integration with the https://tapestry.apache.org/[Tapestry 5] IoC container.
• spock-guice -- Integration with https://github.com/google/guice[Guice] 2/3.
• spock-unitils -- Integration with http://www.unitils.org/[Unitils].

=== Building

==== Prerequisites

Spock needs both a JDK 8 and JDK 17+ installed.

• JDK 8 is required to compile Spock via toolchains (automatic download is disabled).
• The gradle build itself requires at least JDK 17 to run.

JDK locations must be made known to toolchains via JDK<version>=<PATH> environment variable, e.g., JDK8=/path/to/jdk8.

==== Supported versions

Spock is supported for Java version 8+.

Spock is supported for Groovy versions 2.5, 3.0, and 4.0.

The tests are testing Spock with the specific versions (variants) of Groovy and Java. Default Groovy version is 2.5.

The Groovy 3.0 and 4.0 variant should pass on all supported JDK versions, Groovy 2.5 does not work with Java 17+:

.... ./gradlew build ....

To build a specific variant of Spock, use the variant name as a parameter

.... ./gradlew build -Dvariant=4.0 ....

To test against a specific Java version, use the java version name as a parameter, the path to the Java version must be set via an environment variable JDK<version>=<PATH>. Of course, this can combined with the variant selection from above.

.... ./gradlew build -DjavaVersion=17 ....

(Windows: gradlew build). All build dependencies, including the https://www.gradle.org[build tool] itself, will be downloaded automatically (unless already present).

=== Contributing

Contributions are welcome! Please see the https://github.com/spockframework/spock/blob/master/CONTRIBUTING.adoc[contributing page] for detailed instructions.

=== Support

If you have any comments or questions, please direct them to the https://github.com/spockframework/spock/discussions[user forum]. All feedback is appreciated!

=== Java 9 Module Names

All published jars (beginning with Spock 1.2) will contain Automatic-Module-Name manifest attribute. This allows for Spock to be used in a Java 9 Module Path.

• spock-core -- org.spockframework.core
• spock-spring -- org.spockframework.spring
• spock-tapestry -- org.spockframework.tapestry
• spock-guice -- org.spockframework.guice
• spock-unitils -- org.spockframework.unitils

So module authors can use well known module names for the spock modules, e.g. something like this:

.... open module foo.bar { requires org.spockframework.core; requires org.spockframework.spring; } ....

=== Logo

The Spock Logo, created by Ayşe Altınsoy (@AltinsoyAyse), is managed in the https://github.com/spockframework/spock-logo[spock-logo repository].

=== Links

• Spock Homepage -- https://spockframework.org[https://spockframework.org]
• Groovy Web Console -- https://groovyconsole.dev/[https://groovyconsole.dev/]
• GitHub Organization -- https://github.com/spockframework[https://github.com/spockframework]
• Reference Documentation -- https://docs.spockframework.org[https://docs.spockframework.org]
• User Forum -- https://github.com/spockframework/spock/discussions[https://github.com/spockframework/spock/discussions]
• Chat -- https://gitter.im/spockframework/spock[https://gitter.im/spockframework/spock]
• Stack Overflow -- https://stackoverflow.com/questions/tagged/spock[https://stackoverflow.com/questions/tagged/spock]
• Issue Tracker -- https://github.com/spockframework/spock/issues[https://github.com/spockframework/spock/issues]
• Spock Example Project -- https://github.com/spockframework/spock-example[https://github.com/spockframework/spock-example]
• Twitter -- https://twitter.com/SpockFramework[https://twitter.com/SpockFramework]
• Mastodon -- https://fosstodon.org/@spockframework[https://fosstodon.org/@spockframework]

🖖 Live Long And Prosper!

The Spock Framework Team