1 files changed, 44 insertions, 0 deletions

diff --git a/buildSrc/src/main/java/tools/refinery/gradle/utils/SonarPropertiesUtils.java b/buildSrc/src/main/java/tools/refinery/gradle/utils/SonarPropertiesUtils.java
new file mode 100644
index 00000000..3810fccf
--- /dev/null
+++ b/buildSrc/src/main/java/tools/refinery/gradle/utils/SonarPropertiesUtils.java
@@ -0,0 +1,44 @@
+package tools.refinery.gradle.utils;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Map;
+
+public final class SonarPropertiesUtils {
+        private SonarPropertiesUtils() {
+                throw new IllegalStateException("This is a static utility class and should not be instantiated directly");
+        }
+
+        /**
+         * Adds the entries to a Sonar property of list type.
+         * <p>
+         * According to the Sonar Gradle documentation for {@link org.sonarqube.gradle.SonarProperties}, property values
+         * are converted to Strings as follows:
+         * <ul>
+         * <li>{@code Iterable}s are recursively converted and joined into a comma-separated String.</li>
+         * <li>All other values are converted to Strings by calling their {@code toString()} method.</li>
+         * </ul>
+         * Therefore, we use {@link ArrayList} to retain lists entries, which will be recursively converted later.
+         *
+         * @param properties   The sonar properties map returned by
+         *                     {@link org.sonarqube.gradle.SonarProperties#getProperties()}.
+         * @param propertyName The name of the property to append to.
+         * @param entries      The entries to append.
+         */
+        public static void addToList(Map<String, Object> properties, String propertyName, String... entries) {
+                ArrayList<Object> newValue;
+                var currentValue = properties.get(propertyName);
+                if (currentValue instanceof ArrayList<?> currentList) {
+                        @SuppressWarnings("unchecked")
+                        var objectList = (ArrayList<Object>) currentList;
+                        newValue = objectList;
+                } else if (currentValue == null) {
+                        newValue = new ArrayList<>(entries.length);
+                } else {
+                        newValue = new ArrayList<>(entries.length + 1);
+                        newValue.add(currentValue);
+                }
+                Collections.addAll(newValue, entries);
+                properties.put(propertyName, newValue);
+        }
+}