Interface: CompileConfig
compiler.CompileConfig
Compilation Configuration for a Kipper program. This interface will be wrapped using EvaluatedCompileConfig if it's passed to compile.
Since
0.1.0
Implemented by
Table of contents
Properties
- abortOnFirstError
- builtInFunctions
- builtInVariables
- extendBuiltInFunctions
- extendBuiltInVariables
- fileName
- optimisationOptions
- recover
- target
- warnings
Properties
abortOnFirstError
• Optional
abortOnFirstError: boolean
If set to true, the compiler will throw the first error that is encountered and cancel the compilation.
This per default overwrites recover.
Since
0.10.0
Defined in
kipper/core/src/compiler/compile-config.ts:97
builtInFunctions
• Optional
builtInFunctions: BuiltInFunction
[]
The built-in functions that will be available in a Kipper program. This option overwrites the default built-ins, if you wish to only add new built-in functions write to extendBuiltInFunctions.
All built-in functions defined here must be implemented by the target.builtInGenerator.
Defined in
kipper/core/src/compiler/compile-config.ts:28
builtInVariables
• Optional
builtInVariables: BuiltInVariable
[]
The built-in variables that will be available in a Kipper program. This option overwrites the default built-ins, if you wish to only add new built-in variables write to extendBuiltInVariables.
All built-in variables defined here must be implemented by the target.builtInGenerator.
Since
0.10.0
Defined in
kipper/core/src/compiler/compile-config.ts:45
extendBuiltInFunctions
• Optional
extendBuiltInFunctions: BuiltInFunction
[]
Extends the builtInFunctions with the specified items. If builtInFunctions is undefined, then it will simply extend the default array.
All built-in functions defined here must be implemented by the target.builtInGenerator.
Defined in
kipper/core/src/compiler/compile-config.ts:36
extendBuiltInVariables
• Optional
extendBuiltInVariables: BuiltInVariable
[]
Extends the builtInVariables with the specified items. If builtInVariables is undefined, then it will simply extend the default array.
All built-in variables defined here must be implemented by the target.builtInGenerator.
Since
0.10.0
Defined in
kipper/core/src/compiler/compile-config.ts:54
fileName
• Optional
fileName: string
The filename that should be used to represent the program.
Since
0.2.0
Defined in
kipper/core/src/compiler/compile-config.ts:60
optimisationOptions
• Optional
optimisationOptions: OptimisationOptions
Options for the KipperOptimiser.
Since
0.8.0
Defined in
kipper/core/src/compiler/compile-config.ts:66
recover
• Optional
recover: boolean
If set to true, the compiler will attempt to recover from compilation errors if they are encountered. This will mean the compiler can process multiple errors, without aborting on the first one encountered. This though can result in invalid errors being generated, as a result of other errors. (Error recovery does not include syntax error recovery and if a syntax error is encountered, the compiler aborts immediately.)
Generally though, it is good to use compiler error recovery, which is why it is enabled per default and should rarely be disabled.
If set to false, the compiler will stop processing on the first error that is encountered. Unlike abortOnFirstError it will not throw the error, but instead simple store it in errors and errors.
Since
0.10.0
Defined in
kipper/core/src/compiler/compile-config.ts:89
target
• target: KipperCompileTarget
The translation languages for the compilation.
Since
0.5.0
Defined in
kipper/core/src/compiler/compile-config.ts:20
warnings
• Optional
warnings: boolean
If set to true, the compiler will check for warnings and add them to warnings and warnings.
Since
0.9.0
Defined in
kipper/core/src/compiler/compile-config.ts:73