All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.telenav.cactus.maven.HomogenizeVersionsMojo Maven / Gradle / Ivy

There is a newer version: 1.5.49
Show newest version
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
//
// © 2011-2022 Telenav, Inc.
//
// Licensed 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
//
// https://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 com.telenav.cactus.maven;

import com.mastfrog.function.optional.ThrowingOptional;
import com.telenav.cactus.git.GitCheckout;
import com.telenav.cactus.maven.commit.CommitMessage;
import com.telenav.cactus.maven.common.CactusCommonPropertyNames;
import com.telenav.cactus.maven.log.BuildLog;
import com.telenav.cactus.maven.model.ArtifactIdentifiers;
import com.telenav.cactus.maven.model.ParentMavenCoordinates;
import com.telenav.cactus.maven.model.Pom;
import com.telenav.cactus.maven.model.PomVersion;
import com.telenav.cactus.maven.model.internal.PomFile;
import com.telenav.cactus.maven.model.resolver.Poms;
import com.telenav.cactus.maven.mojobase.BaseMojoGoal;
import com.telenav.cactus.maven.mojobase.SharedProjectTreeMojo;
import com.telenav.cactus.maven.refactoring.PropertyHomogenizer;
import com.telenav.cactus.maven.topologize.Topologizer;
import com.telenav.cactus.maven.tree.ProjectTree;
import com.telenav.cactus.maven.xml.AbstractXMLUpdater;
import com.telenav.cactus.maven.xml.XMLFile;
import com.telenav.cactus.maven.xml.XMLTextContentReplacement;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.HashSet;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import org.apache.maven.plugins.annotations.Parameter;
import org.apache.maven.project.MavenProject;
import org.w3c.dom.Document;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

import static com.telenav.cactus.maven.trigger.RunPolicies.FIRST;
import static com.telenav.cactus.maven.xml.AbstractXMLUpdater.applyAll;
import static org.apache.maven.plugins.annotations.InstantiationStrategy.SINGLETON;
import static org.apache.maven.plugins.annotations.LifecyclePhase.VALIDATE;
import static org.apache.maven.plugins.annotations.ResolutionScope.NONE;

/**
 * A project tree with multiple families may develop a variety of divergent
 * version properties for the same thing. This mojo will simply find all such
 * properties (for property names that indicate a version of a project or family
 * in the tree), and sets them to the greatest value found.
 *
 * @author Tim Boudreau
 */
@org.apache.maven.plugins.annotations.Mojo(
        defaultPhase = VALIDATE,
        requiresDependencyResolution = NONE,
        instantiationStrategy = SINGLETON,
        name = "homogenize-versions", threadSafe = true)
@BaseMojoGoal("homogenize-versions")
public class HomogenizeVersionsMojo extends SharedProjectTreeMojo
{
    @Parameter(property = "cactus.topologically-sort-modules",
            defaultValue = "false")
    private boolean topoSortModules;

    @Parameter(property = CactusCommonPropertyNames.COMMIT_CHANGES,
            defaultValue = "false")
    private boolean commit;

    public HomogenizeVersionsMojo()
    {
        super(FIRST);
    }

    @Override
    protected void performTasks(BuildLog log, MavenProject project) throws Exception
    {
        withProjectTree(tree ->
        {
            if (commit)
            {
                checkDirty(tree);
            }
            PropertyHomogenizer ph = new PropertyHomogenizer(new Poms(tree
                    .allProjects()));
            if (isPretend())
            {
                ph.pretend();
            }
            Set updated = new HashSet<>(ph.go(log::info));
            fixParentVersions(tree, log, updated);
            if (updated.isEmpty())
            {
                log.info("No inconsistent properties found.");
            }
            else
            {
                log.info("Updated " + updated.size() + " pom files.");
                if (commit)
                {
                    commit(tree, updated, log);
                }
            }
            tree.invalidateCache();
        });
    }

