Source::functionExplanation

Author: pmbittner

src/main/java/org/variantsync/diffdetective/util/Source.java

@@ -205,6 +205,28 @@ static String fullExplanation(Source source) {
         return result.toString();
     }
 
+    /**
+     * The same as {@link #fullExplanation(Source)} but with a different formatting.
+     * Where fullExplanation renders this tree of sources as using newlines and indentation,
+     * functionExplanation renders this tree as one large, nested function call of the form:
+     * {@link #getSourceExplanation()}({@link #getSourceArguments() args}..., {@link #getSources() nested sources}...).
+     */
+    default String functionExplanation() {
+        String result = getSourceExplanation() + "(";
+
+        final List<String> args = new ArrayList<>();
+        for (Object arg : getSourceArguments()) {
+            args.add(arg.toString());
+        }
+        for (Source child : getSources()) {
+            args.add(child.functionExplanation());
+        }
+
+        result += args.stream().collect(Collectors.joining(", "));
+
+        return result + ")";
+    }
+
     /**
      * Uses a depth first traversal of the {@link Source} {@link getSources hierarchy} to find and
      * return all instances of {@code clazz}.