A compiler API for the SunScript language. Forked from https://github.com/JoshuaMKW/ssc
Find a file
2015-12-12 17:00:04 -05:00
frontend Added error-line preview to frontend. 2015-12-12 16:51:31 -05:00
ssc Moved the ssc API code to its own folder. 2015-12-12 17:00:04 -05:00
stdlib Added some stdlib scripts. 2015-12-12 12:51:32 -05:00
.gitignore
language.md Added increment/decrement operators. 2015-12-10 21:45:35 -05:00
readme.md Made links to language.md. 2015-12-10 22:07:31 -05:00

ssc

Summary

ssc is a basic, work-in-progress compiler for SunScript. It supports all of the byte-code functionality of Super Mario Sunshine's SPC interpreter. The compiler compiles to the SPC binary format (.sb files) used by Super Mario Sunshine.

This program utilizes the Grammatica library to generate an LL(k) parser using a grammar syntax file.

Usage

To use ssc, create an instance of the sunCompiler class. Use the sunCompiler.Compile or any of its overloads to compile a script:

Parameter Description
name The name of the main script to compile. This is passed to the import resolver.
output The output stream into which the compiled binary file will be written.
resolver An instance of the import resolver to use. If not specified, sunImportResolver.Default will be used.

ssc by default resolves imports by loading files on disk (see language.md. for more information). To use a custom import resolver, create a new class inheriting from sunImportResolver and pass an instance of it to the sunCompiler.Compile method.

The result of compilation will be returned in a sunCompilerResults instance. Use the various properties on this type to gather the information of the compilation:

Property Description
Success Whether the script was compiled successfully. If not, the Error property should be non-null.
Error The fatal error which occured during compilation. If compilation was successful, this should be null.
CompileTime The time it took to compile, measured as a TimeSpan instance.
DataCount The total number of data-table entries created.
SymbolCount The total number of symbols (builtins, functions, and variables) created.
BuiltinCount The total number of builtin symbols created.
FunctionCount The total number of function symbols created.
VariableCount The total number of global-scope variable symbols created.

If the error is of the type sunScriptException, you can cast and retrieve the script name, line, and column of the error.

Language

For more information on the SunScript language and its syntax, see language.md.