evanwong / spock

The Enterprise-ready testing and specification framework.

Spock Framework

Spock is a developer testing and specification framework for Java and Groovy applications. To learn more about Spock, visit http://spockframework.org. To run a sample spec in your browser, go to http://webconsole.spockframework.org.

Latest Versions

The latest release version is 0.7 (0.7-groovy-1.8, 0.7-groovy-2.0), released on 2012-10-08. The current development version is 1.0-SNAPSHOT (1.0-groovy-1.8-SNAPSHOT, 1.0-groovy-2.0-SNAPSHOT).

Releases are available from Maven Central. Development snapshots are available from Sonatype OSS.

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-maven -- Extended Maven support. Note that this module is optional; it is not required for using Spock with Maven.
• spock-example -- Self-contained example project with Ant, Gradle, and Maven builds. See spock-example/README for more information.
• spock-spring -- Integration with the [Spring TestContext Framework] (http://static.springsource.org/spring/docs/3.2.1.RELEASE/spring-framework-reference/html/testing.html#testcontext-framework).
• spock-tapestry -- Integration with the Tapestry 5 IoC container.
• spock-guice -- Integration with Guice 2/3.
• spock-unitils -- Integration with Unitils.
• spock-report -- Interactive, business-friendly HTML reports.
• spock-grails -- The Grails plugin has become its own project hosted at https://github.spockframework.org/spock-grails.

Building Spock

The only prerequisite is that you have JDK 5 or higher installed.

After cloning the project, type ./gradlew clean build (Windows: gradlew clean build). All build dependencies, including Gradle itself, will be downloaded automatically (unless already present).

Resources

• Spock Homepage -- http://spockframework.org
• Spock Web Console -- http://webconsole.spockframework.org
• GitHub Organization -- http://github.spockframework.org
• New Reference Documentation -- http://docs.spockframework.org/
• Old Wiki Documentation -- http://wiki.spockframework.org/SpockBasics
• Javadoc -- http://javadoc.spockframework.org/latest
• Groovydoc -- http://groovydoc.spockframework.org/latest
• User Forum -- http://forum.spockframework.org
• Developer Forum -- http://dev.forum.spockframework.org
• Issue Tracker -- http://issues.spockframework.org
• Build Server -- http://builds.spockframework.org

If you have any comments or questions, please direct them to the user forum. All feedback is appreciated!

Happy spec'ing!

Peter Niederwieser
Creator, Spock Framework
[Twitter]((http://twitter.com/pniederw) | Blog