- Added documentation to some classes

- Created script provider system
- Did some refactoring to improve the API
This commit is contained in:
Stan Hebben committed 2014-06-10 21:12:55 +02:00
1 parent 38b78ce305
commit 97c7f42400
50 files changed
+1311 -318

No files matched your search

@@ -1,16 +1,10 @@
/*
* To change this license header, choose License Headers in Project Properties.
* To change this template file, choose Tools | Templates
* and open the template in the editor.
*/
package stanhebben.zenscript;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import static stanhebben.zenscript.ZenParser.*;
import static stanhebben.zenscript.ZenTokener.*;
import stanhebben.zenscript.compiler.IEnvironmentGlobal;
import stanhebben.zenscript.definitions.Import;
import stanhebben.zenscript.definitions.ParsedFunction;
@@ -18,8 +12,19 @@ import stanhebben.zenscript.parser.Token;
import stanhebben.zenscript.statements.Statement;
/**
*
* @author Stanneke
* Contains a parsed file.
*
* A parsed file contains:
* <ul>
* <li>A set of imports</li>
* <li>A set of parsed functions</li>
* <li>A set of statuments</li>
* </ul>
*
* This parsed file cannot be executed by itself, but it can be compiled into
* a module, possibly together with other files.
*
* @author Stan Hebben
*/
public class ZenParsedFile {
private final String filename;
@@ -28,7 +33,15 @@ public class ZenParsedFile {
private final Map<String, ParsedFunction> functions;
private final List<Statement> statements;
public ZenParsedFile(String filename, String classname, ZenParser parser, IEnvironmentGlobal environment) {
/**
* Constructs and parses a given file.
*
* @param filename parsed filename
* @param classname output class name
* @param tokener input tokener
* @param environment compile environment
*/
public ZenParsedFile(String filename, String classname, ZenTokener tokener, IEnvironmentGlobal environment) {
this.filename = filename;
this.classname = classname;
@@ -36,61 +49,86 @@ public class ZenParsedFile {
functions = new HashMap<String, ParsedFunction>();
statements = new ArrayList<Statement>();
parser.setFile(this);
tokener.setFile(this);
while (parser.peek() != null && parser.peek().getType() == T_IMPORT) {
Token start = parser.next();
while (tokener.peek() != null && tokener.peek().getType() == T_IMPORT) {
Token start = tokener.next();
List<String> importName = new ArrayList<String>();
Token tName = parser.required(T_ID, "identifier expected");
Token tName = tokener.required(T_ID, "identifier expected");
importName.add(tName.getValue());
while (parser.optional(T_DOT) != null) {
Token tNamePart = parser.required(T_ID, "identifier expected");
while (tokener.optional(T_DOT) != null) {
Token tNamePart = tokener.required(T_ID, "identifier expected");
importName.add(tNamePart.getValue());
}
String rename = null;
if (parser.optional(T_AS) != null) {
Token tRename = parser.required(T_ID, "identifier expected");
if (tokener.optional(T_AS) != null) {
Token tRename = tokener.required(T_ID, "identifier expected");
rename = tRename.getValue();
}
parser.required(T_SEMICOLON, "; expected");
tokener.required(T_SEMICOLON, "; expected");
imports.add(new Import(start.getPosition(), importName, rename));
}
while (parser.hasNext()) {
Token next = parser.peek();
while (tokener.hasNext()) {
Token next = tokener.peek();
if (next.getType() == T_FUNCTION) {
ParsedFunction function = ParsedFunction.parse(parser, environment);
ParsedFunction function = ParsedFunction.parse(tokener, environment);
if (functions.containsKey(function.getName())) {
environment.error(function.getPosition(), "function " + function.getName() + " already exists");
}
functions.put(function.getName(), function);
} else {
statements.add(Statement.read(parser, environment));
statements.add(Statement.read(tokener, environment));
}
}
}
/**
* Gets the output classname for this file.
*
* @return output classname
*/
public String getClassName() {
return classname;
}
/**
* Gets the input filename for this file.
*
* @return input filename
*/
public String getFileName() {
return filename;
}
/**
* Gets the imports list.
*
* @return imports list
*/
public List<Import> getImports() {
return imports;
}
/**
* Gets this file's script statements.
*
* @return script statement list
*/
public List<Statement> getStatements() {
return statements;
}
/**
* Gets the functions defined inside this file.
*
* @return script functions
*/
public Map<String, ParsedFunction> getFunctions() {
return functions;
}