    private void commit(ProjectTree tree, Set updated, BuildLog log)
    {
        Set modifiedCheckouts = new HashSet<>();
        for (Path p : updated)
        {
            GitCheckout.checkout(p).ifPresent(checkout ->
            {
                boolean dirty = tree.isSubmoduleRoot(checkout)
                                ? tree.isDirtyIgnoringSubmoduleCommits(checkout)
                                : tree.isDirty(checkout);
                if (dirty)
                {
                    modifiedCheckouts.add(checkout);
                }
            });
        }
        List traverse = new ArrayList<>(modifiedCheckouts);
        GitCheckout.depthFirstSort(traverse);
        if (!modifiedCheckouts.isEmpty())
        {
            CommitMessage msg = new CommitMessage(getClass(),
                    "Updated " + updated.size()
                    + " in homogenize-versions pass.");
            CommitMessage.Section sect = msg.section("Checkouts");
            traverse.forEach(checkout ->
            {
                sect.bulletPoint(checkout.loggingName());
            });
            CommitMessage.Section files = msg.section("Files");
            Path rootPath = tree.root().checkoutRoot();
            updated.forEach(path ->
            {
                files.bulletPoint(rootPath.relativize(path));
            });

            String message = msg.toString();
            if (isVerbose())
            {
                System.out.println(message);
            }
            for (GitCheckout co : traverse)
            {
                ifNotPretending(() ->
                {
                    co.addAll();
                    co.commit(message);
                });
                log.info("Committed " + co.loggingName());
                emitMessage("Committed " + co.loggingName());
            }
        }
    }

    private void checkDirty(ProjectTree tree)
    {
        StringBuilder dirtyMessage = new StringBuilder();
        tree.allCheckouts().forEach(checkout ->
        {
            boolean dirty = tree.isSubmoduleRoot(checkout)
                            ? tree.isDirtyIgnoringSubmoduleCommits(checkout)
                            : tree.isDirty(checkout);
            if (dirty)
            {
                if (dirtyMessage.length() > 0)
                {
                    dirtyMessage.append(", ");
                }
                dirtyMessage.append(checkout.loggingName());
            }
        });
        if (dirtyMessage.length() > 0)
        {
            dirtyMessage.insert(0, "Some checkouts contain modifications. "
                    + "Will not generate a commit if it could include unrelated changes. "
                    + "The following checkouts are dirty: ");
        }
    }

    private void fixParentVersions(ProjectTree tree, BuildLog log,
            Set paths) throws Exception
    {
        Map pomForIds = new HashMap<>();
        Map parentForPom = new HashMap<>();
        Map fullParentForPom = new HashMap<>();
        tree.allProjects().forEach(pom ->
        {
            pomForIds.put(pom.toArtifactIdentifiers(), pom);
            pom.parent().ifPresent(par ->
            {
                ArtifactIdentifiers parentIds = par.toArtifactIdentifiers();
                parentForPom.put(pom, parentIds);
                fullParentForPom.put(pom, par);
            });
        });

        Map newVersionForPom = new HashMap<>();
        Set replacers = new LinkedHashSet<>();
        parentForPom.forEach((pom, parentId) ->
        {
            Pom parentPom = pomForIds.get(parentId);
            ParentMavenCoordinates parent = fullParentForPom.get(pom);
            if (!parentPom.version().equals(parent.version()))
            {
                log.info("Inconsistent parent version in " + pom.artifactId()
                        + " should be " + parentPom.version() + " but is "
                        + parent.version());
                newVersionForPom.put(pom, parent.version());
                PomFile file = PomFile.of(pom);
                XMLTextContentReplacement replacement = new XMLTextContentReplacement(
                        file,
                        "/project/parent/version", parentPom.version().text());
                replacers.add(replacement);
            }
        });
        if (replacers.isEmpty())
        {
            log.info("No parent version updates needed.");
        }

        if (topoSortModules)
        {
            Topologizer topo = new Topologizer(tree.root(), log);
            for (Pom pom : topo.poms())
            {
                if (pom.isAggregator())
                {
                    List sortedModuleNames = topo
                            .topologicallySortedModules(pom);
                    log.info("Will replace module list in " + pom.artifactId());
                    replacers.add(new ModuleListReplacer(PomFile.of(pom),
                            sortedModuleNames));
                }
            }
        }

        applyAll(replacers, isPretend(),
                this::emitMessage);
        for (AbstractXMLUpdater r : replacers)
        {
            paths.add(r.path());
        }
    }

    private static final class ModuleListReplacer extends AbstractXMLUpdater
    {
        private final List newModuleList;

        ModuleListReplacer(XMLFile in, List newModuleList)
        {
            super(in);
            this.newModuleList = newModuleList;
        }

        @Override
        public Document replace() throws Exception
        {
            return in.inContext(doc ->
            {
                ThrowingOptional list = in.nodesQuery(
                        "/project/modules/module");
                if (!list.isPresent())
                {
                    return null;
                }
                NodeList nl = list.get();
                for (int i = 0; i < nl.getLength(); i++)
                {
                    String newText = newModuleList.get(i);
                    Node n = nl.item(i);
                    n.setTextContent(newText);
                }
                return doc;
            });
        }

    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy