Package nz.org.riskscape.rl

Class ExpressionParser

java.lang.Object

nz.org.riskscape.rl.ExpressionParser

public class ExpressionParser
extends Object

Methods for parsing PipelineDeclarations and Expressions from a source string.

Field Summary

Fields

Modifier and Type	Field	Description
static final EnumSet<TokenTypes>	IDENTIFIERS	Used with ConditionalParse
static final ExpressionParser	INSTANCE
static final EnumSet<TokenTypes>	KEY_IDENTIFIERS	Used with ConditionalParse
static final EnumSet<TokenTypes>	LEADING_TOKENS	The list of tokens that typically start any expression
static final EnumSet<TokenTypes>	LITERALS	All of the things that can be inside a Constant

Constructor Summary

Constructors

Constructor	Description
ExpressionParser()

Method Summary

Modifier and Type	Method	Description
protected Lexer<TokenTypes>	lex(Source source)	Lexes source with the TokenTypes.tokens().
ResultOrProblems<Expression>	parse(Source source)	Parses the given string in to an Expression.
Expression	parseExpression(Lexer<TokenTypes> lexer)
FunctionCall	parseFunctionExpression(Lexer<TokenTypes> lexer)
static Map<String,Expression>	parseMap(Map<String,String> unparsed)	Parameter-map friendly of parseString.
ResultOrProblems<PipelineDeclaration>	parsePipeline(Source source)	Parses a PipelineDeclaration from a Source object
ResultOrProblems<PipelineDeclaration>	parsePipeline(Resource resource)	Parses a PipelineDeclaration from a Resource object, catching io exceptions and returning them as problems instead
static PipelineDeclaration	parsePipelineString(String source)	Convenience function to parse a pipeline for tests where you aren't expecting errors
PropertyAccess	parsePropertyExpression(Lexer<TokenTypes> lexer, Optional<Expression> receiver)
static Expression	parseString(String source)	Convenience form of new ExpressionParser().parse(source).get() used for tests and cases where you don't expect parsing to throw errors (e.g.
ListDeclaration	toList(Expression expr)	Return a version of the given expression as a ListDeclaration.
StructDeclaration	toStruct(Expression expr)	Return a version of the given expression as a struct.

Methods inherited from class java.lang.Object

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

Field Details

INSTANCE

public static final ExpressionParser INSTANCE

IDENTIFIERS

public static final EnumSet<TokenTypes> IDENTIFIERS

Used with ConditionalParse

KEY_IDENTIFIERS

public static final EnumSet<TokenTypes> KEY_IDENTIFIERS

Used with ConditionalParse

LITERALS

public static final EnumSet<TokenTypes> LITERALS

All of the things that can be inside a Constant

LEADING_TOKENS

public static final EnumSet<TokenTypes> LEADING_TOKENS

The list of tokens that typically start any expression

NB this is 'derived', which kind of sucks, but it's just for debugging/error messages

Constructor Details

ExpressionParser

public ExpressionParser()

Method Details

parseString

public static Expression parseString(String source)

Convenience form of new ExpressionParser().parse(source).get() used for tests and cases where you don't expect parsing to throw errors (e.g. source isn't from the user)

parseMap

public static Map<String,Expression> parseMap(Map<String,String> unparsed)

Parameter-map friendly of parseString.

Returns:

a map of parsed expressions

parsePipelineString

public static PipelineDeclaration parsePipelineString(String source)

Convenience function to parse a pipeline for tests where you aren't expecting errors

parse

public ResultOrProblems<Expression> parse(Source source)

Parses the given string in to an Expression.

Returns:

an Expression from the given string, or a problem if it failed

toStruct

public StructDeclaration toStruct(Expression expr)

Return a version of the given expression as a struct. If it's already a struct declaration it is returned as is, otherwise a simple anonymous struct declaration is put around it.

toList

public ListDeclaration toList(Expression expr)

Return a version of the given expression as a ListDeclaration. If expression is a ListDeclaration it is returned as is, otherwise a ListDeclaration is returned containing expression as the single item.

lex

protected Lexer<TokenTypes> lex(Source source)

Lexes source with the TokenTypes.tokens().

Parameters:

source - to lex

parseExpression

public Expression parseExpression(Lexer<TokenTypes> lexer)

parseFunctionExpression

public FunctionCall parseFunctionExpression(Lexer<TokenTypes> lexer)

parsePropertyExpression

public PropertyAccess parsePropertyExpression(Lexer<TokenTypes> lexer,
 Optional<Expression> receiver)

parsePipeline

public ResultOrProblems<PipelineDeclaration> parsePipeline(Resource resource)

Parses a PipelineDeclaration from a Resource object, catching io exceptions and returning them as problems instead

parsePipeline

public ResultOrProblems<PipelineDeclaration> parsePipeline(Source source)

Parses a PipelineDeclaration from a Source object