feat: implement a method to delete a directory from a template.

driver/src/main/java/eu/cloudnetservice/driver/template/TemplateStorage.java

@@ -220,6 +220,17 @@ default boolean deployDirectory(@NonNull ServiceTemplate target, @NonNull Path d
    */
   boolean deleteFile(@NonNull ServiceTemplate template, @NonNull String path);
 
+  /**
+   * Deletes the given directory at the given path in the given template in this storage.
+   * This method recursively deletes all files and directories inside the given directory.
+   *
+   * @param template the template in which the directory to delete is located in.
+   * @param path     the path to the directory in the template to delete.
+   * @return         true if the directory at the given path was deleted successfully, false otherwise.
+   * @throws NullPointerException if the given template or path is null.
+   */
+  boolean deleteDirectory(@NonNull ServiceTemplate template, @NonNull String path);
+
   /**
    * Opens a new input stream to read the content of the file at the given path in the given template in this storage.
    * This method returns null if either the file doesn't exist or is a directory.
@@ -480,6 +491,19 @@ default boolean deployDirectory(@NonNull ServiceTemplate target, @NonNull Path d
     return Task.supply(() -> this.deleteFile(template, path));
   }
 
+  /**
+   * Deletes the given directory at the given path in the given template in this storage. This method recursively
+   * deletes all files and directories inside the given directory.
+   *
+   * @param template the template in which the directory to delete is located in.
+   * @param path     the path to the directory in the template to delete.
+   * @return a task completed with true if the directory at the given path was deleted successfully, false otherwise.
+   * @throws NullPointerException if the given template or path is null.
+   */
+  default @NonNull Task<Boolean> deleteDirectoryAsync(@NonNull ServiceTemplate template, @NonNull String path) {
+    return Task.supply(() -> this.deleteDirectory(template, path));
+  }
+
   /**
    * Opens a new input stream to read the content of the file at the given path in the given template in this storage.
    * This method returns null if either the file doesn't exist or is a directory.

modules/rest/src/main/java/eu/cloudnetservice/modules/rest/v2/V2HttpHandlerTemplate.java

@@ -238,6 +238,25 @@ private void handleFileDeleteRequest(
     });
   }
 
+  @BearerAuth
+  @HttpRequestHandler(paths = "/api/v2/template/{storage}/{prefix}/{name}/directory", methods = "DELETE")
+  private void handleDirectoryDeleteRequest(
+    @NonNull HttpContext context,
+    @NonNull @RequestPathParam("storage") String storageName,
+    @NonNull @RequestPathParam("prefix") String prefix,
+    @NonNull @RequestPathParam("name") String templateName,
+    @NonNull @FirstRequestQueryParam("path") String path
+  ) {
+    this.handleWithTemplateContext(context, storageName, prefix, templateName, (template, storage) -> {
+      var status = storage.deleteDirectory(template, path);
+      this.ok(context)
+        .body(status ? this.success().toString() : this.failure().toString())
+        .context()
+        .closeAfter(true)
+        .cancelNext(true);
+    });
+  }
+
   @BearerAuth
   @HttpRequestHandler(paths = "/api/v2/template/{storage}/{prefix}/{name}", methods = "DELETE")
   private void handleTemplateDeleteRequest(

modules/rest/src/main/resources/documentation/swagger.json

@@ -3235,6 +3235,55 @@
         }
       }
     },
+    "/template/{storage}/{prefix}/{name}/directory" : {
+      "delete" : {
+        "parameters" : [ {
+          "name" : "storage",
+          "in" : "path",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "name" : "prefix",
+          "in" : "path",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "name" : "name",
+          "in" : "path",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "name" : "path",
+          "in" : "query",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "tags" : [ "Templates" ],
+        "summary" : "Deletes a directory and all its contents recursively from a template",
+        "responses" : {
+          "200" : {
+            "$ref" : "#/components/responses/Success"
+          },
+          "400" : {
+            "$ref" : "#/components/responses/BadRequest"
+          },
+          "401" : {
+            "$ref" : "#/components/responses/Unauthorized"
+          },
+          "403" : {
+            "$ref" : "#/components/responses/Forbidden"
+          }
+        }
+      }
+    },
     "/serviceversion" : {
       "get" : {
         "tags" : [ "Service Versions" ],

modules/storage-s3/src/main/java/eu/cloudnetservice/modules/s3/S3TemplateStorage.java

@@ -349,6 +349,29 @@ public boolean deleteFile(@NonNull ServiceTemplate template, @NonNull String pat
     }
   }
 
+  @Override
+  public boolean deleteDirectory(@NonNull ServiceTemplate template, @NonNull String path) {
+    try {
+      // get the contents we want to delete
+      Set<ObjectIdentifier> toDelete = new HashSet<>();
+      this.listAllObjects(
+        this.getBucketPath(template, path),
+        null,
+        object -> toDelete.add(ObjectIdentifier.builder().key(object.key()).build()));
+
+      // build the delete request
+      var deleteRequest = DeleteObjectsRequest.builder()
+        .bucket(this.config().bucket())
+        .delete(Delete.builder().quiet(true).objects(toDelete).build())
+        .build();
+      this.client.deleteObjects(deleteRequest);
+      // success
+      return true;
+    } catch (Exception exception) {
+      return false;
+    }
+  }
+
   @Override
   public @Nullable InputStream newInputStream(@NonNull ServiceTemplate template, @NonNull String path) {
     try {

modules/storage-s3/src/test/java/eu/cloudnetservice/modules/s3/S3TemplateStorageTest.java

@@ -201,4 +201,15 @@ void testTemplateDelete() {
     Assertions.assertFalse(storage.contains(TEMPLATE));
     Assertions.assertFalse(storage.hasFile(TEMPLATE, "test.txt"));
   }
+
+  @Test
+  @Order(120)
+  void testDeleteDirectory() {
+    var directory = "hello";
+    Assertions.assertTrue(storage.createDirectory(TEMPLATE, directory));
+    Assertions.assertTrue(storage.createFile(TEMPLATE, directory + "/test.txt"));
+    Assertions.assertTrue(storage.hasFile(TEMPLATE, directory + "/test.txt"));
+    Assertions.assertTrue(storage.deleteDirectory(TEMPLATE, directory));
+    Assertions.assertFalse(storage.hasFile(TEMPLATE, directory + "/test.txt"));
+  }
 }

modules/storage-sftp/src/main/java/eu/cloudnetservice/modules/sftp/SFTPTemplateStorage.java

@@ -273,6 +273,14 @@ public boolean deleteFile(@NonNull ServiceTemplate template, @NonNull String pat
     }, false);
   }
 
+  @Override
+  public boolean deleteDirectory(@NonNull ServiceTemplate template, @NonNull String path) {
+    return this.executeWithClient(client -> {
+      this.deleteDir(client, this.constructRemotePath(template, path));
+      return true;
+    }, false);
+  }
+
   @Override
   public @Nullable InputStream newInputStream(@NonNull ServiceTemplate st, @NonNull String path) throws IOException {
     var client = this.pool.takeClient();

modules/storage-sftp/src/test/java/eu/cloudnetservice/modules/sftp/SFTPTemplateStorageTest.java

@@ -193,4 +193,15 @@ void testTemplateDelete() {
     Assertions.assertFalse(storage.contains(TEMPLATE));
     Assertions.assertFalse(storage.hasFile(TEMPLATE, "test.txt"));
   }
+
+  @Test
+  @Order(120)
+  void testDeleteDirectory() {
+    var directory = "hello";
+    Assertions.assertTrue(storage.createDirectory(TEMPLATE, directory));
+    Assertions.assertTrue(storage.createFile(TEMPLATE, directory + "/test.txt"));
+    Assertions.assertTrue(storage.hasFile(TEMPLATE, directory + "/test.txt"));
+    Assertions.assertTrue(storage.deleteDirectory(TEMPLATE, directory));
+    Assertions.assertFalse(storage.hasFile(TEMPLATE, directory + "/test.txt"));
+  }
 }

node/src/main/java/eu/cloudnetservice/node/template/LocalTemplateStorage.java

@@ -193,6 +193,17 @@ public boolean deleteFile(@NonNull ServiceTemplate template, @NonNull String pat
     return false;
   }
 
+  @Override
+  public boolean deleteDirectory(@NonNull ServiceTemplate template, @NonNull String path) {
+    var dirPath = this.getTemplatePath(template).resolve(path);
+    if (Files.exists(dirPath) && Files.isDirectory(dirPath)) {
+      FileUtil.delete(dirPath);
+      return true;
+    }
+
+    return false;
+  }
+
   @Override
   public @Nullable InputStream newInputStream(
     @NonNull ServiceTemplate template,

node/src/test/java/eu/cloudnetservice/node/template/LocalTemplateStorageTest.java

@@ -177,4 +177,15 @@ void testTemplateDelete() {
     Assertions.assertFalse(storage.contains(TEMPLATE));
     Assertions.assertFalse(storage.hasFile(TEMPLATE, "test.txt"));
   }
+
+  @Test
+  @Order(120)
+  void testDeleteDirectory() {
+    var directory = "hello";
+    Assertions.assertTrue(storage.createDirectory(TEMPLATE, directory));
+    Assertions.assertTrue(storage.createFile(TEMPLATE, directory + "/test.txt"));
+    Assertions.assertTrue(storage.hasFile(TEMPLATE, directory + "/test.txt"));
+    Assertions.assertTrue(storage.deleteDirectory(TEMPLATE, directory));
+    Assertions.assertFalse(storage.hasFile(TEMPLATE, directory + "/test.txt"));
+  }
 }