Apache Sling Feature Model Launcher

Clone this repo:
  1. 983a37f [maven-release-plugin] prepare for next development iteration by David Bosschaert · 4 days ago master
  2. 7c58bbc [maven-release-plugin] prepare release org.apache.sling.feature.launcher-1.1.2 by David Bosschaert · 4 days ago org.apache.sling.feature.launcher-1.1.2
  3. b1a0678 Update Feature Model dependencies to latest by David Bosschaert · 4 days ago
  4. 9335fb4 Updated the CLI options and the support for URLs in the Feature File list by Andreas Schaefer · 4 weeks ago
  5. c6f4b5a [maven-release-plugin] prepare for next development iteration by David Bosschaert · 5 months ago

Build Status License feature

Feature Model Launcher

The Feature Model Launcher can launch an feature model application file to a running process.

The launcher can be executed as follows:

java org.apache.sling.feature.launcher.impl.Main

or via the Java Main class of the jar file:

java -jar org.apache.sling.feature.launcher-1.0.0.jar

The launcher creates a local cache, by default in a subdirectory called launcher. If you want to run the launcher with a clean start, delete this directory before invoking the launcher.

The following command line options are supported:

$ rm -rf launcher && java -jar org.apache.sling.feature.launcher-1.0.0.jar -h
usage: launcher
 -C <arg>    Set artifact clash override
 -CC <arg>   Set config class override
 -c <arg>    Set cache dir
 -D <arg>    Set framework properties
 -f <arg>    Set feature files (relative and absolute file path or URL including classloader resources)
 -fv <arg>   Set felix framework version
 -p <arg>    Set home dir
 -u <arg>    Set repository url
 -V <arg>    Set variable value
 -ec <arg>   Set Extension Configuration (format: extensionName:key1=val1,key2=val2)
 -fv <arg>   Set Felix Framework version
 -fa <arg>   Set Framework Artifact (overrides felix framework version)
 -v          Verbose

Note: if feature files are provided as a Classloader Resource like in an executable JAR file or classpath resource then it's Resource URL can be handed over to the Launcher as feature file (-f option):

java.net.URL url = getClass().getResource("/my-feature-file.json");
String[] arguments = new String[] {
    "-f", url.toString()
};
org.apache.sling.feature.launcher.impl.Main.main(arguments);

For further documentation see: https://github.com/apache/sling-org-apache-sling-feature/blob/master/readme.md