Pax Drone is an extensible integration testing framework for OSGi.
It supports a large amount of osgi framework configurations out of the box to provide painless integration testing experience.

If any of the following is true

• You want have a simple to setup integration testframework for OSGi
• You want to run your tests on a remote OSGi framework
• You want to safely run your tests on a local OSGi framework
• You want millions of supported OSGi framework configurations (ok, at least some..)
• You want to execute and debug a chunk of code inside your osgi based application
• Want to use urls like mvn:org.ops4j.pax.logging/pax-logging-api to setup your test environment
• You don't know why you need integration testing for OSGi but want to spend some minutes checking it out..

.. Pax Drone is for you!

• Issue Management
• Tutorials
• Terminology
• Change Log
• FAQ
  
  

System Requirements

1. Java 5 virtual machine running on a supported operating system.

Installation

1. Use the following dependencies to get started: (or look at the sample sub project)

<dependency>
  <groupId>org.ops4j.pax.drone</groupId>
  <artifactId>pax-drone-spi</artifactId>
  <version>0.1.2</version>
</dependency>
<dependency>
  <groupId>org.ops4j.pax.drone</groupId>
  <artifactId>pax-drone-spi-junit</artifactId>
  <version>0.1.2</version>
</dependency>
<dependency>
  <groupId>org.ops4j.pax.drone</groupId>
  <artifactId>pax-drone-connector-paxrunner</artifactId>
  <version>0.1.2</version>
</dependency>

2. Write your first drone test:

public class SimpleTest extends org.ops4j.pax.drone.spi.junit.DroneTestCase {
  public ConnectorConfiguration configure() {
    return ConnectorConfigurationFactory.create(this)
       .setPlatform(Platforms.FELIX)
       .addBundle("mvn:org.ops4j.pax.logging/pax-logging-service")
       .addBundle("mvn:org.ops4j.pax.logging/pax-logging-api");
  }

  public void testBundles() {
    // an droneContext instance is injected at runtime.
    assertNotNull(droneContext.getBundleContext());
  }
}