package bjc.utils.funcutils;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.attribute.BasicFileAttributes;
import java.util.function.BiPredicate;

/**
 * Utilities for doing things with files.
 *
 * @author ben
 */
public class FileUtils {
	/*
	 *  @NOTE
	 *  	If it becomes necessary, write another overload
	 * 	for this with all the buttons and knobs from
	 * 	walkFileTree.
	 */
	/**
	 * Traverse a directory recursively. This is a depth-first traversal.
	 *
	 * @param root
	 * 	The directory to start the traversal at.
	 *
	 * @param predicate
	 * 	The predicate to determine whether or not to traverse
	 * 	a directory.
	 *
	 * @param action
	 * 	The action to invoke upon each file in the directory. Returning
	 * 	true means to continue the traversal, returning false stops it.
	 *
	 * @throws IOException
	 * 	If the walk throws an exception.
	 *
	 */
	public static void traverseDirectory(final Path root, final BiPredicate<Path, BasicFileAttributes> predicate,
			final BiPredicate<Path, BasicFileAttributes> action) throws IOException {
		Files.walkFileTree(root, new FunctionalFileVisitor(predicate, action));
	}
}