Foreign.Hoppy.Generator.Compiler

Data types for compilers and functions for invoking them.

Typeclass

class Show a => Compiler a where

A compiler that exists on the system for compiling C++ code.

Methods

compileProgram :: a -> FilePath -> FilePath -> IO Bool

compileProgram compiler infile outfile invokes the given compiler in the input file, to produce the output file. If the compiler fails or can't be called for whatever reason, then an error message is printed to standard error, and false is returned.

Instances

Compiler CustomCompiler

Defined in Foreign.Hoppy.Generator.Compiler

Methods

compileProgram :: CustomCompiler -> FilePath -> FilePath -> IO Bool

Compiler SimpleCompiler

Defined in Foreign.Hoppy.Generator.Compiler

Methods

compileProgram :: SimpleCompiler -> FilePath -> FilePath -> IO Bool

Compiler SomeCompiler

Defined in Foreign.Hoppy.Generator.Compiler

Methods

compileProgram :: SomeCompiler -> FilePath -> FilePath -> IO Bool

data SomeCompiler

An existential data type for Compilers.

Constructors

Compiler a => SomeCompiler a

Instances

Show SomeCompiler

Defined in Foreign.Hoppy.Generator.Compiler

Methods

showsPrec :: Int -> SomeCompiler -> ShowS

show :: SomeCompiler -> String

showList :: [SomeCompiler] -> ShowS

Compiler SomeCompiler

Defined in Foreign.Hoppy.Generator.Compiler

Methods

compileProgram :: SomeCompiler -> FilePath -> FilePath -> IO Bool

Data types

data SimpleCompiler

A compiler that can compile a source file into a binary with a single program invocation.

Within the strings in this data type, including the program path, all occurences of {in} and {out} are expanded to the input and desired output files, respectively.

Constructors

SimpleCompiler

Fields

• scProgram :: FilePath

  The name of the compiler program to call. Lookup is subject to the regular search path rules of your operating system.

• scArguments :: [String]

  Arguments to pass to the compiler. Each string is passed as a separate argument. No further word splitting is done.

Instances

Show SimpleCompiler

Defined in Foreign.Hoppy.Generator.Compiler

Methods

showsPrec :: Int -> SimpleCompiler -> ShowS

show :: SimpleCompiler -> String

showList :: [SimpleCompiler] -> ShowS

Compiler SimpleCompiler

Defined in Foreign.Hoppy.Generator.Compiler

Methods

compileProgram :: SimpleCompiler -> FilePath -> FilePath -> IO Bool

prependArguments :: [String] -> SimpleCompiler -> SimpleCompiler

Adds arguments to the start of a compiler's argument list.

appendArguments :: [String] -> SimpleCompiler -> SimpleCompiler

Adds arguments to the end of a compiler's argument list.

overrideCompilerFromEnvironment :: SimpleCompiler -> IO SimpleCompiler

Modifies a SimpleCompiler based on environment variables.

If CXX is set and non-empty, it will override the compiler's scProgram.

If CXXFLAGS is set and non-empty, it will be split into words and each word will be prepended as an argument to scArguments. Quoting is not supported.

data CustomCompiler

A Compiler that allows plugging arbitary logic into the compilation process.

Constructors

CustomCompiler

Fields

• ccLabel :: String

  A label to display when the compiler is shown. The string is "<CustomCompiler " ++ label ++ ">".

• ccCompile :: FilePath -> FilePath -> IO Bool

  Given a source file path and an output path, compiles the source file, producing a binary at the output path. Returns true on success. Logs to standard error and returns false on failure.

Instances

Show CustomCompiler

Defined in Foreign.Hoppy.Generator.Compiler

Methods

showsPrec :: Int -> CustomCompiler -> ShowS

show :: CustomCompiler -> String

showList :: [CustomCompiler] -> ShowS

Compiler CustomCompiler

Defined in Foreign.Hoppy.Generator.Compiler

Methods

compileProgram :: CustomCompiler -> FilePath -> FilePath -> IO Bool

Standard compilers

defaultCompiler :: SimpleCompiler

The default compiler, used by an Interface that doesn't specify its own. This is:

unsafePerformIO $ overrideCompilerFromEnvironment gppCompiler

gppCompiler :: SimpleCompiler

The GNU C++ compiler, invoked as g++ -o {out} {in}.