1 /*******************************************************************************

     2  * Copyright (c) 2009 Nokia and others.

     3  * All rights reserved. This program and the accompanying materials

     4  * are made available under the terms of the Eclipse Public License v1.0

     5  * which accompanies this distribution, and is available at

     6  * http://www.eclipse.org/legal/epl-v10.html

     7  *

     8  * Contributors:

     9  * Nokia - Initial API and implementation

    10  *******************************************************************************/

    11 package org.eclipse.cdt.debug.core.executables;

    12 

    13 import java.util.List;

    14 

    15 import org.eclipse.core.resources.IProject;

    16 import org.eclipse.core.runtime.IProgressMonitor;

    17 import org.eclipse.core.runtime.IStatus;

    18 

    19 /**

    20  * IProjectExecutablesProvider supplies a list of executables for a project

    21  * to the Executables Manager.

    22  * 

    23  * @author Warren Paul

    24  * 

    25  */

    26 public interface IProjectExecutablesProvider {

    27 

    28 	/**

    29 	 * Get the list of project natures that should be present in projects that

    30 	 * this provider will get the list of executables for.  Since there could

    31 	 * be any number of executable providers, the one that matches the given

    32 	 * project natures the closest will be chosen.

    33 	 * @return the list of project nature id's

    34 	 */

    35 	List<String> getProjectNatures();	

    36 	

    37 	/**

    38 	 * Get the list of executables for the given project

    39 	 * @param project the project to get the executables for

    40 	 * @param monitor progress monitor

    41 	 * @return the list of executables (which may be empty)

    42 	 */

    43 	List<Executable> getExecutables(IProject project, IProgressMonitor monitor);

    44 

    45 	/**

    46 	 * Remove the given executable.  Note that the project can be obtained from Executable.

    47 	 * @param executable the executable to remove

    48 	 * @param monitor progress monitor

    49 	 * @return the status of the remove operation

    50 	 */

    51 	IStatus removeExecutable(Executable executable, IProgressMonitor monitor);

    52 

    53 }