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

Distribution.Simple.BuildTarget

Contents

Build targets
Parsing user build targets
Resolving build targets

Description

Handling for user-specified build targets

Synopsis

Build targets

data BuildTarget Source

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 Source show :: BuildTarget -> String Source showList :: [BuildTarget] -> ShowS Source
Generic BuildTarget
Associated Types type Rep BuildTarget :: * -> * Source Methods from :: BuildTarget -> Rep BuildTarget x Source to :: Rep BuildTarget x -> BuildTarget Source
Binary BuildTarget
Methods put :: BuildTarget -> Put Source get :: Get BuildTarget Source
type Rep BuildTarget = D1 (MetaData "BuildTarget" "Distribution.Simple.BuildTarget" "Cabal-1.23.1.0" 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))))))

readBuildTargets :: PackageDescription -> [String] -> IO [BuildTarget] Source

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.

showBuildTarget :: QualLevel -> PackageId -> BuildTarget -> String Source

data QualLevel Source

Constructors

QL1
QL2
QL3

Instances

Enum QualLevel
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
Methods showsPrec :: Int -> QualLevel -> ShowS Source show :: QualLevel -> String Source showList :: [QualLevel] -> ShowS Source

buildTargetComponentName :: BuildTarget -> ComponentName Source

Parsing user build targets

data UserBuildTarget Source

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 Source show :: UserBuildTarget -> String Source showList :: [UserBuildTarget] -> ShowS Source

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

showUserBuildTarget :: UserBuildTarget -> String Source

data UserBuildTargetProblem Source

Constructors

UserBuildTargetUnrecognised String

Instances

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

reportUserBuildTargetProblems :: [UserBuildTargetProblem] -> IO () Source

Resolving build targets

resolveBuildTargets :: PackageDescription -> [(UserBuildTarget, Bool)] -> ([BuildTargetProblem], [BuildTarget]) Source

Given a bunch of user-specified targets, try to resolve what it is they refer to.

data BuildTargetProblem Source

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 Source show :: BuildTargetProblem -> String Source showList :: [BuildTargetProblem] -> ShowS Source

reportBuildTargetProblems :: [BuildTargetProblem] -> IO () Source