This is an automated email from the ASF dual-hosted git repository.

gnodet pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven.git


The following commit(s) were added to refs/heads/master by this push:
     new e537e8be71 Deprecate update-snapshots in favor of update-all (#13871)
e537e8be71 is described below

commit e537e8be714a26f8883ba7056483ae8e2618bab5
Author: codewithsinchana <[email protected]>
AuthorDate: Mon Nov 9 22:24:24 2026 +0530

    Deprecate update-snapshots in favor of update-all (#13871)
    
    Co-authored-by: codewithsinchana <[email protected]>
---
 .../main/java/org/apache/maven/cli/CLIManager.java | 25 +++++++++++++++++++---
 .../main/java/org/apache/maven/cli/MavenCli.java   |  3 ++-
 .../cling/invoker/mvn/CommonsCliMavenOptions.java  | 21 ++++++++++++++----
 3 files changed, 41 insertions(+), 8 deletions(-)

diff --git 
a/compat/maven-embedder/src/main/java/org/apache/maven/cli/CLIManager.java 
b/compat/maven-embedder/src/main/java/org/apache/maven/cli/CLIManager.java
index d1429ec921..1c970cd8d7 100644
--- a/compat/maven-embedder/src/main/java/org/apache/maven/cli/CLIManager.java
+++ b/compat/maven-embedder/src/main/java/org/apache/maven/cli/CLIManager.java
@@ -69,7 +69,11 @@ public class CLIManager {
 
     public static final char NON_RECURSIVE = 'N';
 
-    public static final char UPDATE_SNAPSHOTS = 'U';
+    public static final char UPDATE_ALL = 'U';
+
+    /** @deprecated Use {@link #UPDATE_ALL} instead. */
+    @Deprecated
+    public static final char UPDATE_SNAPSHOTS = UPDATE_ALL;
 
     public static final char ACTIVATE_PROFILES = 'P';
 
@@ -191,10 +195,25 @@ public CLIManager() {
                 .desc(
                         "Do not recurse into sub-projects. When used together 
with -pl, do not recurse into sub-projects of selected aggregators")
                 .build());
-        options.addOption(Option.builder(Character.toString(UPDATE_SNAPSHOTS))
+
+        // -U is the short form of --update-all.
+        options.addOption(Option.builder(Character.toString(UPDATE_ALL))
+                .longOpt("update-all")
+                .desc(
+                        "Shortcut for --update-metadata --update-artifacts: 
forces updates of metadata and artifacts on remote repositories")
+                .build());
+
+        // Keep the old option as a deprecated alias for backwards 
compatibility.
+        options.addOption(Option.builder()
                 .longOpt("update-snapshots")
-                .desc("Forces a check for missing releases and updated 
snapshots on remote repositories")
+                .desc("<deprecated> Use -U,--update-all instead.")
+                .deprecated(DeprecatedAttributes.builder()
+                        .setForRemoval(true)
+                        .setSince("4.2.0")
+                        .setDescription("Use -U,--update-all instead.")
+                        .get())
                 .build());
+
         options.addOption(Option.builder(Character.toString(ACTIVATE_PROFILES))
                 .longOpt("activate-profiles")
                 .desc(
diff --git 
a/compat/maven-embedder/src/main/java/org/apache/maven/cli/MavenCli.java 
b/compat/maven-embedder/src/main/java/org/apache/maven/cli/MavenCli.java
index 573f3d3806..0ff31d7683 100644
--- a/compat/maven-embedder/src/main/java/org/apache/maven/cli/MavenCli.java
+++ b/compat/maven-embedder/src/main/java/org/apache/maven/cli/MavenCli.java
@@ -1437,7 +1437,8 @@ private MavenExecutionRequest populateRequest(CliRequest 
cliRequest, MavenExecut
         
request.setReactorFailureBehavior(determineReactorFailureBehaviour(commandLine));
         disableOnPresentOption(commandLine, CLIManager.NON_RECURSIVE, 
request::setRecursive);
         enableOnPresentOption(commandLine, CLIManager.OFFLINE, 
request::setOffline);
-        enableOnPresentOption(commandLine, CLIManager.UPDATE_SNAPSHOTS, 
request::setUpdateSnapshots);
+        enableOnPresentOption(commandLine, CLIManager.UPDATE_ALL, 
request::setUpdateSnapshots);
+        enableOnPresentOption(commandLine, "update-snapshots", 
request::setUpdateSnapshots);
         
request.setGlobalChecksumPolicy(determineGlobalCheckPolicy(commandLine));
 
         // Update policy options
diff --git 
a/impl/maven-cli/src/main/java/org/apache/maven/cling/invoker/mvn/CommonsCliMavenOptions.java
 
b/impl/maven-cli/src/main/java/org/apache/maven/cling/invoker/mvn/CommonsCliMavenOptions.java
index 96a7e1a10d..f3862761ea 100644
--- 
a/impl/maven-cli/src/main/java/org/apache/maven/cling/invoker/mvn/CommonsCliMavenOptions.java
+++ 
b/impl/maven-cli/src/main/java/org/apache/maven/cling/invoker/mvn/CommonsCliMavenOptions.java
@@ -23,6 +23,7 @@
 import java.util.Optional;
 
 import org.apache.commons.cli.CommandLine;
+import org.apache.commons.cli.DeprecatedAttributes;
 import org.apache.commons.cli.Option;
 import org.apache.commons.cli.ParseException;
 import org.apache.maven.api.cli.mvn.MavenOptions;
@@ -57,7 +58,7 @@ public Optional<Boolean> nonRecursive() {
 
     @Override
     public Optional<Boolean> updateSnapshots() {
-        if (commandLine.hasOption(CLIManager.UPDATE_SNAPSHOTS)) {
+        if (commandLine.hasOption(CLIManager.UPDATE_ALL) || 
commandLine.hasOption("update-snapshots")) {
             return Optional.of(Boolean.TRUE);
         }
         return Optional.empty();
@@ -255,7 +256,7 @@ protected CommonsCliMavenOptions copy(
     protected static class CLIManager extends CommonsCliOptions.CLIManager {
         public static final String ALTERNATE_POM_FILE = "f";
         public static final String NON_RECURSIVE = "N";
-        public static final String UPDATE_SNAPSHOTS = "U";
+        public static final String UPDATE_ALL = "U";
         public static final String ACTIVATE_PROFILES = "P";
         public static final String SUPPRESS_SNAPSHOT_UPDATES = "nsu";
         public static final String CHECKSUM_FAILURE_POLICY = "C";
@@ -293,9 +294,21 @@ protected void 
prepareOptions(org.apache.commons.cli.Options options) {
                     .desc(
                             "Do not recurse into sub-projects. When used 
together with -pl, do not recurse into sub-projects of selected aggregators")
                     .get());
-            options.addOption(Option.builder(UPDATE_SNAPSHOTS)
+            options.addOption(Option.builder(UPDATE_ALL)
+                    .longOpt("update-all")
+                    .desc(
+                            "Shortcut for --update-metadata 
--update-artifacts: forces updates of metadata and artifacts on remote 
repositories")
+                    .get());
+
+            // Keep the old option as a deprecated alias for backwards 
compatibility.
+            options.addOption(Option.builder()
                     .longOpt("update-snapshots")
-                    .desc("Forces a check for missing releases and updated 
snapshots on remote repositories")
+                    .desc("<deprecated> Use -U,--update-all instead.")
+                    .deprecated(DeprecatedAttributes.builder()
+                            .setForRemoval(true)
+                            .setSince("4.2.0")
+                            .setDescription("Use -U,--update-all instead.")
+                            .get())
                     .get());
             options.addOption(Option.builder(ACTIVATE_PROFILES)
                     .longOpt("activate-profiles")

Reply via email to