Distribution.Simple.BuildTarget

Handling for user-specified build targets

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

Defined in Distribution.Simple.BuildTarget

Methods

(==) :: BuildTarget -> BuildTarget -> Bool

(/=) :: BuildTarget -> BuildTarget -> Bool

Show BuildTarget

Defined in Distribution.Simple.BuildTarget

Methods

showsPrec :: Int -> BuildTarget -> ShowS

show :: BuildTarget -> String

showList :: [BuildTarget] -> ShowS

Generic BuildTarget

Defined in Distribution.Simple.BuildTarget

Associated Types

type Rep BuildTarget :: Type -> Type

Methods

from :: BuildTarget -> Rep BuildTarget x

to :: Rep BuildTarget x -> BuildTarget

Binary BuildTarget

Defined in Distribution.Simple.BuildTarget

Methods

put :: BuildTarget -> Put

get :: Get BuildTarget

putList :: [BuildTarget] -> Put

type Rep BuildTarget

Defined in Distribution.Simple.BuildTarget

type Rep BuildTarget = D1 (MetaData "BuildTarget" "Distribution.Simple.BuildTarget" "Cabal-3.0.0.0-Gy7jp3IKeIKC3g3Vs5T0x1" False) (C1 (MetaCons "BuildTargetComponent" PrefixI False) (S1 (MetaSel (Nothing :: Maybe Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 ComponentName)) :+: (C1 (MetaCons "BuildTargetModule" PrefixI False) (S1 (MetaSel (Nothing :: Maybe Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 ComponentName) :*: S1 (MetaSel (Nothing :: Maybe Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 ModuleName)) :+: C1 (MetaCons "BuildTargetFile" PrefixI False) (S1 (MetaSel (Nothing :: Maybe Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 ComponentName) :*: S1 (MetaSel (Nothing :: Maybe 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

Defined in Distribution.Simple.BuildTarget

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

Defined in Distribution.Simple.BuildTarget

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

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

Show UserBuildTarget

Defined in Distribution.Simple.BuildTarget

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

Defined in Distribution.Simple.BuildTarget

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

Defined in Distribution.Simple.BuildTarget

Methods

showsPrec :: Int -> BuildTargetProblem -> ShowS

show :: BuildTargetProblem -> String

showList :: [BuildTargetProblem] -> ShowS

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