tag	86b1dae0263a3553d3de5b69f756d78b050ae244
tagger	Oliver Lietz <olli@apache.org>	Sun Aug 14 07:20:49 2016 +0000
object	a8895e82d5714c007c857b07aa60b14c1879c527

commit	a8895e82d5714c007c857b07aa60b14c1879c527	[log] [tgz]
author	Oliver Lietz <olli@apache.org>	Sun Aug 14 07:20:49 2016 +0000
committer	Oliver Lietz <olli@apache.org>	Sun Aug 14 07:20:49 2016 +0000
tree	b7325597cf2e1d105774230ef92094926ef72759
parent	f6cacb887fd3ebd093ae50ed405be72791e26f66 [diff]
parent	1cae4d5afba51e40a0fd109d7760f71c1d73c95b [diff]

tree: b7325597cf2e1d105774230ef92094926ef72759

README.md

Apache Sling Testing Pax Exam

Test support for use with Pax Exam.

Sling's Karaf Features as Options for Pax Exam (without Karaf)
TestSupport with common helper methods and Options

Provided features:

run integration tests in a Sling instance in the same module (with the build artifact under test)
use different versions in build (e.g. minimal) and tests (e.g. latest)
overriding of versions

Getting Started

Configure the build artifact (bundle) to use in integration testing in pom.xml:

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>2.18.1</version>
    <executions>
      <execution>
        <goals>
          <goal>integration-test</goal>
          <goal>verify</goal>
        </goals>
      </execution>
    </executions>
    <configuration>
      <systemProperties>
        <property>
          <name>bundle.filename</name>
          <value>${basedir}/target/${project.build.finalName}.jar</value>
        </property>
      </systemProperties>
    </configuration>
  </plugin>

Create a test class (extend TestSupport to use helper methods and Options) and provide a Configuration (Option[]) for Pax Exam:

@Configuration
public Option[] configuration() {
    return new Option[]{
        baseConfiguration(), // from TestSupport
        launchpad(),
        // build artifact
        testBundle("bundle.filename"), // from TestSupport
        // testing
        junitBundles()
    };
}

protected Option launchpad() {
    final String workingDirectory = workingDirectory(); // from TestSupport
    final int httpPort = findFreePort(); // from TestSupport
    return composite(
        slingLaunchpadOakTar(workingDirectory, httpPort), // from SlingOptions
        slingExtensionModels(), // from SlingOptions (for illustration)
        slingScriptingThymeleaf() // from SlingOptions (for illustration)
    );
}

Overriding (or adding) versions:

SlingOptions.versionResolver.setVersion(SLING_GROUP_ID, "org.apache.sling.jcr.oak.server", "1.1.0");