This is a client for OpenShift written in java. It pretty much offers all features that are currently available in the rhc-* command line tools (create/rename a domain, create/destroy applications, list all existing applications, available cartridges, embed cartridges etc.). This is the client that is used in JBoss Tools for OpenShift.

An exemplary usage of the client may look like the following:

	IOpenShiftConnection connection = 
			new OpenShiftConnectionFactory().getConnection("myApplicationId", "user", "password");
	IUser user = connection.getUser();
	IDomain domain = user.createDomain("myDomain");
	IApplication as7Application = domain.createApplication("myApplication", LatestVersionOf.jbossAs().get(user));
	IEmbeddedCartridge mySqlCartridge = as7Application.addEmbeddableCartridge(LatestVersionOf.mySQL().get(user));
	String unstructuredCredentials = mySqlCartridge.getCreationLog();
	String mySqlConnectionUrl = mySqlCartridge.getUrl();

There are also 2 blog posts on jboss.org which discuss the API in more details:

• show-domain-info: openshift-java-client in a nutshell
• enable-openshift-ci: full example using openshift-java-client

Most insightful are the integration tests within the library which pretty much use the API in all details:

• ApplicationResourceIntegrationTest
• DomainResourceIntegrationTest
• EmbeddedCartridgeResourceIntegrationTest
• etc.

You may either build from source using maven (mvn clean package) or get the prebuilt artifact from the maven central.