package org.apache.maven.plugin.invoker;

 /*

  * 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.

  */

 import org.apache.maven.plugin.AbstractMojo;

 import org.apache.maven.plugin.MojoExecutionException;

 import org.apache.maven.plugin.MojoFailureException;

 import org.apache.maven.plugin.invoker.model.BuildJob;

 import org.apache.maven.plugin.invoker.model.io.xpp3.BuildJobXpp3Writer;

 import org.apache.maven.model.Model;

 import org.apache.maven.model.Profile;

 import org.apache.maven.shared.invoker.InvocationRequest;

 import org.apache.maven.shared.invoker.DefaultInvocationRequest;

 import org.apache.maven.shared.invoker.MavenCommandLineBuilder;

 import org.apache.maven.shared.invoker.CommandLineConfigurationException;

 import org.apache.maven.shared.invoker.InvocationResult;

 import org.apache.maven.shared.invoker.MavenInvocationException;

 import org.apache.maven.shared.invoker.Invoker;

 import org.apache.maven.project.MavenProject;

 import org.apache.maven.settings.Settings;

 import org.codehaus.plexus.util.StringUtils;

 import org.codehaus.plexus.util.ReaderFactory;

 import org.codehaus.plexus.util.FileUtils;

 import org.codehaus.plexus.util.DirectoryScanner;

 import org.codehaus.plexus.util.IOUtil;

 import org.codehaus.plexus.util.InterpolationFilterReader;

 import org.codehaus.plexus.util.WriterFactory;

 import org.codehaus.plexus.interpolation.Interpolator;

 import org.codehaus.plexus.interpolation.RegexBasedInterpolator;

 import org.codehaus.plexus.interpolation.MapBasedValueSource;

 import org.codehaus.plexus.interpolation.InterpolationException;

 import java.io.IOException;

 import java.io.File;

 import java.io.Reader;

 import java.io.FileOutputStream;

 import java.io.Writer;

 import java.io.OutputStreamWriter;

 import java.io.InputStream;

 import java.io.FileInputStream;

 import java.io.BufferedReader;

 import java.util.Collection;

 import java.util.LinkedHashSet;

 import java.util.Iterator;

 import java.util.List;

 import java.util.ArrayList;

 import java.util.Properties;

 import java.util.TreeSet;

 import java.util.Map;

 import java.util.LinkedHashMap;

 import java.util.Arrays;

 import java.util.HashMap;

 import java.util.StringTokenizer;

 import java.util.Collections;

 import java.util.Locale;

 import java.text.DecimalFormat;

 import java.text.DecimalFormatSymbols;

 /**

  * Provides common code for mojos invoking sub builds.

  *

  * @author Stephen Connolly

  * @since 15-Aug-2009 09:09:29

  */

 public abstract class AbstractInvokerMojo

     extends AbstractMojo

 {

     /**

      * Flag used to suppress certain invocations. This is useful in tailoring the build using profiles.

      *

      * @parameter expression="${invoker.skip}" default-value="false"

      * @since 1.1

      */

     private boolean skipInvocation;

     /**

      * Flag used to suppress the summary output notifying of successes and failures. If set to <code>true</code>, the

      * only indication of the build's success or failure will be the effect it has on the main build (if it fails, the

      * main build should fail as well). If {@link #streamLogs} is enabled, the sub-build summary will also provide an

      * indication.

      *

      * @parameter default-value="false"

      */

     protected boolean suppressSummaries;

     /**

      * Flag used to determine whether the build logs should be output to the normal mojo log.

      *

      * @parameter expression="${invoker.streamLogs}" default-value="false"

      */

     private boolean streamLogs;

     /**

      * The local repository for caching artifacts. It is strongly recommended to specify a path to an isolated

      * repository like <code>${project.build.directory}/it-repo</code>. Otherwise, your ordinary local repository will

      * be used, potentially soiling it with broken artifacts.

      *

      * @parameter expression="${invoker.localRepositoryPath}" default-value="${settings.localRepository}"

      */

     private File localRepositoryPath;

     /**

      * Directory to search for integration tests.

      *

      * @parameter expression="${invoker.projectsDirectory}" default-value="${basedir}/src/it/"

      */

     private File projectsDirectory;

     /**

      * Base directory where all build reports are written to.

      *

      * @parameter expression="${invoker.reportsDirectory}" default-value="${project.build.directory}/invoker-reports"

      * @since 1.4

      */

     private File reportsDirectory;

     /**

      * A flag to disable the generation of build reports.

      *

      * @parameter expression="${invoker.disableReports}" default-value="false"

      * @since 1.4

      */

     private boolean disableReports;

     /**

      * Directory to which projects should be cloned prior to execution. If not specified, each integration test will be

      * run in the directory in which the corresponding IT POM was found. In this case, you most likely want to configure

      * your SCM to ignore <code>target</code> and <code>build.log</code> in the test's base directory.

      *

      * @parameter

      * @since 1.1

      */

     private File cloneProjectsTo;

     /**

      * Some files are normally excluded when copying the IT projects from the directory specified by the parameter

      * projectsDirectory to the directory given by cloneProjectsTo (e.g. <code>.svn</code>, <code>CVS</code>,

      * <code>*~</code>, etc). Setting this parameter to <code>true</code> will cause all files to be copied to the

      * cloneProjectsTo directory.

      *

      * @parameter default-value="false"

      * @since 1.2

      */

     private boolean cloneAllFiles;

     /**

      * A single POM to build, skipping any scanning parameters and behavior.

      *

      * @parameter expression="${invoker.pom}"

      */

     private File pom;

     /**

      * Include patterns for searching the integration test directory for projects. This parameter is meant to be set

      * from the POM. If this parameter is not set, the plugin will search for all <code>pom.xml</code> files one

      * directory below {@link #projectsDirectory} (i.e. <code>*&#47;pom.xml</code>).<br>

      * <br>

      * Starting with version 1.3, mere directories can also be matched by these patterns. For example, the include

      * pattern <code>*</code> will run Maven builds on all immediate sub directories of {@link #projectsDirectory},

      * regardless if they contain a <code>pom.xml</code>. This allows to perform builds that need/should not depend on

      * the existence of a POM.

      *

      * @parameter

      */

     private List pomIncludes = Collections.singletonList( "*/pom.xml" );

     /**

      * Exclude patterns for searching the integration test directory. This parameter is meant to be set from the POM. By

      * default, no POM files are excluded. For the convenience of using an include pattern like <code>*</code>, the

      * custom settings file specified by the parameter {@link #settingsFile} will always be excluded automatically.

      *

      * @parameter

      */

     private List pomExcludes = Collections.EMPTY_LIST;

     /**

      * Include patterns for searching the projects directory for projects that need to be run before the other projects.

      * This parameter allows to declare projects that perform setup tasks like installing utility artifacts into the

      * local repository. Projects matched by these patterns are implicitly excluded from the scan for ordinary projects.

      * Also, the exclusions defined by the parameter {@link #pomExcludes} apply to the setup projects, too. Default

      * value is: <code>setup*&#47;pom.xml</code>.

      *

      * @parameter

      * @since 1.3

      */

     private List setupIncludes = Collections.singletonList( "setup*/pom.xml" );

     /**

      * The list of goals to execute on each project. Default value is: <code>package</code>.

      *

      * @parameter

      */

     private List goals = Collections.singletonList( "package" );

     /**

      * The name of the project-specific file that contains the enumeration of goals to execute for that test.

      *

      * @parameter expression="${invoker.goalsFile}" default-value="goals.txt"

      * @deprecated As of version 1.2, the key <code>invoker.goals</code> from the properties file specified by the

      *             parameter {@link #invokerPropertiesFile} should be used instead.

      */

     private String goalsFile;

     /**

      * @component

      */

     private Invoker invoker;

     /**

      * Relative path of a selector script to run prior in order to decide if the build should be executed. This script 

      * may be written with either BeanShell or Groovy. If the file extension is omitted (e.g. <code>selector</code>), 

      * the plugin searches for the file by trying out the well-known extensions <code>.bsh</code> and <code>.groovy</code>. 

      * If this script exists for a particular project but returns any non-null value different from <code>true</code>, 

      * the corresponding build is flagged as skipped. In this case, none of the pre-build hook script, 

      * Maven nor the post-build hook script will be invoked. If this script throws an exception, the corresponding 

      * build is flagged as in error, and none of the pre-build hook script, Maven not the post-build hook script will

      * be invoked.

      *

      * @parameter expression="${invoker.selectorScript}" default-value="selector"

      * @since 1.5

      */

     private String selectorScript;

     /**

      * Relative path of a pre-build hook script to run prior to executing the build. This script may be written with

      * either BeanShell or Groovy (since 1.3). If the file extension is omitted (e.g. <code>prebuild</code>), the plugin

      * searches for the file by trying out the well-known extensions <code>.bsh</code> and <code>.groovy</code>. If this

      * script exists for a particular project but returns any non-null value different from <code>true</code> or throws

      * an exception, the corresponding build is flagged as a failure. In this case, neither Maven nor the post-build

      * hook script will be invoked.

      *

      * @parameter expression="${invoker.preBuildHookScript}" default-value="prebuild"

      */

     private String preBuildHookScript;

     /**

      * Relative path of a cleanup/verification hook script to run after executing the build. This script may be written

      * with either BeanShell or Groovy (since 1.3). If the file extension is omitted (e.g. <code>verify</code>), the

      * plugin searches for the file by trying out the well-known extensions <code>.bsh</code> and <code>.groovy</code>.

      * If this script exists for a particular project but returns any non-null value different from <code>true</code> or

      * throws an exception, the corresponding build is flagged as a failure.

      *

      * @parameter expression="${invoker.postBuildHookScript}" default-value="postbuild"

      */

     private String postBuildHookScript;

     /**

      * Location of a properties file that defines CLI properties for the test.

      *

      * @parameter expression="${invoker.testPropertiesFile}" default-value="test.properties"

      */

     private String testPropertiesFile;

     /**

      * Common set of test properties to pass in on each IT's command line, via -D parameters.

      *

      * @parameter

      * @deprecated As of version 1.1, use the {@link #properties} parameter instead.

      */

     private Properties testProperties;

     /**

      * Common set of properties to pass in on each project's command line, via -D parameters.

      *

      * @parameter

      * @since 1.1

      */

     private Map properties;

     /**

      * Whether to show errors in the build output.

      *

      * @parameter expression="${invoker.showErrors}" default-value="false"

      */

     private boolean showErrors;

     /**

      * Whether to show debug statements in the build output.

      *

      * @parameter expression="${invoker.debug}" default-value="false"

      */

     private boolean debug;

     /**

      * Suppress logging to the <code>build.log</code> file.

      *

      * @parameter expression="${invoker.noLog}" default-value="false"

      */

     private boolean noLog;

     /**

      * List of profile identifiers to explicitly trigger in the build.

      *

      * @parameter

      * @since 1.1

      */

     private List profiles;

     /**

      * List of properties which will be used to interpolate goal files.

      *

      * @parameter

      * @since 1.1

      * @deprecated As of version 1.3, the parameter {@link #filterProperties} should be used instead.

      */

     private Properties interpolationsProperties;

     /**

      * A list of additional properties which will be used to filter tokens in POMs and goal files.

      *

      * @parameter

      * @since 1.3

      */

     private Map filterProperties;

     /**

      * The Maven Project Object

      *

      * @parameter expression="${project}"

      * @required

      * @readonly

      * @since 1.1

      */

     private MavenProject project;

     /**

      * A comma separated list of project names to run. Specify this parameter to run individual tests by file name,

      * overriding the {@link #setupIncludes}, {@link #pomIncludes} and {@link #pomExcludes} parameters. Each pattern you

      * specify here will be used to create an include pattern formatted like

      * <code>${projectsDirectory}/<i>pattern</i></code>, so you can just type

      * <code>-Dinvoker.test=FirstTest,SecondTest</code> to run builds in <code>${projectsDirectory}/FirstTest</code> and

      * <code>${projectsDirectory}/SecondTest</code>.

      *

      * @parameter expression="${invoker.test}"

      * @since 1.1

      */

     private String invokerTest;

     /**

      * The name of the project-specific file that contains the enumeration of profiles to use for that test. <b>If the

      * file exists and is empty no profiles will be used even if the parameter {@link #profiles} is set.</b>

      *

      * @parameter expression="${invoker.profilesFile}" default-value="profiles.txt"

      * @since 1.1

      * @deprecated As of version 1.2, the key <code>invoker.profiles</code> from the properties file specified by the

      *             parameter {@link #invokerPropertiesFile} should be used instead.

      */

     private String profilesFile;

     /**

      * Path to an alternate <code>settings.xml</code> to use for Maven invocation with all ITs. Note that the

      * <code>&lt;localRepository&gt;</code> element of this settings file is always ignored, i.e. the path given by the

      * parameter {@link #localRepositoryPath} is dominant.

      *

      * @parameter expression="${invoker.settingsFile}"

      * @since 1.2

      */

     private File settingsFile;

     /**

      * The <code>MAVEN_OPTS</code> environment variable to use when invoking Maven. This value can be overridden for

      * individual integration tests by using {@link #invokerPropertiesFile}.

      *

      * @parameter expression="${invoker.mavenOpts}"

      * @since 1.2

      */

     private String mavenOpts;

     /**

      * The home directory of the Maven installation to use for the forked builds. Defaults to the current Maven

      * installation.

      *

      * @parameter expression="${invoker.mavenHome}"

      * @since 1.3

      */

     private File mavenHome;

     /**

      * The <code>JAVA_HOME</code> environment variable to use for forked Maven invocations. Defaults to the current Java

      * home directory.

      *

      * @parameter expression="${invoker.javaHome}"

      * @since 1.3

      */

     private File javaHome;

     /**

      * The file encoding for the pre-/post-build scripts and the list files for goals and profiles.

      *

      * @parameter expression="${encoding}" default-value="${project.build.sourceEncoding}"

      * @since 1.2

      */

     private String encoding;

     /**

      * The current user system settings for use in Maven.

      *

      * @parameter expression="${settings}"

      * @required

      * @readonly

      * @since 1.2

      */

     private Settings settings;

     /**

      * A flag whether the test class path of the project under test should be included in the class path of the

      * pre-/post-build scripts. If set to <code>false</code>, the class path of script interpreter consists only of

      * the <a href="dependencies.html">runtime dependencies</a> of the Maven Invoker Plugin. If set the

      * <code>true</code>, the project's test class path will be prepended to the interpreter class path. Among

      * others, this feature allows the scripts to access utility classes from the test sources of your project.

      *

      * @parameter expression="${invoker.addTestClassPath}" default-value="false"

      * @since 1.2

      */

     private boolean addTestClassPath;

     /**

      * The test class path of the project under test.

      *

      * @parameter default-value="${project.testClasspathElements}"

      * @readonly

      */

     private List testClassPath;

     /**

      * The name of an optional project-specific file that contains properties used to specify settings for an individual

      * Maven invocation. Any property present in the file will override the corresponding setting from the plugin

      * configuration. The values of the properties are filtered and may use expressions like

      * <code>${project.version}</code> to reference project properties or values from the parameter

      * {@link #filterProperties}. The snippet below describes the supported properties:

      *

      * <pre>

      * # A comma or space separated list of goals/phases to execute, may

      * # specify an empty list to execute the default goal of the IT project

      * invoker.goals = clean install

      *

      * # Optionally, a list of goals to run during further invocations of Maven

      * invoker.goals.2 = ${project.groupId}:${project.artifactId}:${project.version}:run

      *

      * # A comma or space separated list of profiles to activate

      * invoker.profiles = its,jdk15

      *

      * # The path to an alternative POM or base directory to invoke Maven on, defaults to the

      * # project that was originally specified in the plugin configuration

      * # Since plugin version 1.4

      * invoker.project = sub-module

      *

      * # The value for the environment variable MAVEN_OPTS

      * invoker.mavenOpts = -Dfile.encoding=UTF-16 -Xms32m -Xmx256m

      *

      * # Possible values are "fail-fast" (default), "fail-at-end" and "fail-never"

      * invoker.failureBehavior = fail-never

      *

      * # The expected result of the build, possible values are "success" (default) and "failure"

      * invoker.buildResult = failure

      *

      * # A boolean value controlling the aggregator mode of Maven, defaults to "false"

      * invoker.nonRecursive = true

      *

      * # A boolean value controlling the network behavior of Maven, defaults to "false"

      * # Since plugin version 1.4

      * invoker.offline = true

      *

      * # The path to the properties file from which to load system properties, defaults to the

      * # filename given by the plugin parameter testPropertiesFile

      * # Since plugin version 1.4

      * invoker.systemPropertiesFile = test.properties

      *

      * # An optional human friendly name for this build job to be included in the build reports.

      * # Since plugin version 1.4

      * invoker.name = Test Build 01

      *

      * # An optional description for this build job to be included in the build reports.

      * # Since plugin version 1.4

      * invoker.description = Checks the support for build reports.

      *

      * # A comma separated list of JRE versions on which this build job should be run.

      * # Since plugin version 1.4

      * invoker.java.version = 1.4+, !1.4.1, 1.7-

      *

      * # A comma separated list of OS families on which this build job should be run.

      * # Since plugin version 1.4

      * invoker.os.family = !windows, unix, mac 

      *

      * # A comma separated list of Maven versions on which this build should be run.

      * # Since plugin version 1.5

      * invoker.maven.version = 2.0.10+, !2.1.0, !2.2.0

      * </pre>

      *

      * @parameter expression="${invoker.invokerPropertiesFile}" default-value="invoker.properties"

      * @since 1.2

      */

     private String invokerPropertiesFile;

     /**

      * flag to enable show mvn version used for running its (cli option : -V,--show-version )

      * @parameter expression="${invoker.showVersion}" default-value="false"

      * @since 1.4

      */

     private boolean showVersion;

     /**

      * The scripter runner that is responsible to execute hook scripts.

      */

     private ScriptRunner scriptRunner;

     /**

      * A string used to prefix the file name of the filtered POMs in case the POMs couldn't be filtered in-place (i.e.

      * the projects were not cloned to a temporary directory), can be <code>null</code>. This will be set to

      * <code>null</code> if the POMs have already been filtered during cloning.

      */

     private String filteredPomPrefix = "interpolated-";

     /**

      * The format for elapsed build time.

      */

     private final DecimalFormat secFormat = new DecimalFormat( "(0.0 s)", new DecimalFormatSymbols( Locale.ENGLISH ) );

     /**

      * Invokes Maven on the configured test projects.

      *

      * @throws org.apache.maven.plugin.MojoExecutionException If the goal encountered severe errors.

      * @throws org.apache.maven.plugin.MojoFailureException If any of the Maven builds failed.

      */

     public void execute()

         throws MojoExecutionException, MojoFailureException

     {

         if ( skipInvocation )

         {

             getLog().info( "Skipping invocation per configuration."

                 + " If this is incorrect, ensure the skipInvocation parameter is not set to true." );

             return;

         }

         BuildJob[] buildJobs;

         if ( pom != null )

         {

             try

             {

                 projectsDirectory = pom.getCanonicalFile().getParentFile();

             }

             catch ( IOException e )

             {

                 throw new MojoExecutionException( "Failed to discover projectsDirectory from pom File parameter."

                     + " Reason: " + e.getMessage(), e );

             }

             buildJobs = new BuildJob[]{ new BuildJob( pom.getName(), BuildJob.Type.NORMAL )};

         }

         else

         {

             try

             {

                 buildJobs = getBuildJobs();

             }

             catch ( final IOException e )

             {

                 throw new MojoExecutionException( "Error retrieving POM list from includes, excludes, "

                                 + "and projects directory. Reason: " + e.getMessage(), e );

             }

         }

         if ( ( buildJobs == null ) || ( buildJobs.length < 1 ) )

         {

             getLog().info( "No projects were selected for execution." );

             return;

         }

         if ( StringUtils.isEmpty( encoding ) )

         {

             getLog().warn(

                            "File encoding has not been set, using platform encoding " + ReaderFactory.FILE_ENCODING

                                + ", i.e. build is platform dependent!" );

         }

         scriptRunner = new ScriptRunner( getLog() );

         scriptRunner.setScriptEncoding( encoding );

         scriptRunner.setGlobalVariable( "localRepositoryPath", localRepositoryPath );

         scriptRunner.setClassPath( addTestClassPath ? testClassPath : null );

         Collection collectedProjects = new LinkedHashSet();

         for ( int i = 0; i < buildJobs.length; i++ )

         {

             collectProjects( projectsDirectory, buildJobs[i].getProject(), collectedProjects, true );

         }

         File projectsDir = projectsDirectory;

         if ( cloneProjectsTo != null )

         {

             cloneProjects( collectedProjects );

             projectsDir = cloneProjectsTo;

         }

         else

         {

             getLog().warn( "Filtering of parent/child POMs is not supported without cloning the projects" );

         }

         runBuilds( projectsDir, buildJobs );

         processResults( new InvokerSession( buildJobs ) );

     }

     /**

      * Processes the results of invoking the build jobs.

      * 

      * @param invokerSession The session with the build jobs, must not be <code>null</code>.

      * @throws MojoFailureException If the mojo had failed as a result of invoking the build jobs.

      * @since 1.4

      */

     abstract void processResults( InvokerSession invokerSession )

         throws MojoFailureException;

     /**

      * Creates a new reader for the specified file, using the plugin's {@link #encoding} parameter.

      *

      * @param file The file to create a reader for, must not be <code>null</code>.

      * @return The reader for the file, never <code>null</code>.

      * @throws java.io.IOException If the specified file was not found or the configured encoding is not supported.

      */

     private Reader newReader( File file )

         throws IOException

     {

         if ( StringUtils.isNotEmpty( encoding ) )

         {

             return ReaderFactory.newReader( file, encoding );

         }

         else

         {

             return ReaderFactory.newPlatformReader( file );

         }

     }

     /**

      * Collects all projects locally reachable from the specified project. The method will as such try to read the POM

      * and recursively follow its parent/module elements.

      *

      * @param projectsDir The base directory of all projects, must not be <code>null</code>.

      * @param projectPath The relative path of the current project, can denote either the POM or its base directory,

      *            must not be <code>null</code>.

      * @param projectPaths The set of already collected projects to add new projects to, must not be <code>null</code>.

      *            This set will hold the relative paths to either a POM file or a project base directory.

      * @param included A flag indicating whether the specified project has been explicitly included via the parameter

      *            {@link #pomIncludes}. Such projects will always be added to the result set even if there is no

      *            corresponding POM.

      * @throws org.apache.maven.plugin.MojoExecutionException If the project tree could not be traversed.

      */

     private void collectProjects( File projectsDir, String projectPath, Collection projectPaths, boolean included )

         throws MojoExecutionException

     {

         projectPath = projectPath.replace( '\\', '/' );

         File pomFile = new File( projectsDir, projectPath );

         if ( pomFile.isDirectory() )

         {

             pomFile = new File( pomFile, "pom.xml" );

             if ( !pomFile.exists() )

             {

                 if ( included )

                 {

                     projectPaths.add( projectPath );

                 }

                 return;

             }

             if ( !projectPath.endsWith( "/" ) )

             {

                 projectPath += '/';

             }

             projectPath += "pom.xml";

         }

         else if ( !pomFile.isFile() )

         {

             return;

         }

         if ( !projectPaths.add( projectPath ) )

         {

             return;

         }

         getLog().debug( "Collecting parent/child projects of " + projectPath );

         Model model = PomUtils.loadPom( pomFile );

         try

         {

             String projectsRoot = projectsDir.getCanonicalPath();

             String projectDir = pomFile.getParent();

             String parentPath = "../pom.xml";

             if ( model.getParent() != null && StringUtils.isNotEmpty( model.getParent().getRelativePath() ) )

             {

                 parentPath = model.getParent().getRelativePath();

             }

             String parent = relativizePath( new File( projectDir, parentPath ), projectsRoot );

             if ( parent != null )

             {

                 collectProjects( projectsDir, parent, projectPaths, false );

             }

             Collection modulePaths = new LinkedHashSet();

             modulePaths.addAll( model.getModules() );

             for ( Iterator it = model.getProfiles().iterator(); it.hasNext(); )

             {

                 Profile profile = (Profile) it.next();

                 modulePaths.addAll( profile.getModules() );

             }

             for ( Iterator it = modulePaths.iterator(); it.hasNext(); )

             {

                 String modulePath = (String) it.next();

                 String module = relativizePath( new File( projectDir, modulePath ), projectsRoot );

                 if ( module != null )

                 {

                     collectProjects( projectsDir, module, projectPaths, false );

                 }

             }

         }

         catch ( IOException e )

         {

             throw new MojoExecutionException( "Failed to analyze POM: " + pomFile, e );

         }

     }

     /**

      * Copies the specified projects to the directory given by {@link #cloneProjectsTo}. A project may either be denoted

      * by a path to a POM file or merely by a path to a base directory. During cloning, the POM files will be filtered.

      *

      * @param projectPaths The paths to the projects to clone, relative to the projects directory, must not be

      *            <code>null</code> nor contain <code>null</code> elements.

      * @throws org.apache.maven.plugin.MojoExecutionException If the the projects could not be copied/filtered.

      */

     private void cloneProjects( Collection projectPaths )

         throws MojoExecutionException

     {

         cloneProjectsTo.mkdirs();

         // determine project directories to clone

         Collection dirs = new LinkedHashSet();

         for ( Iterator it = projectPaths.iterator(); it.hasNext(); )

         {

             String projectPath = (String) it.next();

             if ( !new File( projectsDirectory, projectPath ).isDirectory() )

             {

                 projectPath = getParentPath( projectPath );

             }

             dirs.add( projectPath );

         }

         boolean filter = false;

         // clone project directories

         try

         {

             filter = !cloneProjectsTo.getCanonicalFile().equals( projectsDirectory.getCanonicalFile() );

             List clonedSubpaths = new ArrayList();

             for ( Iterator it = dirs.iterator(); it.hasNext(); )

             {

                 String subpath = (String) it.next();

                 // skip this project if its parent directory is also scheduled for cloning

                 if ( !".".equals( subpath ) && dirs.contains( getParentPath( subpath ) ) )

                 {

                     continue;

                 }

                 // avoid copying subdirs that are already cloned.

                 if ( !alreadyCloned( subpath, clonedSubpaths ) )

                 {

                     // avoid creating new files that point to dir/.

                     if ( ".".equals( subpath ) )

                     {

                         String cloneSubdir = relativizePath( cloneProjectsTo, projectsDirectory.getCanonicalPath() );

                         // avoid infinite recursion if the cloneTo path is a subdirectory.

                         if ( cloneSubdir != null )

                         {

                             File temp = File.createTempFile( "pre-invocation-clone.", "" );

                             temp.delete();

                             temp.mkdirs();

                             copyDirectoryStructure( projectsDirectory, temp );

                             FileUtils.deleteDirectory( new File( temp, cloneSubdir ) );

                             copyDirectoryStructure( temp, cloneProjectsTo );

                         }

                         else

                         {

                             copyDirectoryStructure( projectsDirectory, cloneProjectsTo );

                         }

                     }

                     else

                     {

                         File srcDir = new File( projectsDirectory, subpath );

                         File dstDir = new File( cloneProjectsTo, subpath );

                         copyDirectoryStructure( srcDir, dstDir );

                     }

                     clonedSubpaths.add( subpath );

                 }

             }

         }

         catch ( IOException e )

         {

             throw new MojoExecutionException( "Failed to clone projects from: " + projectsDirectory + " to: "

                 + cloneProjectsTo + ". Reason: " + e.getMessage(), e );

         }

         // filter cloned POMs

         if ( filter )

         {

             for ( Iterator it = projectPaths.iterator(); it.hasNext(); )

             {

                 String projectPath = (String) it.next();

                 File pomFile = new File( cloneProjectsTo, projectPath );

                 if ( pomFile.isFile() )

                 {

                     buildInterpolatedFile( pomFile, pomFile );

                 }

             }

             filteredPomPrefix = null;

         }

     }

     /**

      * Gets the parent path of the specified relative path.

      *

      * @param path The relative path whose parent should be retrieved, must not be <code>null</code>.

      * @return The parent path or "." if the specified path has no parent, never <code>null</code>.

      */

     private String getParentPath( String path )

     {

         int lastSep = Math.max( path.lastIndexOf( '/' ), path.lastIndexOf( '\\' ) );

         return ( lastSep < 0 ) ? "." : path.substring( 0, lastSep );

     }

     /**

      * Copied a directory structure with deafault exclusions (.svn, CVS, etc)

      *

      * @param sourceDir The source directory to copy, must not be <code>null</code>.

      * @param destDir The target directory to copy to, must not be <code>null</code>.

      * @throws java.io.IOException If the directory structure could not be copied.

      */

     private void copyDirectoryStructure( File sourceDir, File destDir )

         throws IOException

     {

         DirectoryScanner scanner = new DirectoryScanner();

         scanner.setBasedir( sourceDir );

         if ( !cloneAllFiles )

         {

             scanner.addDefaultExcludes();

         }

         scanner.scan();

         /*

          * NOTE: Make sure the destination directory is always there (even if empty) to support POM-less ITs.

          */

         destDir.mkdirs();

         String[] includedDirs = scanner.getIncludedDirectories();

         for ( int i = 0; i < includedDirs.length; ++i )

         {

             File clonedDir = new File( destDir, includedDirs[i] );

             clonedDir.mkdirs();

         }

         String[] includedFiles = scanner.getIncludedFiles();

         for ( int i = 0; i < includedFiles.length; ++i )

         {

             File sourceFile = new File( sourceDir, includedFiles[i] );

             File destFile = new File( destDir, includedFiles[i] );

             FileUtils.copyFile( sourceFile, destFile );

         }

     }

     /**

      * Determines whether the specified sub path has already been cloned, i.e. whether one of its ancestor directories

      * was already cloned.

      *

      * @param subpath The sub path to check, must not be <code>null</code>.

      * @param clonedSubpaths The list of already cloned paths, must not be <code>null</code> nor contain

      *            <code>null</code> elements.

      * @return <code>true</code> if the specified path has already been cloned, <code>false</code> otherwise.

      */

     static boolean alreadyCloned( String subpath, List clonedSubpaths )

     {

         for ( Iterator iter = clonedSubpaths.iterator(); iter.hasNext(); )

         {

             String path = (String) iter.next();

             if ( ".".equals( path ) || subpath.equals( path ) || subpath.startsWith( path + File.separator ) )

             {

                 return true;

             }

         }

         return false;

     }

     /**

      * Runs the specified build jobs.

      *

      * @param projectsDir The base directory of all projects, must not be <code>null</code>.

      * @param buildJobs The build jobs to run must not be <code>null</code> nor contain <code>null</code> elements.

      * @throws org.apache.maven.plugin.MojoExecutionException If any build could not be launched.

      */

     private void runBuilds( File projectsDir, BuildJob[] buildJobs )

         throws MojoExecutionException

     {

         if ( !localRepositoryPath.exists() )

         {

             localRepositoryPath.mkdirs();

         }

         File interpolatedSettingsFile = null;

         if ( settingsFile != null )

         {

             if ( cloneProjectsTo != null )

             {

                 interpolatedSettingsFile = new File( cloneProjectsTo, "interpolated-" + settingsFile.getName() );

             }

             else

             {

                 interpolatedSettingsFile =

                     new File( settingsFile.getParentFile(), "interpolated-" + settingsFile.getName() );

             }

             buildInterpolatedFile( settingsFile, interpolatedSettingsFile );

         }

         try

         {

             for ( int i = 0; i < buildJobs.length; i++ )

             {

                 BuildJob project = buildJobs[i];

                 runBuild( projectsDir, project, interpolatedSettingsFile );

             }

         }

         finally

         {

             if ( interpolatedSettingsFile != null && cloneProjectsTo == null )

             {

                 interpolatedSettingsFile.delete();

             }

         }

     }

     /**

      * Runs the specified project.

      *

      * @param projectsDir The base directory of all projects, must not be <code>null</code>.

      * @param buildJob The build job to run, must not be <code>null</code>.

      * @param settingsFile The (already interpolated) user settings file for the build, may be <code>null</code> to use

      *            the current user settings.

      * @throws org.apache.maven.plugin.MojoExecutionException If the project could not be launched.

      */

     private void runBuild( File projectsDir, BuildJob buildJob, File settingsFile )

         throws MojoExecutionException

     {

         File pomFile = new File( projectsDir, buildJob.getProject() );

         File basedir;

         if ( pomFile.isDirectory() )

         {

             basedir = pomFile;

             pomFile = new File( basedir, "pom.xml" );

             if ( !pomFile.exists() )

             {

                 pomFile = null;

             }

             else

             {

                 buildJob.setProject( buildJob.getProject() + File.separator + "pom.xml" );

             }

         }

         else

         {

             basedir = pomFile.getParentFile();

         }

         getLog().info( "Building: " + buildJob.getProject() );

         File interpolatedPomFile = null;

         if ( pomFile != null )

         {

             if ( filteredPomPrefix != null )

             {

                 interpolatedPomFile = new File( basedir, filteredPomPrefix + pomFile.getName() );

                 buildInterpolatedFile( pomFile, interpolatedPomFile );

             }

             else

             {

                 interpolatedPomFile = pomFile;

             }

         }

         InvokerProperties invokerProperties = getInvokerProperties( basedir );

         // let's set what details we can

         buildJob.setName( invokerProperties.getJobName() );

         buildJob.setDescription( invokerProperties.getJobDescription() );

         try

         {

             if ( isSelected( invokerProperties ) )

             {

                 long milliseconds = System.currentTimeMillis();

                 boolean executed;

                 try

                 {

                     executed = runBuild( basedir, interpolatedPomFile, settingsFile, invokerProperties );

                 }

                 finally

                 {

                     milliseconds = System.currentTimeMillis() - milliseconds;

                     buildJob.setTime( milliseconds / 1000.0 );

                 }

                 if ( executed )

                 {

                     buildJob.setResult( BuildJob.Result.SUCCESS );

                     if ( !suppressSummaries )

                     {

                         getLog().info( "..SUCCESS " + formatTime( buildJob.getTime() ) );

                     }

                 }

                 else

                 {

                     buildJob.setResult( BuildJob.Result.SKIPPED );

                     if ( !suppressSummaries )

                     {

                         getLog().info( "..SKIPPED " + formatTime( buildJob.getTime() ) );

                     }

                 }

             }

             else

             {

                 buildJob.setResult( BuildJob.Result.SKIPPED );

                 if ( !suppressSummaries )

                 {

                     getLog().info( "..SKIPPED " );

                 }

             }

         }

         catch ( BuildErrorException e ) 

         {

             buildJob.setResult( BuildJob.Result.ERROR );

             buildJob.setFailureMessage( e.getMessage() );

             if ( !suppressSummaries )

             {

                 getLog().info( "..ERROR " + formatTime( buildJob.getTime() ) );

                 getLog().info( "  " + e.getMessage() );

             }

         }

         catch ( BuildFailureException e )

         {

             buildJob.setResult( e.getType() );

             buildJob.setFailureMessage( e.getMessage() );

             if ( !suppressSummaries )

             {

                 getLog().info( "..FAILED " + formatTime( buildJob.getTime() ) );

                 getLog().info( "  " + e.getMessage() );

             }

         }

         finally

         {

             if ( interpolatedPomFile != null && StringUtils.isNotEmpty( filteredPomPrefix ) )

             {

                 interpolatedPomFile.delete();

             }

             writeBuildReport( buildJob );

         }

     }

     /**

      * Determines whether selector conditions of the specified invoker properties match the current environment.

      * 

      * @param invokerProperties The invoker properties to check, must not be <code>null</code>.

      * @return <code>true</code> if the job corresponding to the properties should be run, <code>false</code> otherwise.

      */

     private boolean isSelected( InvokerProperties invokerProperties )

     {

         if ( !SelectorUtils.isMavenVersion( invokerProperties.getMavenVersion() ) )

         {

             return false;

         }

         if ( !SelectorUtils.isJreVersion( invokerProperties.getJreVersion() ) )

         {

             return false;

         }

         if ( !SelectorUtils.isOsFamily( invokerProperties.getOsFamily() ) )

         {

             return false;

         }

         return true;

     }

     /**

      * Writes the XML report for the specified build job unless report generation has been disabled.

      *

      * @param buildJob The build job whose report should be written, must not be <code>null</code>.

      * @throws org.apache.maven.plugin.MojoExecutionException If the report could not be written.

      */

     private void writeBuildReport( BuildJob buildJob )

         throws MojoExecutionException

     {

         if ( disableReports )

         {

             return;

         }

         if ( !reportsDirectory.exists() )

         {

             reportsDirectory.mkdirs();

         }

         String safeFileName = buildJob.getProject().replace( '/', '_' ).replace( '\\', '_' ).replace( ' ', '_' );

         if ( safeFileName.endsWith( "_pom.xml" ) )

         {

             safeFileName = safeFileName.substring( 0, safeFileName.length() - "_pom.xml".length() );

         }

         File reportFile = new File( reportsDirectory, "BUILD-" + safeFileName + ".xml" );

         try

         {

             FileOutputStream fos = new FileOutputStream( reportFile );

             try

             {

                 Writer osw = new OutputStreamWriter( fos, buildJob.getModelEncoding() );

                 BuildJobXpp3Writer writer = new BuildJobXpp3Writer();

                 writer.write( osw, buildJob );

                 osw.close();

             }

             finally

             {

                 fos.close();

             }

         }

         catch ( IOException e )

         {

             throw new MojoExecutionException( "Failed to write build report " + reportFile, e );

         }

     }

     /**

      * Formats the specified build duration time.

      *

      * @param seconds The duration of the build.

      * @return The formatted time, never <code>null</code>.

      */

     private String formatTime( double seconds )

     {

         return secFormat.format( seconds );

     }

     /**

      * Runs the specified project.

      *

      * @param basedir The base directory of the project, must not be <code>null</code>.

      * @param pomFile The (already interpolated) POM file, may be <code>null</code> for a POM-less Maven invocation.

      * @param settingsFile The (already interpolated) user settings file for the build, may be <code>null</code> to use

      *            the current user settings.

      * @param invokerProperties The properties to use.

      * @return <code>true</code> if the project was launched or <code>false</code> if the selector script indicated that

      *            the project should be skipped.

      * @throws org.apache.maven.plugin.MojoExecutionException If the project could not be launched.

      * @throws org.apache.maven.plugin.invoker.BuildFailureException If either a hook script or the build itself failed.

      */

     private boolean runBuild( File basedir, File pomFile, File settingsFile, InvokerProperties invokerProperties )

         throws MojoExecutionException, BuildFailureException

     {

         if ( getLog().isDebugEnabled() && !invokerProperties.getProperties().isEmpty() )

         {

             Properties props = invokerProperties.getProperties();

             getLog().debug( "Using invoker properties:" );

             for ( Iterator it = new TreeSet( props.keySet() ).iterator(); it.hasNext(); )

             {

                 String key = (String) it.next();

                 String value = props.getProperty( key );

                 getLog().debug( "  " + key + " = " + value );

             }

         }

         List goals = getGoals( basedir );

         List profiles = getProfiles( basedir );

         Map context = new LinkedHashMap();

         FileLogger logger = setupLogger( basedir );

         try

         {

             try

             {

                 scriptRunner.run( "selector script", basedir, selectorScript, context, logger,

                                   BuildJob.Result.SKIPPED, false );

             }

             catch ( BuildErrorException e ) 

             {

                 throw e;

             }

             catch ( BuildFailureException e )

             {

                 return false;

             }

             scriptRunner.run( "pre-build script", basedir, preBuildHookScript, context, logger,

                               BuildJob.Result.FAILURE_PRE_HOOK, false );

             final InvocationRequest request = new DefaultInvocationRequest();

             request.setLocalRepositoryDirectory( localRepositoryPath );

             request.setUserSettingsFile( settingsFile );

             request.setInteractive( false );

             request.setShowErrors( showErrors );

             request.setDebug( debug );

             request.setShowVersion( showVersion );

             if ( logger != null )

             {

                 request.setErrorHandler( logger );

                 request.setOutputHandler( logger );

             }

             if ( mavenHome != null )

             {

                 invoker.setMavenHome( mavenHome );

                 request.addShellEnvironment( "M2_HOME", mavenHome.getAbsolutePath() );

             }

             if ( javaHome != null )

             {

                 request.setJavaHome( javaHome );

             }

             for ( int invocationIndex = 1;; invocationIndex++ )

             {

                 if ( invocationIndex > 1 && !invokerProperties.isInvocationDefined( invocationIndex ) )

                 {

                     break;

                 }

                 request.setBaseDirectory( basedir );

                 request.setPomFile( pomFile );

                 request.setGoals( goals );

                 request.setProfiles( profiles );

                 request.setMavenOpts( mavenOpts );

                 request.setOffline( false );

                 Properties systemProperties =

                     getSystemProperties( basedir, invokerProperties.getSystemPropertiesFile( invocationIndex ) );

                 request.setProperties( systemProperties );

                 invokerProperties.configureInvocation( request, invocationIndex );

                 if ( getLog().isDebugEnabled() )

                 {

                     try

                     {

                         getLog().debug( "Using MAVEN_OPTS: " + request.getMavenOpts() );

                         getLog().debug( "Executing: " + new MavenCommandLineBuilder().build( request ) );

                     }

                     catch ( CommandLineConfigurationException e )

                     {

                         getLog().debug( "Failed to display command line: " + e.getMessage() );

                     }

                 }

                 InvocationResult result;

                 try

                 {

                     result = invoker.execute( request );

                 }

                 catch ( final MavenInvocationException e )

                 {

                     getLog().debug( "Error invoking Maven: " + e.getMessage(), e );

                     throw new BuildFailureException( "Maven invocation failed. " + e.getMessage(),

                                                      BuildJob.Result.FAILURE_BUILD );

                 }