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:45:39 UTC
(maven-shared-utils) branch agent/deprecate-logging created (now b9c4a0c)
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
at b9c4a0c Deprecate the logging package in favor of MessageBuilderFactory
This branch includes the following new commits:
new b9c4a0c Deprecate the logging package in favor of MessageBuilderFactory
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.
(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 b9c4a0c5adfcb8ac7cd62eaf0737577ec129a1d6
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"),