Class CompilerFactory

java.lang.Object

ca.mcscert.jpipe.compiler.CompilerFactory

public final class CompilerFactory
extends Object

Assembles a Compiler from a CompilationConfig by wiring the appropriate pipeline steps.

Not all formats are implemented yet. Unsupported combinations throw UnsupportedOperationException at factory time, before any file I/O occurs.

Method Summary

Modifier and Type	Method	Description
static Compiler	build(CompilationConfig config, OutputStream stdout)	Build a process-mode compiler from the given configuration.
static Compiler	buildDiagnosticCompiler(DiagnosticFormat format, OutputStream stdout)	Build a diagnostic-mode compiler that parses the source and reports on it without exporting any model.
static Compiler	buildDiagnosticCompiler(OutputStream stdout)	Build a diagnostic-mode compiler producing a human-readable report.
static ChainBuilder<InputStream, List<Command>>	parsingChain()	Parsing chain: reads a source file, lexes, parses, and extracts the action list.
static Transformation<List<Command>, Unit>	unitBuilder()	Full unit builder: extends the parsing chain with model construction, consistency checking, and completeness checking.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

build

public static Compiler build(CompilationConfig config,
 OutputStream stdout)

Build a process-mode compiler from the given configuration.

Parameters:

config - the compilation configuration.

stdout - stream to use when the output target is CompilationConfig.STDOUT.

Returns:

a ready-to-use Compiler.

Throws:

UnsupportedOperationException - if the requested format is not yet implemented.

buildDiagnosticCompiler

public static Compiler buildDiagnosticCompiler(OutputStream stdout)

Build a diagnostic-mode compiler producing a human-readable report. Equivalent to buildDiagnosticCompiler(DiagnosticFormat, OutputStream) with DiagnosticFormat.TEXT.

Parameters:

stdout - stream to use when the output target is CompilationConfig.STDOUT.

Returns:

a ready-to-use Compiler.

buildDiagnosticCompiler

public static Compiler buildDiagnosticCompiler(DiagnosticFormat format,
 OutputStream stdout)

Build a diagnostic-mode compiler that parses the source and reports on it without exporting any model.

Both formats share the CollectDiagnostics step and differ only in their renderer, so they always describe the same compilation.

The report is written by a DiagnosticCompiler rather than assembled as the tail of the analysis chain, so that a compilation which aborts on a fatal diagnostic is still reported on.

Parameters:

format - how to render the report.

stdout - stream to use when the output target is CompilationConfig.STDOUT.

Returns:

a ready-to-use Compiler.

parsingChain

public static ChainBuilder<InputStream, List<Command>> parsingChain()

Parsing chain: reads a source file, lexes, parses, and extracts the action list. Aborts on any syntax error via HaltAndCatchFire.

unitBuilder

public static Transformation<List<Command>, Unit> unitBuilder()

Full unit builder: extends the parsing chain with model construction, consistency checking, and completeness checking.