You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by sl...@apache.org on 2026/09/10 07:46:07 UTC
(maven-shared-utils) branch agent/deprecate-logging updated (b9c4a0c -> e729265)
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a change to branch agent/deprecate-logging
in repository https://gitbox.apache.org/repos/asf/maven-shared-utils.git
discard b9c4a0c Deprecate the logging package in favor of MessageBuilderFactory
add f47d128 Fix stale cross-drive assertion left by merging #384 after #403
new e729265 Deprecate the logging package in favor of MessageBuilderFactory
This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version. This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:
* -- * -- B -- O -- O -- O (b9c4a0c)
\
N -- N -- N refs/heads/agent/deprecate-logging (e729265)
You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.
Any revisions marked "omit" are not gone; other references still
refer to them. Any revisions marked "discard" are gone forever.
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
src/test/java/org/apache/maven/shared/utils/PathToolTest.java | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
(maven-shared-utils) 01/01: Deprecate the logging package in favor of MessageBuilderFactory
Posted by sl...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch agent/deprecate-logging
in repository https://gitbox.apache.org/repos/asf/maven-shared-utils.git
commit e729265dff352f4006e4c1553dd7e79db99b6391
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Wed Sep 9 21:34:25 2026 +0200
Deprecate the logging package in favor of MessageBuilderFactory
Maven 3.10.0 introduces org.apache.maven.message.MessageBuilderFactory,
and Maven 4 org.apache.maven.api.services.MessageBuilderFactory, which
supersede this package.
This is the outcome of the review on #377, which proposed swapping Jansi
for org.jline:jansi here. That swap was rejected: Maven exports this
package up to 3.9.x and many plugins compile against it, so changing the
ANSI provider underneath them is not safe. Deprecation is the agreed
route instead.
The package-private implementations are marked too, so implementing a
deprecated interface does not warn.
---
.../org/apache/maven/shared/utils/logging/AnsiMessageBuilder.java | 4 ++++
.../org/apache/maven/shared/utils/logging/LoggerLevelRenderer.java | 3 +++
.../java/org/apache/maven/shared/utils/logging/MessageBuilder.java | 3 +++
src/main/java/org/apache/maven/shared/utils/logging/MessageUtils.java | 3 +++
.../org/apache/maven/shared/utils/logging/PlainMessageBuilder.java | 4 ++++
src/main/java/org/apache/maven/shared/utils/logging/Style.java | 3 +++
6 files changed, 20 insertions(+)
diff --git a/src/main/java/org/apache/maven/shared/utils/logging/AnsiMessageBuilder.java b/src/main/java/org/apache/maven/shared/utils/logging/AnsiMessageBuilder.java
index ddb9ab7..c7796e8 100644
--- a/src/main/java/org/apache/maven/shared/utils/logging/AnsiMessageBuilder.java
+++ b/src/main/java/org/apache/maven/shared/utils/logging/AnsiMessageBuilder.java
@@ -23,7 +23,11 @@ import org.fusesource.jansi.Ansi;
/**
* Message builder implementation that supports ANSI colors through
* <a href="http://fusesource.github.io/jansi/">Jansi</a> with configurable styles through {@link Style}.
+ *
+ * @deprecated use {@code org.apache.maven.message.MessageBuilderFactory} (Maven 3.10.0 and later)
+ * or {@code org.apache.maven.api.services.MessageBuilderFactory} (Maven 4) instead
*/
+@Deprecated
class AnsiMessageBuilder implements MessageBuilder, LoggerLevelRenderer {
private Ansi ansi;
diff --git a/src/main/java/org/apache/maven/shared/utils/logging/LoggerLevelRenderer.java b/src/main/java/org/apache/maven/shared/utils/logging/LoggerLevelRenderer.java
index 410301c..d0d3719 100644
--- a/src/main/java/org/apache/maven/shared/utils/logging/LoggerLevelRenderer.java
+++ b/src/main/java/org/apache/maven/shared/utils/logging/LoggerLevelRenderer.java
@@ -23,7 +23,10 @@ package org.apache.maven.shared.utils.logging;
* logger level.
*
* @since 3.2.0
+ * @deprecated use {@code org.apache.maven.message.MessageBuilderFactory} (Maven 3.10.0 and later)
+ * or {@code org.apache.maven.api.services.MessageBuilderFactory} (Maven 4) instead
*/
+@Deprecated
public interface LoggerLevelRenderer {
/**
* Render a message at DEBUG level.
diff --git a/src/main/java/org/apache/maven/shared/utils/logging/MessageBuilder.java b/src/main/java/org/apache/maven/shared/utils/logging/MessageBuilder.java
index 4ff6c9e..59eb269 100644
--- a/src/main/java/org/apache/maven/shared/utils/logging/MessageBuilder.java
+++ b/src/main/java/org/apache/maven/shared/utils/logging/MessageBuilder.java
@@ -28,7 +28,10 @@ import java.util.Formatter;
*
* @see MessageUtils
* @since 3.1.0
+ * @deprecated use {@code org.apache.maven.message.MessageBuilderFactory} (Maven 3.10.0 and later)
+ * or {@code org.apache.maven.api.services.MessageBuilderFactory} (Maven 4) instead
*/
+@Deprecated
public interface MessageBuilder {
/**
* Append message content in success style.
diff --git a/src/main/java/org/apache/maven/shared/utils/logging/MessageUtils.java b/src/main/java/org/apache/maven/shared/utils/logging/MessageUtils.java
index 7c32cac..0cd4e11 100644
--- a/src/main/java/org/apache/maven/shared/utils/logging/MessageUtils.java
+++ b/src/main/java/org/apache/maven/shared/utils/logging/MessageUtils.java
@@ -30,7 +30,10 @@ import org.fusesource.jansi.AnsiMode;
* <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#Colors">ANSI colors</a> on any platform.
*
* @since 3.1.0
+ * @deprecated use {@code org.apache.maven.message.MessageBuilderFactory} (Maven 3.10.0 and later)
+ * or {@code org.apache.maven.api.services.MessageBuilderFactory} (Maven 4) instead
*/
+@Deprecated
public class MessageUtils {
private static final boolean JANSI;
diff --git a/src/main/java/org/apache/maven/shared/utils/logging/PlainMessageBuilder.java b/src/main/java/org/apache/maven/shared/utils/logging/PlainMessageBuilder.java
index d13e25e..d6c37ee 100644
--- a/src/main/java/org/apache/maven/shared/utils/logging/PlainMessageBuilder.java
+++ b/src/main/java/org/apache/maven/shared/utils/logging/PlainMessageBuilder.java
@@ -20,7 +20,11 @@ package org.apache.maven.shared.utils.logging;
/**
* Message builder implementation that just ignores styling, for Maven version earlier than 3.5.0.
+ *
+ * @deprecated use {@code org.apache.maven.message.MessageBuilderFactory} (Maven 3.10.0 and later)
+ * or {@code org.apache.maven.api.services.MessageBuilderFactory} (Maven 4) instead
*/
+@Deprecated
class PlainMessageBuilder implements MessageBuilder, LoggerLevelRenderer {
private StringBuilder buffer;
diff --git a/src/main/java/org/apache/maven/shared/utils/logging/Style.java b/src/main/java/org/apache/maven/shared/utils/logging/Style.java
index 536c482..c18086f 100644
--- a/src/main/java/org/apache/maven/shared/utils/logging/Style.java
+++ b/src/main/java/org/apache/maven/shared/utils/logging/Style.java
@@ -27,7 +27,10 @@ import org.fusesource.jansi.Ansi.Color;
* Configurable message styles.
*
* @since 3.1.0
+ * @deprecated use {@code org.apache.maven.message.MessageBuilderFactory} (Maven 3.10.0 and later)
+ * or {@code org.apache.maven.api.services.MessageBuilderFactory} (Maven 4) instead
*/
+@Deprecated
enum Style {
DEBUG("bold,cyan"),
INFO("bold,blue"),