/*
    * Licensed to the Apache Software Foundation (ASF) under one
    * or more contributor license agreements.  See the NOTICE file
    * distributed with this work for additional information
    * regarding copyright ownership.  The ASF licenses this file
    * to you under the Apache License, Version 2.0 (the
    * "License"); you may not use this file except in compliance
    * with the License.  You may obtain a copy of the License at
    *
   *   http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing,
   * software distributed under the License is distributed on an
   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   * KIND, either express or implied.  See the License for the
   * specific language governing permissions and limitations
   * under the License.
   */
  package org.apache.maven.lifecycle;
  
  import java.util.List;
  import java.util.Set;
  import org.apache.maven.execution.MavenSession;
  import org.apache.maven.model.Plugin;
  import org.apache.maven.plugin.InvalidPluginDescriptorException;
  import org.apache.maven.plugin.MojoExecution;
  import org.apache.maven.plugin.MojoNotFoundException;
  import org.apache.maven.plugin.PluginDescriptorParsingException;
  import org.apache.maven.plugin.PluginManagerException;
  import org.apache.maven.plugin.PluginNotFoundException;
  import org.apache.maven.plugin.PluginResolutionException;
  import org.apache.maven.plugin.prefix.NoPluginFoundForPrefixException;
  import org.apache.maven.plugin.version.PluginVersionResolutionException;
  import org.apache.maven.project.MavenProject;
  
  /**
   * A facade that provides lifecycle services to components outside Maven core.
   *
   * @author Jason van  Zyl
   */
  public interface LifecycleExecutor {
  
      // USED BY MAVEN HELP PLUGIN
      @Deprecated
      String ROLE = LifecycleExecutor.class.getName();
  
      // For a given project packaging find all the plugins that are bound to any registered
      // lifecycles. The project builder needs to now what default plugin information needs to be
      // merged into POM being built. Once the POM builder has this plugin information, versions can be assigned
      // by the POM builder because they will have to be defined in plugin management. Once this is setComplete then it
      // can be passed back so that the default configuration information can be populated.
      //
      // We need to know the specific version so that we can look up the right version of the plugin descriptor
      // which tells us what the default configuration is.
      //
  
      /**
       * @return The plugins bound to the lifecycles of the specified packaging or {@code null} if the packaging is
       *         unknown.
       */
      Set<Plugin> getPluginsBoundByDefaultToAllLifecycles(String packaging);
  
      MavenExecutionPlan calculateExecutionPlan(MavenSession session, String... tasks)
              throws PluginNotFoundException, PluginResolutionException, PluginDescriptorParsingException,
                      MojoNotFoundException, NoPluginFoundForPrefixException, InvalidPluginDescriptorException,
                      PluginManagerException, LifecyclePhaseNotFoundException, LifecycleNotFoundException,
                      PluginVersionResolutionException;
  
      MavenExecutionPlan calculateExecutionPlan(MavenSession session, boolean setup, String... tasks)
              throws PluginNotFoundException, PluginResolutionException, PluginDescriptorParsingException,
                      MojoNotFoundException, NoPluginFoundForPrefixException, InvalidPluginDescriptorException,
                      PluginManagerException, LifecyclePhaseNotFoundException, LifecycleNotFoundException,
                      PluginVersionResolutionException;
  
      void execute(MavenSession session);
  
      // used by the site plugin 3.x
      void calculateForkedExecutions(MojoExecution mojoExecution, MavenSession session)
              throws MojoNotFoundException, PluginNotFoundException, PluginResolutionException,
                      PluginDescriptorParsingException, NoPluginFoundForPrefixException, InvalidPluginDescriptorException,
                      LifecyclePhaseNotFoundException, LifecycleNotFoundException, PluginVersionResolutionException;
  
      // used by the site plugin 3.x
      List<MavenProject> executeForkedExecutions(MojoExecution mojoExecution, MavenSession session)
              throws LifecycleExecutionException;
  }