| Copyright | (c) Duncan Coutts 2012 | 
|---|---|
| License | BSD-like | 
| Maintainer | duncan@community.haskell.org | 
| Safe Haskell | Safe-Inferred | 
| Language | Haskell2010 | 
Distribution.Simple.BuildTarget
Description
Handling for user-specified build targets
Synopsis
- readTargetInfos :: Verbosity -> PackageDescription -> LocalBuildInfo -> [String] -> IO [TargetInfo]
- readBuildTargets :: Verbosity -> PackageDescription -> [String] -> IO [BuildTarget]
- data BuildTarget
- showBuildTarget :: PackageId -> BuildTarget -> String
- data QualLevel
- buildTargetComponentName :: BuildTarget -> ComponentName
- data UserBuildTarget
- readUserBuildTargets :: [String] -> ([UserBuildTargetProblem], [UserBuildTarget])
- showUserBuildTarget :: UserBuildTarget -> String
- data UserBuildTargetProblem = UserBuildTargetUnrecognised String
- reportUserBuildTargetProblems :: Verbosity -> [UserBuildTargetProblem] -> IO ()
- resolveBuildTargets :: PackageDescription -> [(UserBuildTarget, Bool)] -> ([BuildTargetProblem], [BuildTarget])
- data BuildTargetProblem
- reportBuildTargetProblems :: Verbosity -> [BuildTargetProblem] -> IO ()
Main interface
readTargetInfos :: Verbosity -> PackageDescription -> LocalBuildInfo -> [String] -> IO [TargetInfo] #
Take a list of String build targets, and parse and validate them
 into actual TargetInfos to be builtregisteredwhatever.
readBuildTargets :: Verbosity -> PackageDescription -> [String] -> IO [BuildTarget] #
Read a list of user-supplied build target strings and resolve them to
 BuildTargets according to a PackageDescription. If there are problems
 with any of the targets e.g. they don't exist or are misformatted, throw an
 IOException.
Build targets
data BuildTarget #
A fully resolved build target.
Constructors
| BuildTargetComponent ComponentName | A specific component | 
| BuildTargetModule ComponentName ModuleName | A specific module within a specific component. | 
| BuildTargetFile ComponentName FilePath | A specific file within a specific component. | 
Instances
showBuildTarget :: PackageId -> BuildTarget -> String #
Unambiguously render a BuildTarget, so that it can
 be parsed in all situations.
Instances
| Enum QualLevel # | |
| Defined in Distribution.Simple.BuildTarget Methods succ :: QualLevel -> QualLevel Source # pred :: QualLevel -> QualLevel Source # toEnum :: Int -> QualLevel Source # fromEnum :: QualLevel -> Int Source # enumFrom :: QualLevel -> [QualLevel] Source # enumFromThen :: QualLevel -> QualLevel -> [QualLevel] Source # enumFromTo :: QualLevel -> QualLevel -> [QualLevel] Source # enumFromThenTo :: QualLevel -> QualLevel -> QualLevel -> [QualLevel] Source # | |
| Show QualLevel # | |
Parsing user build targets
data UserBuildTarget #
Various ways that a user may specify a build target.
Instances
| Show UserBuildTarget # | |
| Defined in Distribution.Simple.BuildTarget | |
| Eq UserBuildTarget # | |
| Defined in Distribution.Simple.BuildTarget Methods (==) :: UserBuildTarget -> UserBuildTarget -> Bool # (/=) :: UserBuildTarget -> UserBuildTarget -> Bool # | |
| Ord UserBuildTarget # | |
| Defined in Distribution.Simple.BuildTarget Methods compare :: UserBuildTarget -> UserBuildTarget -> Ordering # (<) :: UserBuildTarget -> UserBuildTarget -> Bool # (<=) :: UserBuildTarget -> UserBuildTarget -> Bool # (>) :: UserBuildTarget -> UserBuildTarget -> Bool # (>=) :: UserBuildTarget -> UserBuildTarget -> Bool # max :: UserBuildTarget -> UserBuildTarget -> UserBuildTarget # min :: UserBuildTarget -> UserBuildTarget -> UserBuildTarget # | |
readUserBuildTargets :: [String] -> ([UserBuildTargetProblem], [UserBuildTarget]) #
data UserBuildTargetProblem #
Constructors
| UserBuildTargetUnrecognised String | 
Instances
reportUserBuildTargetProblems :: Verbosity -> [UserBuildTargetProblem] -> IO () #
Resolving build targets
resolveBuildTargets :: PackageDescription -> [(UserBuildTarget, Bool)] -> ([BuildTargetProblem], [BuildTarget]) #
Given a bunch of user-specified targets, try to resolve what it is they refer to.
data BuildTargetProblem #
Constructors
| BuildTargetExpected UserBuildTarget [String] String | 
 | 
| BuildTargetNoSuch UserBuildTarget [(String, String)] | 
 | 
| BuildTargetAmbiguous UserBuildTarget [(UserBuildTarget, BuildTarget)] | 
Instances
| Show BuildTargetProblem # | |
| Defined in Distribution.Simple.BuildTarget | |
reportBuildTargetProblems :: Verbosity -> [BuildTargetProblem] -> IO () #