Cabal-1.24.2.0: A framework for packaging Haskell software

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

- data BuildTarget
  - = BuildTargetComponent ComponentName
  - | BuildTargetModule ComponentName ModuleName
  - | BuildTargetFile ComponentName FilePath
- readBuildTargets :: PackageDescription -> [String] -> IO [BuildTarget]
- showBuildTarget :: QualLevel -> PackageId -> BuildTarget -> String
- data QualLevel
  - = QL1
  - | QL2
  - | QL3
- buildTargetComponentName :: BuildTarget -> ComponentName
- data UserBuildTarget
- readUserBuildTargets :: [String] -> ([UserBuildTargetProblem], [UserBuildTarget])
- showUserBuildTarget :: UserBuildTarget -> String
- data UserBuildTargetProblem = UserBuildTargetUnrecognised String
- reportUserBuildTargetProblems :: [UserBuildTargetProblem] -> IO ()
- resolveBuildTargets :: PackageDescription -> [(UserBuildTarget, Bool)] -> ([BuildTargetProblem], [BuildTarget])
- data BuildTargetProblem
  - = BuildTargetExpected UserBuildTarget [String] String
  - | BuildTargetNoSuch UserBuildTarget [(String, String)]
  - | BuildTargetAmbiguous UserBuildTarget [(UserBuildTarget, BuildTarget)]
- reportBuildTargetProblems :: [BuildTargetProblem] -> IO ()

# 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 # putList :: [BuildTarget] -> Put Source #
type Rep BuildTarget # |
type Rep BuildTarget = D1 (MetaData "BuildTarget" "Distribution.Simple.BuildTarget" "Cabal-1.24.2.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 `BuildTarget`s 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 #