com.facebook.buck.io.file

Class PathListing

java.lang.Object

com.facebook.buck.io.file.PathListing

public class PathListing
extends Object

Utility class to list files which match a pattern, applying ordering and filtering.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PathListing.FilterMode Whether to include files which match the filter, or exclude them.
static interface	PathListing.PathModifiedTimeFetcher Fetches last-modified time from a path.

Field Summary

Fields

Modifier and Type	Field and Description
static PathListing.PathModifiedTimeFetcher	GET_PATH_MODIFIED_TIME Uses Files.getLastModifiedTime() to get the last modified time for a Path.

Method Summary

Modifier and Type	Method and Description
static com.google.common.collect.ImmutableSortedSet<Path>	listMatchingPaths(Path pathToGlob, String globPattern, PathListing.PathModifiedTimeFetcher pathModifiedTimeFetcher) Lists matching paths in descending modified time order.
static com.google.common.collect.ImmutableSortedSet<Path>	listMatchingPathsWithFilters(Path pathToGlob, String globPattern, PathListing.PathModifiedTimeFetcher pathModifiedTimeFetcher, PathListing.FilterMode filterMode, OptionalInt maxPathsFilter, Optional<Long> totalSizeFilter) Lists paths in descending modified time order, excluding any paths which bring the number of files over maxNumPaths or over totalSizeFilter bytes in size.

Methods inherited from class java.lang.Object

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

Field Detail

GET_PATH_MODIFIED_TIME

public static final PathListing.PathModifiedTimeFetcher GET_PATH_MODIFIED_TIME

Uses Files.getLastModifiedTime() to get the last modified time for a Path.

Method Detail

listMatchingPaths

public static com.google.common.collect.ImmutableSortedSet<Path> listMatchingPaths(Path pathToGlob,
                                                                                   String globPattern,
                                                                                   PathListing.PathModifiedTimeFetcher pathModifiedTimeFetcher)
                                                                            throws IOException

Lists matching paths in descending modified time order.

Throws:

IOException

listMatchingPathsWithFilters

public static com.google.common.collect.ImmutableSortedSet<Path> listMatchingPathsWithFilters(Path pathToGlob,
                                                                                              String globPattern,
                                                                                              PathListing.PathModifiedTimeFetcher pathModifiedTimeFetcher,
                                                                                              PathListing.FilterMode filterMode,
                                                                                              OptionalInt maxPathsFilter,
                                                                                              Optional<Long> totalSizeFilter)
                                                                                       throws IOException

Lists paths in descending modified time order, excluding any paths which bring the number of files over maxNumPaths or over totalSizeFilter bytes in size.

Throws:

IOException