/*******************************************************************************
 * Copyright (c) 2007, 2010 Intel 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:
 * Intel Corporation - Initial API and implementation
 *******************************************************************************/
package org.eclipse.cdt.managedbuilder.tcmodification;

import org.eclipse.cdt.managedbuilder.core.ITool;

/**
 * @noextend This class is not intended to be subclassed by clients.
 * @noimplement This interface is not intended to be implemented by clients.
 */
public interface IToolListModification extends IApplicableModification {
	/**
	 * specifies the set of tools to be validated
	 * once the set of tools is modified,
	 * all previously calculated ToolModifications become invalid,
	 * i.e. one should re-query the ToolModification for each tool needed
	 * Note that this method does NOT apply the tools to the underlying resource info
	 * For applying the settings the {@link IApplicableModification#apply()} method should be called
	 */
	void changeProjectTools(ITool removeTools, ITool addTool);
	
	/**
	 * returns the list of tools assigned to the given resource info
	 * on the ToolListModificatrion creation the tool-list is the one
	 * contained by the given resource info
	 * the list can be changed by calling the {@code #setProjectTools(ITool[])} method
	 */
	ITool[] getProjectTools();

//	ITool[] getSystemTools();

	/**
	 * returns a list of tool modifications for all project tools contained 
	 * by this toollist modification 
	 */
	IToolModification[] getProjectToolModifications();

	/**
	 * returns a list of tool modifications for all system tools not contained 
	 * by this toollist modification 
	 */
	IToolModification[] getSystemToolModifications();

	/**
	 * returns a tool-list modification for the given tool
	 * if a is one of the project tools contained by this tool-list modification
	 * the returned ToolModification is a project modification for that tool
	 * otherwise the returned ToolModification tool is a system tool modification for the
	 * given system tool
	 */
	IToolModification getToolModification(ITool tool);
	
	void restoreDefaults();
}