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")