Package fmpp.tdd

Class Interpreter

java.lang.Object

fmpp.tdd.Interpreter

public class Interpreter
extends Object

Evaluates TDD expressions.

Field Summary

Fields

Modifier and Type	Field	Description
static final EvaluationEnvironment	SIMPLE_EVALUATION_ENVIRONMENT	Evaluates function calls to itself.

Method Summary

Modifier and Type	Method	Description
static String	dump(Object value)	Converts an object to a TDD-like representation (not necessary valid TDD).
static Object	eval(Fragment fragment, EvaluationEnvironment ee, boolean forceStringValues)	Evaluates a Fragment as single TDD expression.
static Object	eval(String text)	Same as eval(text, null, false, null).
static Object	eval(String text, EvaluationEnvironment ee, boolean forceStringValues, String fileName)	Evaluates text as single TDD expression.
static Object	eval(String text, String fileName)	Same as eval(text, null, false, fileName).
static Map	evalAsHash(String text)	Same as evalAsHash(text, null, false, null).
static Map	evalAsHash(String text, EvaluationEnvironment ee, boolean forceStringValues, String fileName)	Evaluates text as a list of key:value pairs.
static Map	evalAsHash(String text, String fileName)	Same as evalAsHash(text, null, false, fileName).
static List	evalAsSequence(String text)	Same as evalAsList(text, null, false, null).
static List	evalAsSequence(String text, EvaluationEnvironment ee, boolean forceStringValues, String fileName)	Evaluates text as a list values.
static List	evalAsSequence(String text, String fileName)	Same as evalAsList(text, null, false, fileName).
EvaluationEnvironment	getEvaluationEnvironment()
String	getFileName()
int	getPosition()
String	getText()
static String	getTypeName(Object value)
static String	loadTdd(byte[] b, String defaultEncoding)	Loads a TDD file with utilizing #encoding:enc header.
static String	loadTdd(InputStream in, String defaultEncoding)	Loads a TDD file with utilizing #encoding:enc header.

Methods inherited from class java.lang.Object

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

Field Details

SIMPLE_EVALUATION_ENVIRONMENT

public static final EvaluationEnvironment SIMPLE_EVALUATION_ENVIRONMENT

Evaluates function calls to itself.

Method Details

eval

public static Object eval(String text,
 EvaluationEnvironment ee,
 boolean forceStringValues,
 String fileName)
                   throws EvalException

Evaluates text as single TDD expression.

Parameters:

text - the text to interpret.

ee - the EvaluationEnvironment used to resolve function calls. If it is null then SIMPLE_EVALUATION_ENVIRONMENT will be used.

forceStringValues - specifies if expressions as true and 123 should be interpreted as strings, or as boolean and number respectively.

fileName - the path of the source file, or other description of the source. It is used for informative purposes only, as in error messages.

Returns:

the result of the evaluation. Possibly an empty Map, but never null.

Throws:

EvalException

eval

public static Object eval(Fragment fragment,
 EvaluationEnvironment ee,
 boolean forceStringValues)
                   throws EvalException

Evaluates a Fragment as single TDD expression. The expression can be surrounded with superfluous white-space.

Throws:

EvalException

See Also:

• eval(String, EvaluationEnvironment, boolean, String)

eval

public static Object eval(String text,
 String fileName)
                   throws EvalException

Same as eval(text, null, false, fileName).

Throws:

EvalException

See Also:

• eval(String, EvaluationEnvironment, boolean, String)

eval

public static Object eval(String text)
                   throws EvalException

Same as eval(text, null, false, null).

Throws:

EvalException

See Also:

• eval(String, EvaluationEnvironment, boolean, String)

evalAsHash

public static Map evalAsHash(String text,
 EvaluationEnvironment ee,
 boolean forceStringValues,
 String fileName)
                      throws EvalException

Evaluates text as a list of key:value pairs.

Parameters:

text - the text to interpret.

ee - the EvaluationEnvironment used to resolve function calls. If it is null then SIMPLE_EVALUATION_ENVIRONMENT will be used.

forceStringValues - specifies if expressions as true and 123 should be interpreted as strings, or as boolean and number respectively.

fileName - the path of the source file, or other description of the source. It is used for informative purposes only, as in error messages.

Returns:

the result of the evaluation. Possibly an empty Map, but never null.

Throws:

EvalException

evalAsHash

public static Map evalAsHash(String text)
                      throws EvalException

Same as evalAsHash(text, null, false, null).

Throws:

EvalException

See Also:

• evalAsHash(String, EvaluationEnvironment, boolean, String)

evalAsHash

public static Map evalAsHash(String text,
 String fileName)
                      throws EvalException

Same as evalAsHash(text, null, false, fileName).

Throws:

EvalException

See Also:

• evalAsHash(String, EvaluationEnvironment, boolean, String)

evalAsSequence

public static List evalAsSequence(String text,
 EvaluationEnvironment ee,
 boolean forceStringValues,
 String fileName)
                           throws EvalException

Evaluates text as a list values.

Parameters:

text - the text to interpret.

ee - the EvaluationEnvironment used to resolve function calls. If it is null then SIMPLE_EVALUATION_ENVIRONMENT will be used.

forceStringValues - specifies if expressions as true and 123 should be interpreted as strings, or as boolean and number respectively.

fileName - the path of the source file, or other description of the source. It is used for informative purposes only, as in error messages.

Returns:

the result of the evaluation. Possibly an empty List, but never null.

Throws:

EvalException

evalAsSequence

public static List evalAsSequence(String text)
                           throws EvalException

Same as evalAsList(text, null, false, null).

Throws:

EvalException

See Also:

• evalAsSequence(String, EvaluationEnvironment, boolean, String)

evalAsSequence

public static List evalAsSequence(String text,
 String fileName)
                           throws EvalException

Same as evalAsList(text, null, false, fileName).

Throws:

EvalException

See Also:

• evalAsSequence(String, EvaluationEnvironment, boolean, String)

loadTdd

public static String loadTdd(InputStream in,
 String defaultEncoding)
                      throws IOException

Loads a TDD file with utilizing #encoding:enc header. If the header is missing, the encoding given as parameter is used.

Parameters:

in - the stream that reads the content of the file.

Throws:

IOException

loadTdd

public static String loadTdd(byte[] b,
 String defaultEncoding)
                      throws IOException

Loads a TDD file with utilizing #encoding:enc header. If the header is missing, the encoding given as parameter is used.

Parameters:

b - the content of the file.

Throws:

IOException

dump

public static String dump(Object value)

Converts an object to a TDD-like representation (not necessary valid TDD).

Parameters:

value - the object to convert

Returns:

the TDD "source code".

getTypeName

public static String getTypeName(Object value)

getPosition

public int getPosition()

getText

public String getText()

getFileName

public String getFileName()

getEvaluationEnvironment

public EvaluationEnvironment getEvaluationEnvironment()