bundles/org.eclipse.equinox.p2.console/src/org/eclipse/equinox/internal/p2/console/ProvCommandProvider.java - equinox/rt.equinox.p2 - Git at Google

 /*******************************************************************************
  * Copyright (c) 2007, 2008 IBM Corporation and others. All rights reserved. This
  * program and the accompanying materials are made available under the terms of
  * the Eclipse Public License v1.0 which accompanies this distribution, and is
  * available at http://www.eclipse.org/legal/epl-v10.html
  *
  * Contributors: IBM Corporation - initial API and implementation
  * 	Band XI - add more commands
  ******************************************************************************/
 package org.eclipse.equinox.internal.p2.console;

 import java.io.File;
 import java.net.MalformedURLException;
 import java.net.URL;
 import java.util.*;
 import org.eclipse.core.runtime.IStatus;
 import org.eclipse.core.runtime.NullProgressMonitor;
 import org.eclipse.equinox.internal.p2.core.helpers.ServiceHelper;
 import org.eclipse.equinox.internal.provisional.p2.artifact.repository.*;
 import org.eclipse.equinox.internal.provisional.p2.core.ProvisionException;
 import org.eclipse.equinox.internal.provisional.p2.engine.IProfile;
 import org.eclipse.equinox.internal.provisional.p2.engine.IProfileRegistry;
 import org.eclipse.equinox.internal.provisional.p2.metadata.IArtifactKey;
 import org.eclipse.equinox.internal.provisional.p2.metadata.IInstallableUnit;
 import org.eclipse.equinox.internal.provisional.p2.metadata.query.IUPropertyQuery;
 import org.eclipse.equinox.internal.provisional.p2.metadata.query.InstallableUnitQuery;
 import org.eclipse.equinox.internal.provisional.p2.metadata.repository.IMetadataRepositoryManager;
 import org.eclipse.equinox.internal.provisional.p2.query.*;
 import org.eclipse.osgi.framework.console.CommandInterpreter;
 import org.eclipse.osgi.framework.console.CommandProvider;
 import org.eclipse.osgi.service.resolver.VersionRange;

 /**
  * An OSGi console command provider that adds various commands for interacting
  * with the provisioning system.
  */
 public class ProvCommandProvider implements CommandProvider {
 	private static final String WILDCARD_ANY = "*"; //$NON-NLS-1$
 	public static final String NEW_LINE = System.getProperty("line.separator", "\n"); //$NON-NLS-1$ //$NON-NLS-2$

 	//	private Profile profile;

 	public ProvCommandProvider(String profileId, IProfileRegistry registry) {
 		// look up the profile we are currently running and use it as the
 		// default.
 		// TODO define a way to spec the default profile to manage
 		//		if (profileId != null) {
 		//			profile = registry.getProfile(profileId);
 		//			if (profile != null)
 		//				return;
 		//		}
 		//		// A default was not defined so manage the first profile we can find
 		//		Profile[] profiles = registry.getProfiles();
 		//		if (profiles.length > 0)
 		//			profile = profiles[0];
 	}

 	/**
 	 * Adds a metadata repository.
 	 */
 	public void _provaddrepo(CommandInterpreter interpreter) {
 		String urlString = interpreter.nextArgument();
 		if (urlString == null) {
 			interpreter.print("Repository location must be provided");
 			interpreter.println();
 			return;
 		}
 		URL repoURL = toURL(interpreter, urlString);
 		if (repoURL == null)
 			return;
 		if (ProvisioningHelper.addMetadataRepository(repoURL) == null)
 			interpreter.println("Unable to add repository: " + repoURL);
 	}

 	public void _provdelrepo(CommandInterpreter interpreter) {
 		String urlString = interpreter.nextArgument();
 		if (urlString == null) {
 			interpreter.print("Repository location must be provided");
 			interpreter.println();
 			return;
 		}
 		URL repoURL = toURL(interpreter, urlString);
 		if (repoURL == null)
 			return;
 		ProvisioningHelper.removeMetadataRepository(repoURL);
 	}

 	public void _provaddartifactrepo(CommandInterpreter interpreter) {
 		String urlString = interpreter.nextArgument();
 		if (urlString == null) {
 			interpreter.print("Repository location must be provided");
 			interpreter.println();
 			return;
 		}
 		URL repoURL = toURL(interpreter, urlString);
 		if (repoURL == null)
 			return;
 		if (ProvisioningHelper.addArtifactRepository(repoURL) == null)
 			interpreter.println("Unable to add repository: " + repoURL);
 	}

 	public void _provdelartifactrepo(CommandInterpreter interpreter) {
 		String urlString = interpreter.nextArgument();
 		if (urlString == null) {
 			interpreter.print("Repository location must be provided");
 			interpreter.println();
 			return;
 		}
 		URL repoURL = toURL(interpreter, urlString);
 		if (repoURL == null)
 			return;
 		ProvisioningHelper.removeArtifactRepository(repoURL);
 	}

 	/**
 	 * Install a given IU to a given profile location.
 	 */
 	public void _provinstall(CommandInterpreter interpreter) {
 		String iu = interpreter.nextArgument();
 		String version = interpreter.nextArgument();
 		String profileId = interpreter.nextArgument();
 		if (profileId == null || profileId.equals("this"))
 			profileId = IProfileRegistry.SELF;
 		if (iu == null || version == null || profileId == null) {
 			interpreter.println("Installable unit id, version, and profile Id must be provided");
 			return;
 		}
 		IStatus s = null;
 		try {
 			s = ProvisioningHelper.install(iu, version, ProvisioningHelper.getProfile(profileId), new NullProgressMonitor());
 		} catch (ProvisionException e) {
 			interpreter.println("installation failed ");
 			e.printStackTrace();
 			return;
 		}
 		if (s.isOK())
 			interpreter.println("installation complete");
 		else
 			interpreter.println("installation failed " + s.getMessage());
 	}

 	/**
 	 * Creates a profile given an id, location, and flavor
 	 */
 	public void _provaddprofile(CommandInterpreter interpreter) {
 		String profileId = interpreter.nextArgument();
 		String location = interpreter.nextArgument();
 		String flavor = interpreter.nextArgument();
 		if (profileId == null || location == null || flavor == null) {
 			interpreter.println("Id, location, and flavor must be provided");
 			return;
 		}
 		String environments = interpreter.nextArgument();
 		Properties props = new Properties();
 		props.setProperty(IProfile.PROP_INSTALL_FOLDER, location);
 		props.setProperty(IProfile.PROP_FLAVOR, flavor);
 		if (environments != null)
 			props.setProperty(IProfile.PROP_ENVIRONMENTS, environments);

 		ProvisioningHelper.addProfile(profileId, props);
 	}

 	/**
 	 * Deletes a profile given an id, location, and flavor
 	 */
 	public void _provdelprofile(CommandInterpreter interpreter) {
 		String profileId = interpreter.nextArgument();
 		if (profileId == null) {
 			interpreter.println("Id must be provided");
 			return;
 		}
 		ProvisioningHelper.removeProfile(profileId);
 	}

 	/**
 	 * Lists the installable units that match the given URL, id, and/or version.
 	 *
 	 * @param interpreter
 	 */
 	public void _provliu(CommandInterpreter interpreter) {
 		String urlString = processArgument(interpreter.nextArgument());
 		String id = processArgument(interpreter.nextArgument());
 		String version = processArgument(interpreter.nextArgument());
 		URL repoURL = null;
 		if (urlString != null && !urlString.equals(WILDCARD_ANY))
 			repoURL = toURL(interpreter, urlString);
 		IInstallableUnit[] units = sort(ProvisioningHelper.getInstallableUnits(repoURL, new InstallableUnitQuery(id, new VersionRange(version)), null));
 		for (int i = 0; i < units.length; i++)
 			println(interpreter, units[i]);
 	}

 	/**
 	 * Lists the known metadata repositories, or the contents of a given
 	 * metadata repository.
 	 *
 	 * @param interpreter
 	 */
 	public void _provlr(CommandInterpreter interpreter) {
 		String urlString = processArgument(interpreter.nextArgument());
 		String id = processArgument(interpreter.nextArgument());
 		String version = processArgument(interpreter.nextArgument());
 		if (urlString == null) {
 			URL[] repositories = ProvisioningHelper.getMetadataRepositories();
 			if (repositories != null)
 				for (int i = 0; i < repositories.length; i++)
 					interpreter.println(repositories[i]);
 			return;
 		}
 		URL repoURL = toURL(interpreter, urlString);
 		if (repoURL == null)
 			return;
 		IInstallableUnit[] units = sort(ProvisioningHelper.getInstallableUnits(repoURL, new InstallableUnitQuery(id, new VersionRange(version)), null));
 		for (int i = 0; i < units.length; i++)
 			println(interpreter, units[i]);
 	}

 	/**
 	 * Lists the group IUs in all known metadata repositories, or in the given
 	 * metadata repository.
 	 *
 	 * @param interpreter
 	 */
 	public void _provlg(CommandInterpreter interpreter) {
 		String urlString = processArgument(interpreter.nextArgument());
 		IQueryable queryable = null;
 		if (urlString == null) {
 			queryable = (IQueryable) ServiceHelper.getService(Activator.getContext(), IMetadataRepositoryManager.class.getName());
 			if (queryable == null)
 				return;
 		} else {
 			URL repoURL = toURL(interpreter, urlString);
 			if (repoURL == null)
 				return;
 			queryable = ProvisioningHelper.getMetadataRepository(repoURL);
 			if (queryable == null)
 				return;
 		}
 		Query query = new IUPropertyQuery(IInstallableUnit.PROP_TYPE_GROUP, Boolean.TRUE.toString());
 		IInstallableUnit[] units = sort(queryable.query(query, new Collector(), null));
 		for (int i = 0; i < units.length; i++)
 			println(interpreter, units[i]);
 	}

 	/**
 	 * Lists the known artifact repositories, or the contents of a given
 	 * artifact repository.
 	 *
 	 * @param interpreter
 	 */
 	public void _provlar(CommandInterpreter interpreter) {
 		String urlString = processArgument(interpreter.nextArgument());
 		if (urlString == null) {
 			URL[] repositories = ProvisioningHelper.getArtifactRepositories();
 			if (repositories == null)
 				return;
 			for (int i = 0; i < repositories.length; i++)
 				interpreter.println(repositories[i]);
 			return;
 		}
 		URL repoURL = toURL(interpreter, urlString);
 		if (repoURL == null)
 			return;
 		IArtifactRepository repo = ProvisioningHelper.getArtifactRepository(repoURL);
 		IArtifactKey[] keys = null;
 		try {
 			keys = (repo != null) ? repo.getArtifactKeys() : null;
 		} catch (UnsupportedOperationException e) {
 			interpreter.println("Repository does not support list commands.");
 			return;
 		}
 		if (keys == null || keys.length == 0) {
 			interpreter.println("Repository has no artifacts");
 			return;
 		}
 		IFileArtifactRepository fileRepo = (IFileArtifactRepository) repo.getAdapter(IFileArtifactRepository.class);
 		for (int i = 0; i < keys.length; i++) {
 			IArtifactDescriptor[] descriptors = repo.getArtifactDescriptors(keys[i]);
 			for (int j = 0; j < descriptors.length; j++) {
 				IArtifactDescriptor descriptor = descriptors[j];
 				File location = null;
 				if (fileRepo != null)
 					location = fileRepo.getArtifactFile(descriptor);
 				println(interpreter, keys[i], location);
 			}

 		}
 	}

 	/**
 	 * Returns the given string as an URL, or <code>null</code> if the string
 	 * could not be interpreted as an URL.
 	 */
 	private URL toURL(CommandInterpreter interpreter, String urlString) {
 		try {
 			return new URL(urlString);
 		} catch (MalformedURLException e) {
 			interpreter.print(e.getMessage());
 			interpreter.println();
 			return null;
 		}
 	}

 	private String processArgument(String arg) {
 		if (arg == null || arg.equals(WILDCARD_ANY))
 			return null;
 		return arg;
 	}

 	/**
 	 * Lists the known profiles, or the contents of a given profile.
 	 *
 	 * @param interpreter
 	 */
 	public void _provlp(CommandInterpreter interpreter) {
 		String profileId = processArgument(interpreter.nextArgument());
 		String id = processArgument(interpreter.nextArgument());
 		String range = processArgument(interpreter.nextArgument());
 		if (profileId == null) {
 			IProfile[] profiles = ProvisioningHelper.getProfiles();
 			for (int i = 0; i < profiles.length; i++)
 				interpreter.println(profiles[i].getProfileId());
 			return;
 		}
 		// determine which profile is to be listed
 		IProfile target = null;
 		if (profileId.equals("this"))
 			profileId = IProfileRegistry.SELF;
 		target = ProvisioningHelper.getProfile(profileId);
 		if (target == null)
 			return;

 		// list the profile contents
 		IInstallableUnit[] result = sort(target.query(new InstallableUnitQuery(id, new VersionRange(range)), new Collector(), null));
 		for (int i = 0; i < result.length; i++)
 			interpreter.println(result[i]);
 	}

 	private IInstallableUnit[] sort(Collector collector) {
 		IInstallableUnit[] units = (IInstallableUnit[]) collector.toArray(IInstallableUnit.class);
 		Arrays.sort(units, new Comparator() {
 			public int compare(Object arg0, Object arg1) {
 				return arg0.toString().compareTo(arg1.toString());
 			}
 		});
 		return units;
 	}

 	public String getHelp() {
 		StringBuffer help = new StringBuffer();
 		help.append(NEW_LINE);
 		help.append("---"); //$NON-NLS-1$
 		help.append("Provisioning Commands");
 		help.append("---"); //$NON-NLS-1$
 		help.append(NEW_LINE);
 		help.append("\tprovlr [<repository URL> <iu id | *> <version range | *>]   - Lists all metadata repositories, or the contents of a given metadata repository");
 		help.append(NEW_LINE);
 		help.append("\tprovlar [<repository URL>] - Lists all artifact repositories, or the contents of a given artifact repository");
 		help.append(NEW_LINE);
 		help.append("\tprovliu [<repository URL | *> <iu id | *> <version range | *>] - Lists the IUs that match the pattern in the given repo.  * matches all");
 		help.append(NEW_LINE);
 		help.append("\tprovlp [<profile id | *> - Lists all profiles, or the contents of the profile at the given profile");
 		help.append(NEW_LINE);
 		help.append("\tprovlg [<repository URL> <iu id | *> <version range | *>] - Lists all IUs with group capabilities in the given repo or in all repos if the URL is omitted");
 		help.append(NEW_LINE);
 		help.append("\tprovinstall <InstallableUnit> <version> <profileId> - Provisions an IU to the profile with the give id");
 		help.append(NEW_LINE);
 		help.append("\tprovaddrepo <repository URL> - Adds a metadata repository");
 		help.append(NEW_LINE);
 		help.append("\tprovaddartifactrepo <repository URL> - Adds an artifact repository");
 		help.append(NEW_LINE);
 		help.append("\tprovaddprofile <profileId> <location> <flavor> - Adds a profile with the given id, location and flavor");
 		help.append(NEW_LINE);
 		return help.toString();
 	}

 	/**
 	 * Prints a string representation of an {@link IInstallableUnit} to the
 	 * iterpreter's output stream.
 	 */
 	public void print(CommandInterpreter interpreter, IInstallableUnit unit) {
 		interpreter.print(unit.getId() + ' ' + unit.getVersion());
 	}

 	/**
 	 * Prints a string representation of an {@link IInstallableUnit} to the
 	 * iterpreter's output stream, following by a line terminator
 	 */
 	public void println(CommandInterpreter interpreter, IInstallableUnit unit) {
 		print(interpreter, unit);
 		interpreter.println();
 	}

 	private void println(CommandInterpreter interpreter, IArtifactKey artifactKey, File location) {
 		interpreter.print(artifactKey.toString() + ' ' + location);
 		interpreter.println();
 	}
 }
	/*******************************************************************************
	* Copyright (c) 2007, 2008 IBM Corporation and others. All rights reserved. This
	* program and the accompanying materials are made available under the terms of
	* the Eclipse Public License v1.0 which accompanies this distribution, and is
	* available at http://www.eclipse.org/legal/epl-v10.html
	*
	* Contributors: IBM Corporation - initial API and implementation
	* Band XI - add more commands
	******************************************************************************/
	package org.eclipse.equinox.internal.p2.console;

	import java.io.File;
	import java.net.MalformedURLException;
	import java.net.URL;
	import java.util.*;
	import org.eclipse.core.runtime.IStatus;
	import org.eclipse.core.runtime.NullProgressMonitor;
	import org.eclipse.equinox.internal.p2.core.helpers.ServiceHelper;
	import org.eclipse.equinox.internal.provisional.p2.artifact.repository.*;
	import org.eclipse.equinox.internal.provisional.p2.core.ProvisionException;
	import org.eclipse.equinox.internal.provisional.p2.engine.IProfile;
	import org.eclipse.equinox.internal.provisional.p2.engine.IProfileRegistry;
	import org.eclipse.equinox.internal.provisional.p2.metadata.IArtifactKey;
	import org.eclipse.equinox.internal.provisional.p2.metadata.IInstallableUnit;
	import org.eclipse.equinox.internal.provisional.p2.metadata.query.IUPropertyQuery;
	import org.eclipse.equinox.internal.provisional.p2.metadata.query.InstallableUnitQuery;
	import org.eclipse.equinox.internal.provisional.p2.metadata.repository.IMetadataRepositoryManager;
	import org.eclipse.equinox.internal.provisional.p2.query.*;
	import org.eclipse.osgi.framework.console.CommandInterpreter;
	import org.eclipse.osgi.framework.console.CommandProvider;
	import org.eclipse.osgi.service.resolver.VersionRange;

	/**
	* An OSGi console command provider that adds various commands for interacting
	* with the provisioning system.
	*/
	public class ProvCommandProvider implements CommandProvider {
	private static final String WILDCARD_ANY = "*"; //$NON-NLS-1$
	public static final String NEW_LINE = System.getProperty("line.separator", "\n"); //$NON-NLS-1$ //$NON-NLS-2$

	// private Profile profile;

	public ProvCommandProvider(String profileId, IProfileRegistry registry) {
	// look up the profile we are currently running and use it as the
	// default.
	// TODO define a way to spec the default profile to manage
	// if (profileId != null) {
	// profile = registry.getProfile(profileId);
	// if (profile != null)
	// return;
	// }
	// // A default was not defined so manage the first profile we can find
	// Profile[] profiles = registry.getProfiles();
	// if (profiles.length > 0)
	// profile = profiles[0];
	}

	/**
	* Adds a metadata repository.
	*/
	public void _provaddrepo(CommandInterpreter interpreter) {
	String urlString = interpreter.nextArgument();
	if (urlString == null) {
	interpreter.print("Repository location must be provided");
	interpreter.println();
	return;
	}
	URL repoURL = toURL(interpreter, urlString);
	if (repoURL == null)
	return;
	if (ProvisioningHelper.addMetadataRepository(repoURL) == null)
	interpreter.println("Unable to add repository: " + repoURL);
	}

	public void _provdelrepo(CommandInterpreter interpreter) {
	String urlString = interpreter.nextArgument();
	if (urlString == null) {
	interpreter.print("Repository location must be provided");
	interpreter.println();
	return;
	}
	URL repoURL = toURL(interpreter, urlString);
	if (repoURL == null)
	return;
	ProvisioningHelper.removeMetadataRepository(repoURL);
	}

	public void _provaddartifactrepo(CommandInterpreter interpreter) {
	String urlString = interpreter.nextArgument();
	if (urlString == null) {
	interpreter.print("Repository location must be provided");
	interpreter.println();
	return;
	}
	URL repoURL = toURL(interpreter, urlString);
	if (repoURL == null)
	return;
	if (ProvisioningHelper.addArtifactRepository(repoURL) == null)
	interpreter.println("Unable to add repository: " + repoURL);
	}

	public void _provdelartifactrepo(CommandInterpreter interpreter) {
	String urlString = interpreter.nextArgument();
	if (urlString == null) {
	interpreter.print("Repository location must be provided");
	interpreter.println();
	return;
	}
	URL repoURL = toURL(interpreter, urlString);
	if (repoURL == null)
	return;
	ProvisioningHelper.removeArtifactRepository(repoURL);
	}

	/**
	* Install a given IU to a given profile location.
	*/
	public void _provinstall(CommandInterpreter interpreter) {
	String iu = interpreter.nextArgument();
	String version = interpreter.nextArgument();
	String profileId = interpreter.nextArgument();
	if (profileId == null \|\| profileId.equals("this"))
	profileId = IProfileRegistry.SELF;
	if (iu == null \|\| version == null \|\| profileId == null) {
	interpreter.println("Installable unit id, version, and profile Id must be provided");
	return;
	}
	IStatus s = null;
	try {
	s = ProvisioningHelper.install(iu, version, ProvisioningHelper.getProfile(profileId), new NullProgressMonitor());
	} catch (ProvisionException e) {
	interpreter.println("installation failed ");
	e.printStackTrace();
	return;
	}
	if (s.isOK())
	interpreter.println("installation complete");
	else
	interpreter.println("installation failed " + s.getMessage());
	}

	/**
	* Creates a profile given an id, location, and flavor
	*/
	public void _provaddprofile(CommandInterpreter interpreter) {
	String profileId = interpreter.nextArgument();
	String location = interpreter.nextArgument();
	String flavor = interpreter.nextArgument();
	if (profileId == null \|\| location == null \|\| flavor == null) {
	interpreter.println("Id, location, and flavor must be provided");
	return;
	}
	String environments = interpreter.nextArgument();
	Properties props = new Properties();
	props.setProperty(IProfile.PROP_INSTALL_FOLDER, location);
	props.setProperty(IProfile.PROP_FLAVOR, flavor);
	if (environments != null)
	props.setProperty(IProfile.PROP_ENVIRONMENTS, environments);

	ProvisioningHelper.addProfile(profileId, props);
	}

	/**
	* Deletes a profile given an id, location, and flavor
	*/
	public void _provdelprofile(CommandInterpreter interpreter) {
	String profileId = interpreter.nextArgument();
	if (profileId == null) {
	interpreter.println("Id must be provided");
	return;
	}
	ProvisioningHelper.removeProfile(profileId);
	}

	/**
	* Lists the installable units that match the given URL, id, and/or version.
	*
	* @param interpreter
	*/
	public void _provliu(CommandInterpreter interpreter) {
	String urlString = processArgument(interpreter.nextArgument());
	String id = processArgument(interpreter.nextArgument());
	String version = processArgument(interpreter.nextArgument());
	URL repoURL = null;
	if (urlString != null && !urlString.equals(WILDCARD_ANY))
	repoURL = toURL(interpreter, urlString);
	IInstallableUnit[] units = sort(ProvisioningHelper.getInstallableUnits(repoURL, new InstallableUnitQuery(id, new VersionRange(version)), null));
	for (int i = 0; i < units.length; i++)
	println(interpreter, units[i]);
	}

	/**
	* Lists the known metadata repositories, or the contents of a given
	* metadata repository.
	*
	* @param interpreter
	*/
	public void _provlr(CommandInterpreter interpreter) {
	String urlString = processArgument(interpreter.nextArgument());
	String id = processArgument(interpreter.nextArgument());
	String version = processArgument(interpreter.nextArgument());
	if (urlString == null) {
	URL[] repositories = ProvisioningHelper.getMetadataRepositories();
	if (repositories != null)
	for (int i = 0; i < repositories.length; i++)
	interpreter.println(repositories[i]);
	return;
	}
	URL repoURL = toURL(interpreter, urlString);
	if (repoURL == null)
	return;
	IInstallableUnit[] units = sort(ProvisioningHelper.getInstallableUnits(repoURL, new InstallableUnitQuery(id, new VersionRange(version)), null));
	for (int i = 0; i < units.length; i++)
	println(interpreter, units[i]);
	}

	/**
	* Lists the group IUs in all known metadata repositories, or in the given
	* metadata repository.
	*
	* @param interpreter
	*/
	public void _provlg(CommandInterpreter interpreter) {
	String urlString = processArgument(interpreter.nextArgument());
	IQueryable queryable = null;
	if (urlString == null) {
	queryable = (IQueryable) ServiceHelper.getService(Activator.getContext(), IMetadataRepositoryManager.class.getName());
	if (queryable == null)
	return;
	} else {
	URL repoURL = toURL(interpreter, urlString);
	if (repoURL == null)
	return;
	queryable = ProvisioningHelper.getMetadataRepository(repoURL);
	if (queryable == null)
	return;
	}
	Query query = new IUPropertyQuery(IInstallableUnit.PROP_TYPE_GROUP, Boolean.TRUE.toString());
	IInstallableUnit[] units = sort(queryable.query(query, new Collector(), null));
	for (int i = 0; i < units.length; i++)
	println(interpreter, units[i]);
	}

	/**
	* Lists the known artifact repositories, or the contents of a given
	* artifact repository.
	*
	* @param interpreter
	*/
	public void _provlar(CommandInterpreter interpreter) {
	String urlString = processArgument(interpreter.nextArgument());
	if (urlString == null) {
	URL[] repositories = ProvisioningHelper.getArtifactRepositories();
	if (repositories == null)
	return;
	for (int i = 0; i < repositories.length; i++)
	interpreter.println(repositories[i]);
	return;
	}
	URL repoURL = toURL(interpreter, urlString);
	if (repoURL == null)
	return;
	IArtifactRepository repo = ProvisioningHelper.getArtifactRepository(repoURL);
	IArtifactKey[] keys = null;
	try {
	keys = (repo != null) ? repo.getArtifactKeys() : null;
	} catch (UnsupportedOperationException e) {
	interpreter.println("Repository does not support list commands.");
	return;
	}
	if (keys == null \|\| keys.length == 0) {
	interpreter.println("Repository has no artifacts");
	return;
	}
	IFileArtifactRepository fileRepo = (IFileArtifactRepository) repo.getAdapter(IFileArtifactRepository.class);
	for (int i = 0; i < keys.length; i++) {
	IArtifactDescriptor[] descriptors = repo.getArtifactDescriptors(keys[i]);
	for (int j = 0; j < descriptors.length; j++) {
	IArtifactDescriptor descriptor = descriptors[j];
	File location = null;
	if (fileRepo != null)
	location = fileRepo.getArtifactFile(descriptor);
	println(interpreter, keys[i], location);
	}

	}
	}

	/**
	* Returns the given string as an URL, or <code>null</code> if the string
	* could not be interpreted as an URL.
	*/
	private URL toURL(CommandInterpreter interpreter, String urlString) {
	try {
	return new URL(urlString);
	} catch (MalformedURLException e) {
	interpreter.print(e.getMessage());
	interpreter.println();
	return null;
	}
	}

	private String processArgument(String arg) {
	if (arg == null \|\| arg.equals(WILDCARD_ANY))
	return null;
	return arg;
	}

	/**
	* Lists the known profiles, or the contents of a given profile.
	*
	* @param interpreter
	*/
	public void _provlp(CommandInterpreter interpreter) {
	String profileId = processArgument(interpreter.nextArgument());
	String id = processArgument(interpreter.nextArgument());
	String range = processArgument(interpreter.nextArgument());
	if (profileId == null) {
	IProfile[] profiles = ProvisioningHelper.getProfiles();
	for (int i = 0; i < profiles.length; i++)
	interpreter.println(profiles[i].getProfileId());
	return;
	}
	// determine which profile is to be listed
	IProfile target = null;
	if (profileId.equals("this"))
	profileId = IProfileRegistry.SELF;
	target = ProvisioningHelper.getProfile(profileId);
	if (target == null)
	return;

	// list the profile contents
	IInstallableUnit[] result = sort(target.query(new InstallableUnitQuery(id, new VersionRange(range)), new Collector(), null));
	for (int i = 0; i < result.length; i++)
	interpreter.println(result[i]);
	}

	private IInstallableUnit[] sort(Collector collector) {
	IInstallableUnit[] units = (IInstallableUnit[]) collector.toArray(IInstallableUnit.class);
	Arrays.sort(units, new Comparator() {
	public int compare(Object arg0, Object arg1) {
	return arg0.toString().compareTo(arg1.toString());
	}
	});
	return units;
	}

	public String getHelp() {
	StringBuffer help = new StringBuffer();
	help.append(NEW_LINE);
	help.append("---"); //$NON-NLS-1$
	help.append("Provisioning Commands");
	help.append("---"); //$NON-NLS-1$
	help.append(NEW_LINE);
	help.append("\tprovlr [<repository URL> <iu id \| > <version range \| >] - Lists all metadata repositories, or the contents of a given metadata repository");
	help.append(NEW_LINE);
	help.append("\tprovlar [<repository URL>] - Lists all artifact repositories, or the contents of a given artifact repository");
	help.append(NEW_LINE);
	help.append("\tprovliu [<repository URL \| > <iu id \| > <version range \| >] - Lists the IUs that match the pattern in the given repo. matches all");
	help.append(NEW_LINE);
	help.append("\tprovlp [<profile id \| *> - Lists all profiles, or the contents of the profile at the given profile");
	help.append(NEW_LINE);
	help.append("\tprovlg [<repository URL> <iu id \| > <version range \| >] - Lists all IUs with group capabilities in the given repo or in all repos if the URL is omitted");
	help.append(NEW_LINE);
	help.append("\tprovinstall <InstallableUnit> <version> <profileId> - Provisions an IU to the profile with the give id");
	help.append(NEW_LINE);
	help.append("\tprovaddrepo <repository URL> - Adds a metadata repository");
	help.append(NEW_LINE);
	help.append("\tprovaddartifactrepo <repository URL> - Adds an artifact repository");
	help.append(NEW_LINE);
	help.append("\tprovaddprofile <profileId> <location> <flavor> - Adds a profile with the given id, location and flavor");
	help.append(NEW_LINE);
	return help.toString();
	}

	/**
	* Prints a string representation of an {@link IInstallableUnit} to the
	* iterpreter's output stream.
	*/
	public void print(CommandInterpreter interpreter, IInstallableUnit unit) {
	interpreter.print(unit.getId() + ' ' + unit.getVersion());
	}

	/**
	* Prints a string representation of an {@link IInstallableUnit} to the
	* iterpreter's output stream, following by a line terminator
	*/
	public void println(CommandInterpreter interpreter, IInstallableUnit unit) {
	print(interpreter, unit);
	interpreter.println();
	}

	private void println(CommandInterpreter interpreter, IArtifactKey artifactKey, File location) {
	interpreter.print(artifactKey.toString() + ' ' + location);
	interpreter.println();
	}
	}