Log the creation of actually used FileSystemVoids #42

Signed-off-by: Mārtiņš Avots <martins.avots@splitcells.net>

Author: martins-avots

projects/net.splitcells.dem.api/CHANGELOG.md

@@ -5,6 +5,7 @@
 # Changelog
 ## [Unreleased]
 ### Major Changes
+* **2025-11-24\#37** Log the creation of actually used FileSystemVoids.
 * **2025-10-20\#37** Rename `List#forEachIndex` to `List#forEachIndexed`.
 * **2025-07-21\#37** Rename CsvDocument to CsvPrinter, as it is otherwise misleading and create a new CsvDocument class,
   that supports reading CSV contents for now.

projects/net.splitcells.dem.api/src/main/java/net/splitcells/dem/lang/tree/Tree.java

@@ -357,7 +357,7 @@ default void requireEqualsTo(Tree other) {
 
     default Tree withPath(Tree... path) {
         var current = this;
-        for (int i = 0 ; i < path.length ; ++i) {
+        for (int i = 0; i < path.length; ++i) {
             final var next = path[i];
             current.withChild(next);
             current = next;
@@ -1190,7 +1190,11 @@ default Merger merge(Merger merger) {
     }
 
     default Tree with(Throwable throwable) {
-        final var throwableTree = tree("throwable")
+        return with("throwable", throwable);
+    }
+
+    default Tree with(String description, Throwable throwable) {
+        final var throwableTree = tree(description)
                 .withChild(tree("message").withChild(tree(throwable.getMessage())))
                 .withChild(tree("stack-trace").withChild(tree(throwableToString(throwable))));
         return withChild(throwableTree);

projects/net.splitcells.dem.api/src/main/java/net/splitcells/dem/resource/FileSystemVoid.java

@@ -21,6 +21,7 @@
 
 import static net.splitcells.dem.resource.communication.log.Logs.logs;
 import static net.splitcells.dem.utils.BinaryUtils.emptyByteArray;
+import static net.splitcells.dem.utils.ExecutionException.execException;
 import static net.splitcells.dem.utils.NotImplementedYet.notImplementedYet;
 
 /**
@@ -33,14 +34,15 @@ public static FileSystem fileSystemVoid() {
     }
 
     private boolean isUsageWarned = false;
+    private Throwable creation = execException();
 
     private FileSystemVoid() {
 
     }
 
     private void warnUsage() {
         if (!isUsageWarned) {
-            logs().warnUnimplementedPart(FileSystemVoid.class);
+            logs().warnUnimplementedPart(FileSystemVoid.class, creation);
             isUsageWarned = true;
         }
     }

projects/net.splitcells.dem.api/src/main/java/net/splitcells/dem/resource/communication/log/Log.java

@@ -72,6 +72,20 @@ default Log warnUnimplementedPart(Class<?> clazz) {
         return this;
     }
 
+    /**
+     *
+     * @param clazz
+     * @param creation Provides the stacktrace, that points to the constructor call of {@code clazz}.
+     * @return
+     */
+    default Log warnUnimplementedPart(Class<?> clazz, Throwable creation) {
+        logs().append(tree("Unimplemented program part for class " + clazz + " at")
+                        .with("creation", creation)
+                        .with("current-execution", execException("current-execution"))
+                , LogLevel.WARNING);
+        return this;
+    }
+
     default Log warnUnimplementedPart() {
         logs().append("Unimplemented program part at:\n"
                         + throwableToString(ExecutionException.execException("no-message"))