com.facebook.buck.parser

Class TargetSpecResolver

java.lang.Object

com.facebook.buck.parser.TargetSpecResolver

All Implemented Interfaces:

AutoCloseable

public class TargetSpecResolver
extends Object
implements AutoCloseable

Responsible for discovering all the build targets that match a set of TargetNodeSpec.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	TargetSpecResolver.FlavorEnhancer Allows to change flavors of some targets while performing the resolution.
static interface	TargetSpecResolver.TargetNodeFilterForSpecResolver Performs filtering of target nodes using a given TargetNodeSpec.

Method Summary

Modifier and Type	Method and Description
void	close()
static TargetSpecResolver	createWithFileSystemCrawler(BuckEventBus eventBus, DepsAwareExecutor<? super ComputeResult,?> executor, CellProvider cellProvider, com.google.common.cache.LoadingCache<Path,DirectoryListCache> dirListCachePerRoot, com.google.common.cache.LoadingCache<Path,FileTreeCache> fileTreeCachePerRoot) Create instance using BuildTargetPatternToBuildPackagePathComputation
static TargetSpecResolver	createWithWatchmanCrawler(BuckEventBus eventBus, Watchman watchman, DepsAwareExecutor<? super ComputeResult,?> executor, CellProvider cellProvider) Create instance using WatchmanBuildPackageComputation
<T extends HasBuildTarget> com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableSet<BuildTarget>>	resolveTargetSpecs(Cell rootCell, Iterable<? extends TargetNodeSpec> specs, Optional<TargetConfiguration> targetConfiguration, TargetSpecResolver.FlavorEnhancer flavorEnhancer, PerBuildState perBuildState, TargetSpecResolver.TargetNodeFilterForSpecResolver targetNodeFilter)

Methods inherited from class java.lang.Object

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

Method Detail

createWithFileSystemCrawler

public static TargetSpecResolver createWithFileSystemCrawler(BuckEventBus eventBus,
                                                             DepsAwareExecutor<? super ComputeResult,?> executor,
                                                             CellProvider cellProvider,
                                                             com.google.common.cache.LoadingCache<Path,DirectoryListCache> dirListCachePerRoot,
                                                             com.google.common.cache.LoadingCache<Path,FileTreeCache> fileTreeCachePerRoot)

Create instance using BuildTargetPatternToBuildPackagePathComputation

Parameters:

eventBus - Event bus to send performance events to

executor - The executor for the GraphTransformationEngine

cellProvider - Provider to get a cell by path; this is a workaround for the state that cell itself is not really hashable so we use cell path instead as a key for appropriate caches

dirListCachePerRoot - Global cache that stores a mapping of cell root path to a cache of all directory structures under that cell

fileTreeCachePerRoot - Global cache that stores a mapping of cell root path to a cache of all file tree structures under that cell

createWithWatchmanCrawler

public static TargetSpecResolver createWithWatchmanCrawler(BuckEventBus eventBus,
                                                           Watchman watchman,
                                                           DepsAwareExecutor<? super ComputeResult,?> executor,
                                                           CellProvider cellProvider)

Create instance using WatchmanBuildPackageComputation

Parameters:

eventBus - Event bus to send performance events to

executor - The executor for the GraphTransformationEngine

cellProvider - Provider to get a cell by path; this is a workaround for the state that cell itself is not really hashable so we use cell path instead as a key for appropriate caches

resolveTargetSpecs

public <T extends HasBuildTarget> com.google.common.collect.ImmutableList<com.google.common.collect.ImmutableSet<BuildTarget>> resolveTargetSpecs(Cell rootCell,
                                                                                                                                                  Iterable<? extends TargetNodeSpec> specs,
                                                                                                                                                  Optional<TargetConfiguration> targetConfiguration,
                                                                                                                                                  TargetSpecResolver.FlavorEnhancer flavorEnhancer,
                                                                                                                                                  PerBuildState perBuildState,
                                                                                                                                                  TargetSpecResolver.TargetNodeFilterForSpecResolver targetNodeFilter)
                                                                                                                                           throws BuildFileParseException,
                                                                                                                                                  InterruptedException

Returns:

a list of sets of build targets where each set contains all build targets that match a corresponding TargetNodeSpec.

Throws:

BuildFileParseException

InterruptedException

close

public void close()

Specified by:

close in interface AutoCloseable