Copyright	(c) Duncan Coutts 2012
License	BSD-like
Maintainer	duncan@community.haskell.org
Safe Haskell	None
Language	Haskell2010

Distribution.Simple.BuildTarget

Contents

Main interface
Build targets
Parsing user build targets
Resolving build targets

Description

Handling for user-specified build targets

Synopsis

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

Eq BuildTarget #
Methods (==) :: BuildTarget -> BuildTarget -> Bool # (/=) :: BuildTarget -> BuildTarget -> Bool #
Show BuildTarget #
Methods showsPrec :: Int -> BuildTarget -> ShowS # show :: BuildTarget -> String # showList :: [BuildTarget] -> ShowS #
Generic BuildTarget #
Associated Types type Rep BuildTarget :: * -> * # Methods from :: BuildTarget -> Rep BuildTarget x # to :: Rep BuildTarget x -> BuildTarget #
Binary BuildTarget #
Methods put :: BuildTarget -> Put # get :: Get BuildTarget # putList :: [BuildTarget] -> Put #
type Rep BuildTarget #
type Rep BuildTarget = D1 * (MetaData "BuildTarget" "Distribution.Simple.BuildTarget" "Cabal-2.0.0.2-48TVI32Hgv71FS4sRlskN" False) ((:+:) * (C1 * (MetaCons "BuildTargetComponent" PrefixI False) (S1 * (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 * ComponentName))) ((:+:) * (C1 * (MetaCons "BuildTargetModule" PrefixI False) ((::) (S1 * (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 * ComponentName)) (S1 * (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 * ModuleName)))) (C1 * (MetaCons "BuildTargetFile" PrefixI False) ((::) (S1 * (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 * ComponentName)) (S1 * (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 * FilePath))))))

showBuildTarget :: PackageId -> BuildTarget -> String #

Unambiguously render a BuildTarget, so that it can be parsed in all situations.

data QualLevel #

Constructors

QL1
QL2
QL3

Instances

Enum QualLevel #
Methods succ :: QualLevel -> QualLevel # pred :: QualLevel -> QualLevel # toEnum :: Int -> QualLevel # fromEnum :: QualLevel -> Int # enumFrom :: QualLevel -> [QualLevel] # enumFromThen :: QualLevel -> QualLevel -> [QualLevel] # enumFromTo :: QualLevel -> QualLevel -> [QualLevel] # enumFromThenTo :: QualLevel -> QualLevel -> QualLevel -> [QualLevel] #
Show QualLevel #
Methods showsPrec :: Int -> QualLevel -> ShowS # show :: QualLevel -> String # showList :: [QualLevel] -> ShowS #

buildTargetComponentName :: BuildTarget -> ComponentName #

Parsing user build targets

data UserBuildTarget #

Various ways that a user may specify a build target.

Instances

Eq UserBuildTarget #
Methods (==) :: UserBuildTarget -> UserBuildTarget -> Bool # (/=) :: UserBuildTarget -> UserBuildTarget -> Bool #
Ord UserBuildTarget #
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 #
Show UserBuildTarget #
Methods showsPrec :: Int -> UserBuildTarget -> ShowS # show :: UserBuildTarget -> String # showList :: [UserBuildTarget] -> ShowS #

readUserBuildTargets :: [String] -> ([UserBuildTargetProblem], [UserBuildTarget]) #

showUserBuildTarget :: UserBuildTarget -> String #

data UserBuildTargetProblem #

Constructors

UserBuildTargetUnrecognised String

Instances

Show UserBuildTargetProblem #
Methods showsPrec :: Int -> UserBuildTargetProblem -> ShowS # show :: UserBuildTargetProblem -> String # showList :: [UserBuildTargetProblem] -> ShowS #

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	expected thing (actually got)
BuildTargetNoSuch UserBuildTarget [(String, String)]	(no such thing, actually got)
BuildTargetAmbiguous UserBuildTarget [(UserBuildTarget, BuildTarget)]

Instances

Show BuildTargetProblem #
Methods showsPrec :: Int -> BuildTargetProblem -> ShowS # show :: BuildTargetProblem -> String # showList :: [BuildTargetProblem] -> ShowS #

reportBuildTargetProblems :: Verbosity -> [BuildTargetProblem] -> IO () #