Moduleghc-toolchain-0.1.0.0Haskell2010

GHC.Toolchain.Program

Contents

Running programs
Finding Programs
Compiler programs

Synopsis

data Program
value shProgram
value _prgPath
value _prgFlags
value addFlagIfNew
value runProgram
value callProgram
value readProgram
value readProgramStdout
data ProgOpt
value emptyProgOpt
value programFromOpt
value _poPath
value _poFlags
value findProgram
value compile
value supportsTarget

Packageghc-toolchain-0.1.0.0
Exports17
LanguageHaskell2010
LicenceNONE
SourceProgram.hs

datadata Program

Constructors

Program
- prgPath :: FilePath
- prgFlags :: [String]

Instances4Eq, Ord, Read, Show

Eq ProgramDefined in ghc-toolchain-0.1.0.0 · GHC.Toolchain.Program
Ord ProgramDefined in ghc-toolchain-0.1.0.0 · GHC.Toolchain.Program
Read ProgramDefined in ghc-toolchain-0.1.0.0 · GHC.Toolchain.Program
Show ProgramDefined in ghc-toolchain-0.1.0.0 · GHC.Toolchain.Program

valueshProgram :: Program

value_prgPath :: Lens Program FilePath

value_prgFlags :: Lens Program [String]

valueaddFlagIfNew :: String -> Program -> Program

Source#

Prepends a flag to a program's flags if the flag is not in the existing flags.

Running programs

valuerunProgram :: Program -> [String] -> M ExitCode

valuecallProgram :: Program -> [String] -> M ()

valuereadProgram :: Program -> [String] -> M (ExitCode, String, String)

Source#

Runs a program with a list of arguments and returns the exit code and the stdout and stderr output

valuereadProgramStdout :: Program -> [String] -> M String

Source#

Runs a program with a list of arguments and returns the stdout output, ignoring the exit code.

Finding Programs

datadata ProgOpt

Source#

Program specifier from the command-line.

Constructors

ProgOpt
- poPath :: Maybe String
  Refers to the path to an executable, or simply the executable name.
- poFlags :: Maybe [String]

valueemptyProgOpt :: ProgOpt

valueprogramFromOpt

:: ProgOpt
-> FilePath
Program path to default to
-> [String]
Program flags to default to
-> Program

Source#

Make a Program from user specified program options (ProgOpt), defaulting to the given path and flags if unspecified in the ProgOpt.

value_poPath :: Lens ProgOpt (Maybe FilePath)

value_poFlags :: Lens ProgOpt (Maybe [String])

valuefindProgram

:: String
-> ProgOpt
path provided by user
-> [FilePath]
candidate names
-> M Program

Source#

Tries to find the user specified program by path or tries to look for one in the given list of candidates.

If the ProgOpt program flags are unspecified the program will have an empty list of flags.

Compiler programs

valuecompile

:: FilePath
input extension
-> [String]
extra flags
-> Lens compiler Program
-> compiler
-> FilePath
output path
-> String
source
-> M ()

Source#

Compile a program with a given compiler.

The compiler must * Take the program path as a positional argument * Accept -o to specify output path

valuesupportsTarget

:: ArchOS
-> Lens compiler Program
-> (compiler -> M ())
Action to check if compiler with --target flag works
-> String
The LLVM target to use if cc supports --target
-> compiler
The compiler to check --target support for
-> M compiler
Return compiler with --target flag if supported

Source#

Does compiler program support the --target=triple option? If so, we should pass it whenever possible to avoid ambiguity and potential compile-time errors (e.g. see #20162).