Title: Hamcrest Integration

Deeper integration with the [Hamcrest matcher library](http://hamcrest.org/).

## Maven Dependency

<div class="warning">
This module has not yet been officially released.
</div>

    #!xml
    <dependency>
      <groupId>org.apache.sling</groupId>
      <artifactId>org.apache.sling.testing.hamcrest</artifactId>
    </dependency>

Note that to keep the classpath consistent this module has all its dependencies marked as `provided`. It relies on your own project to define the needed dependencies, such as `org.hamcrest:hamcrest-core` and `org.apache.sling:org.apache.sling.api` .

See latest version on the [downloads page](/downloads.cgi).

## Usage

The class `org.apache.sling.testing.hamcrest.ResourceMatchers` is the main entry point. It contains static methods that can be used to create assertions.

    #!java
    import static org.apache.sling.hamcrest.ResourceMatchers.resourceOfType;
    
    public void MyServiceTest {
    
      @Test 
      public void loadResources() {
        Map<String, Object> expectedProperties = /* define properties */;
        Resource resource = /* load resource */ null;
        
        assertThat(resource, resourceOfType("my/app"));
        assertThat(resource, hasChildren("header", "body"));
        assertThat(resource, resourceWithProps(expectedProperties));
      }

    }

The Slingshot sample application uses these matchers, see [SetupServiceTest.java](http://svn.apache.org/repos/asf/sling/trunk/samples/slingshot/src/test/java/org/apache/sling/sample/slingshot/impl/SetupServiceTest.java) for an example.