Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Arquillian Spock TestRunner

branch: master
readme.txt
                           Spock Arquillian Extension 

                             Test in the container!

 What is it?
 ============

 Arquillian is testing framework, developed at JBoss.org, that empowers
 developers to write integration tests for business objects that are executed
 inside of an embedded or remote container--options include a servlet
 container, a Java EE application server or a Java SE CDI environment.
 
 Spock is a testing and specification framework for Java and Groovy applications. 
 What makes it stand out from the crowd is its beautiful and highly expressive specification language. 
 Thanks to its JUnit runner, Spock is compatible with most IDEs, build tools, and continuous integration servers. 
 Spock is inspired from JUnit, jMock, RSpec, Groovy, Scala, Vulcans, and other fascinating life forms.
 
 The Spock Arquillian Extension opens up for the beauty of Spock tests running in-container using Arquillian with 
 full EJB, Resource and CDI injection.


 Example
 ========

 @Deployment
 def static JavaArchive "create deployment"() {
     return ShrinkWrap.create(JavaArchive.class)
             .addClasses(AccountService.class, Account.class, SecureAccountService.class)
             .addAsManifestResource(EmptyAsset.INSTANCE, "beans.xml");
 }
 
 @Inject 
 AccountService service
        
 def "transferring between accounts should result in account withdrawal and deposit"() {
      when:
      service.transfer(from, to, amount)
        
      then:
      from.balance == fromBalance
      to.balance == toBalance
        
      where:
      from <<         [new Account(100),  new Account(10)]
      to <<           [new Account(50),   new Account(90)]
      amount <<       [50,                10]
      fromBalance <<  [50,                0]
      toBalance <<    [100,               100]
 }

 Usage
 =====

 The Spock Arquillian Extension supports both Groovy major versions supported
 by Spock Framework. In order to select proper versions, you need to put
 following dependencies into your <dependencies> section:

 <dependency>
     <groupId>org.jboss.arquillian.spock</groupId>
     <!-- replace * with standalone or container, according to your needs -->
     <artifactId>arquillian-spock-*</artifactId>
     <version>${project.version}</version>
     <scope>test</scope>
 </dependency>

 <!-- External Projects -->
 <dependency>
     <groupId>org.spockframework</groupId>
     <artifactId>spock-core</artifactId>
     <version>${version.spock}</version>
     <scope>test</scope>
 </dependency>

 <dependency>
     <groupId>org.codehaus.groovy</groupId>
     <artifactId>groovy-all</artifactId>
     <version>${version.groovy}</version>
     <scope>test</scope>
 </dependency>

 For Groovy 2.x, use spock 0.7-groovy-2.0 or later and Groovy 2.1.4 or later
 For Groovy 1.x, use spock 0.7-groovy-1.8 or later and Groovy 1.8.9 or later

 You must annotate Specifications with following annotations:

 @ArquillianSpecification
 @RunWith(ArquillianSputnik.class)


 Contents of distribution
 ========================

 core/
	The Spock Extension.
   
 standalone/
 	Standalone Arquillian test executor.
 
 container/
 	Container extension which bundles all Spock-related dependencies required
 	while running Spock specifications using Arquillian.
 	
 examples/
	Sample tests written using Spock BDD framework.

 Licensing
 =========
 
 This distribution, as a whole, is licensed under the terms of the Apache
 License, Version 2.0 (see license.txt).
 

 More info
 ===============

 Spock:      http://spockframework.org/
 Arquillian: http://jboss.org/arquillian/
Something went wrong with that request. Please try again.