Add delete() methods for environment deletion

Author: ctrueden

src/main/java/org/apposed/appose/Builder.java

@@ -78,13 +78,26 @@ public interface Builder<T extends Builder<T>> {
 	 * using the current builder configuration. This is more robust than trying to
 	 * update an existing environment in place.
 	 * </p>
+	 * <p>
+	 * This method is a shorthand for {@link #delete()} then {@link #build()}.
+	 * </p>
 	 *
 	 * @return The newly rebuilt {@link Environment}.
 	 * @throws IOException If something goes wrong during rebuild.
 	 */
-	Environment rebuild() throws IOException;
+	default Environment rebuild() throws IOException {
+		delete();
+		return build();
+	}
 
 	/**
+	 * Deletes the builder's linked environment directory, if any.
+	 *
+	 * @throws IOException If something goes wrong during deletion.
+	 */
+	void delete() throws IOException;
+
+    /**
 	 * Wraps an existing environment directory, detecting and using any
 	 * configuration files present for future rebuild() calls.
 	 * <p>

src/main/java/org/apposed/appose/Environment.java

@@ -87,6 +87,17 @@ default Environment rebuild() throws IOException {
 		return builder().rebuild();
 	}
 
+	/**
+	 * Deletes the existing environment directory, if any.
+	 *
+	 * @return This environment, for fluid chaining.
+	 * @throws IOException If something goes wrong during deletion.
+	 */
+	default Environment delete() throws IOException {
+		builder().delete();
+		return this;
+	}
+
 	/**
 	 * Creates a Python script service.
 	 * <p>

src/main/java/org/apposed/appose/builder/BaseBuilder.java

@@ -68,12 +68,9 @@ public abstract class BaseBuilder<T extends BaseBuilder<T>> implements Builder<T
 	// -- Builder methods --
 
 	@Override
-	public Environment rebuild() throws IOException {
+	public void delete() throws IOException {
 		File dir = envDir();
-		if (dir.exists()) {
-			FilePaths.deleteRecursively(dir);
-		}
-		return build();
+		if (dir.exists()) FilePaths.deleteRecursively(dir);
 	}
 
 	@Override