com.facebook.buck.io.file

Class FileFinder

java.lang.Object

com.facebook.buck.io.file.FileFinder

public class FileFinder
extends Object

Methods for finding files.

Method Summary

Modifier and Type	Method and Description
static com.google.common.collect.ImmutableSet<String>	combine(Set<String> prefixes, String base, Set<String> suffixes) Combines prefixes, base, and suffixes to create a set of file names.
static Optional<Path>	getOptionalFile(Set<String> possibleNames, Iterable<Path> searchPaths, java.util.function.Predicate<Path> filter) Tries to find a file with one of a number of possible names in a search path.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

combine

public static com.google.common.collect.ImmutableSet<String> combine(Set<String> prefixes,
                                                                     String base,
                                                                     Set<String> suffixes)

Combines prefixes, base, and suffixes to create a set of file names.

Parameters:

prefixes - set of prefixes. May be empty.

base - base name. May be empty.

suffixes - set of suffixes. May be empty.

Returns:

a set containing all combinations of prefix, base, and suffix.

getOptionalFile

public static Optional<Path> getOptionalFile(Set<String> possibleNames,
                                             Iterable<Path> searchPaths,
                                             java.util.function.Predicate<Path> filter)

Tries to find a file with one of a number of possible names in a search path.

Returns the first match found. Search tries all paths in the search paths in order, looking for any matching names in each path.

Parameters:

possibleNames - file names to look for.

searchPaths - directories to search.

filter - additional check that discovered paths must pass to be eligible.

Returns:

returns the first match found, if any.