Simplify the JctFileManagerImpl class into a separate repository (#287)

This splits up the file manager system into smaller components to reduce
complexity of each
class.

There is now a separate repository mediator class, and module discovery
is performed in a utility class in the utils package instead, enabling
reuse and easier ability to swap out the existing implementation with
new logic in the future, should it be needed. This also makes it easier
to stub module detection in tests by using MockedStatic in Mockito

Author: ascopes

java-compiler-testing/src/main/java/io/github/ascopes/jct/containers/impl/ContainerGroupRepositoryImpl.java

@@ -50,6 +50,11 @@ public final class TeeWriter extends Writer {
   // and the delegated output writer at the same time.
   private final StringBuilder builder;
 
+  /**
+   * Initialise the writer.
+   *
+   * @param writer the underlying writer to "tee" to.
+   */
   public TeeWriter(@WillCloseWhenClosed Writer writer) {
     lock = new Object();
     closed = false;

java-compiler-testing/src/main/java/io/github/ascopes/jct/diagnostics/TeeWriter.java

@@ -75,7 +75,7 @@ public interface JctFileManager extends JavaFileManager {
    *
    * @param location the location to apply an empty container for.
    */
-  void ensureEmptyLocationExists(Location location);
+  void createEmptyLocation(Location location);
 
   /**
    * Get the container group for the given package-oriented location.

java-compiler-testing/src/main/java/io/github/ascopes/jct/filemanagers/JctFileManager.java

@@ -75,7 +75,7 @@ public JctFileManager configure(@WillNotClose JctFileManager fileManager) {
       case ENABLED:
         LOGGER.trace("Annotation processor discovery is enabled, ensuring empty location exists");
 
-        INHERITED_AP_PATHS.values().forEach(fileManager::ensureEmptyLocationExists);
+        INHERITED_AP_PATHS.values().forEach(fileManager::createEmptyLocation);
 
         return fileManager;
 
@@ -84,7 +84,7 @@ public JctFileManager configure(@WillNotClose JctFileManager fileManager) {
             + "into the annotation processor path");
 
         INHERITED_AP_PATHS.forEach(fileManager::copyContainers);
-        INHERITED_AP_PATHS.values().forEach(fileManager::ensureEmptyLocationExists);
+        INHERITED_AP_PATHS.values().forEach(fileManager::createEmptyLocation);
 
         return fileManager;