Skip to content

Latest commit

 

History

History

governator-test-spock

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
src
src
 
 
README.md
README.md
 
 
build.gradle
build.gradle
 
 
dependencies.lock
dependencies.lock
 
 

README.md

Testing Governator With Spock

Features

  • Annotate your test with @ModulesForTesting to specify which Guice modules should be included when building your Injector.
  • @Inject dependencies directly into your Specification class.
  • Annotate dependencies with @ReplaceWithMock to add an override binding for that dependency's type to a Spock Mock implementation.
  • Annotate dependencies with @WrapWithSpy to wrap any binding with a Spock Spy.
  • Annotate parent classes, test classes, and/or test methods with @TestPropertyOverride to set Archaius2 property overrides for your Injector (Note: You must include ArchaiusModule yourself in @ModulesForTesting to use this feature.)

Dependency

Add the following to your build.gradle

testCompile 'com.netflix.governator:governator-test-spock:latest.release'

Note: This framework requires at least Spock 1.1 to properly function!

Example

@ModulesForTesting({ MyModule.class, ArchaiusModule.class })    //Specify any Modules you wish to include in your test
public class ExampleTest extends Specification {
    
    @Inject
    @ReplaceWithMock                                            //Indicate that you wish this dependency to be Mocked
    SomeDependency dependency  
    
    @Inject
    @WrapWithSpy                                                //Indicate that you wish to wrap this dependency with a Spy
    SomeRealDependency realDependency                      
    
    def setup() {
        dependency.getValue() >> "Test"                         //Specify desired behavior for your Mock
    }
    
    def "Test a basic Mock"() {
        expect:
        dependency.value == "Test"                              //Verify behavior of your Mock
    }
    
    def "Test Spying an object and checking what was called" {
        when:
        realDependency.getValue()
        
        then:
        1 * realDependency.getValue()                           //Verify that the getValue method was invoked once
    }
    
    @Inject
    Config config
    
    @TestPropertyOverride({"myProperty=test"})                  //Specify property values you wish to be set
    def "Test Config Overrides"() {
        expect:
        config.getString("myProperty") == "test"                //Verify that your property was set as expected
    }
    
    @TestPropertyOverride(propertyFiles={"testProps.properties"}) //Properties may also be loaded from a file
    public void testConfigFromFile() {
        expect:
        config.getString("myProperty") == "test"                //Verify that your property was set as expected
    }
}

Controlling Injector Creation

You may choose whether the Injector will be created once per test class or once per test method by setting the injectorCreation attribute of @ModulesForTesting. By default, the injector is created once per test class. This should only be modified if the state of your injector bound objects are mutable in some way and that state has been modified by one of your tests.

//Injector created once per test class
@ModulesForTesting(injectorCreation=InjectorCreationMode.BEFORE_TEST_CLASS)  
public class ExampleTest extends Specification {
...
}
//Injector created once per test method
@ModulesForTesting(injectorCreation=InjectorCreationMode.BEFORE_EACH_TEST_METHOD)  
public class ExampleTest extends Specification {
...
}