Module coneforest.psylla

Package coneforest.psylla.runtime

Class Interpreter

java.lang.Object

coneforest.psylla.runtime.Interpreter

All Implemented Interfaces:

PsyContext, PsyObject, Runnable

public class Interpreter
extends Object
implements PsyContext

The Psylla language interpreter.

Field Summary

Fields inherited from interface coneforest.psylla.core.PsyContext

PSY_BEGIN, PSY_CLEARDICTSTACK, PSY_CLEARSTACK, PSY_CLEARTOMARK, PSY_COPY, PSY_COUNTDICTSTACK, PSY_COUNTEXECSTACK, PSY_COUNTSTACK, PSY_COUNTTOMARK, PSY_CURRENTCONTEXT, PSY_CURRENTDICT, PSY_DEF, PSY_DICTSTACK, PSY_DUP, PSY_EDITLINE, PSY_END, PSY_EXCH, PSY_EXEC, PSY_EXECSTACK, PSY_EXECUTIVE, PSY_EXIT, PSY_FOR, PSY_FORK, PSY_HALT, PSY_IF, PSY_IFELSE, PSY_INDEX, PSY_JOIN, PSY_LOAD, PSY_LOOP, PSY_NAMESPACE, PSY_POP, PSY_PRETTYPRINT, PSY_PRINT, PSY_QUIT, PSY_REPEAT, PSY_REQUIRE, PSY_ROLL, PSY_SAY, PSY_SLEEP, PSY_STACK, PSY_STOP, PSY_STOPPED, PSY_STORE, PSY_TOKENS, PSY_WARN, PSY_WHERE, PSY_YIELD

Fields inherited from interface coneforest.psylla.core.PsyObject

PSY_CLONE, PSY_EQ, PSY_HASHCODE, PSY_INSTANCEOF, PSY_NE, PSY_TOSTRING, PSY_TOSTRINGBUFFER, PSY_TYPE

Constructor Summary

Constructors

Constructor	Description
Interpreter()	Creates a new Psylla language interpreter.

Method Summary

Modifier and Type	Method	Description
ClassLoader	classLoader()	Returns the interpreter’s class loader.
PsyFormalDict<PsyObject>	currentDict()	Returns the current dictionary (the topmost on the dictionary stack).
PsyNamespace	currentNamespace()	Returns the current namespace.
DictStack	dictStack()	Returns the dictionary stack.
PsyFormalDict<PsyObject>	errorDict()
int	execLevel()	Returns the size of the execution stack.
ExecutionStack	executionStack()	Returns the execution stack.
void	fork()
long	getId()
boolean	getStopped()	Returns the value of the stopped flag.
void	handleExecutionStack(int level)
void	interpret(PsyReader oReader)	Interprets the Psylla code from the reader object.
void	interpret(Reader reader)
void	interpret(String string)
void	interpretBraced(PsyReader oReader)
void	join()
void	join(long millis)
boolean	loadLibraryResource(String resourceName)
boolean	loadType(String typeName)
NamespacePool	namespacePool()	Returns the namespace pool.
OperandStack	operandStack()	Returns the operand stack.
OperandStack	operandStackBacked(int count)
String	prompt()	Returns the REPL prompt.
<T extends PsyObject> T	psyLoad(PsyTextual oKey)
void	psyRequire(PsyTextual oResourceName)
void	quit()
void	repl()
void	run()
void	setClassPath(String[] classPath)
void	setEnvironment(Map<String,String> env)
void	setErrorWriter(Writer writer)	Sets the interpreter’s standard error writer.
void	setLibraryPath(String[] libraryPath)
void	setRandomSeed(Long randomSeed)	Reseeds the interpreter’s standard pseudorandom generator, using the given seed.
void	setReader(Reader reader)	Sets the interpreter’s standard reader.
void	setScriptName(String scriptName)
void	setShellArguments(String[] args)
void	setStopped(boolean stopped)	Sets the stopped flag to the specified value.
void	setWriter(Writer writer)	Sets the interpreter’s standard writer.
void	showStacks(PrintWriter pw)
void	start()
void	stop()
PsyFormalDict<PsyObject>	systemDict()	Returns the system dictionary.
PsyFormalDict<PsyObject>	userDict()	Returns the user dictionary.

Methods inherited from class java.lang.Object

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

Methods inherited from interface coneforest.psylla.core.PsyContext

psyCurrentContext, psyWhere, toSyntaxString

Methods inherited from interface coneforest.psylla.core.PsyObject

convert, execute, invoke, psyClone, psyEq, psyHashCode, psyInstanceOf, psyNe, psySyntax, psyToString, psyToStringBuffer, psyType, typeName

Constructor Details

Interpreter

public Interpreter()

Creates a new Psylla language interpreter.

Method Details

fork

public void fork()
          throws PsyStackUnderflowException,
PsyUnmatchedMarkException

Specified by:

fork in interface PsyContext

Throws:

PsyStackUnderflowException

PsyUnmatchedMarkException

operandStack

public OperandStack operandStack()

Description copied from interface: PsyContext

Returns the operand stack.

Specified by:

operandStack in interface PsyContext

Returns:

the operand stack

operandStackBacked

public OperandStack operandStackBacked(int count)
                                throws PsyStackUnderflowException

Specified by:

operandStackBacked in interface PsyContext

Throws:

PsyStackUnderflowException

dictStack

public DictStack dictStack()

Description copied from interface: PsyContext

Returns the dictionary stack.

Specified by:

dictStack in interface PsyContext

Returns:

the dictionary stack

executionStack

public ExecutionStack executionStack()

Description copied from interface: PsyContext

Returns the execution stack.

Specified by:

executionStack in interface PsyContext

Returns:

the execution stack

classLoader

public ClassLoader classLoader()

Returns the interpreter’s class loader.

Returns:

the interpreter’s class loader

psyLoad

public <T extends PsyObject> T psyLoad(PsyTextual oKey)
                                throws PsyUndefinedException

Specified by:

psyLoad in interface PsyContext

Throws:

PsyUndefinedException

handleExecutionStack

public void handleExecutionStack(int level)

Specified by:

handleExecutionStack in interface PsyContext

currentDict

public PsyFormalDict<PsyObject> currentDict()

Description copied from interface: PsyContext

Returns the current dictionary (the topmost on the dictionary stack).

Specified by:

currentDict in interface PsyContext

Returns:

the current dictionary (the topmost on the dictionary stack)

systemDict

public PsyFormalDict<PsyObject> systemDict()

Description copied from interface: PsyContext

Returns the system dictionary.

Specified by:

systemDict in interface PsyContext

Returns:

the system dictionary

userDict

public PsyFormalDict<PsyObject> userDict()

Description copied from interface: PsyContext

Returns the user dictionary.

Specified by:

userDict in interface PsyContext

Returns:

the user dictionary

namespacePool

public NamespacePool namespacePool()

Description copied from interface: PsyContext

Returns the namespace pool.

Specified by:

namespacePool in interface PsyContext

Returns:

the namespace pool

currentNamespace

public PsyNamespace currentNamespace()

Returns the current namespace.

Returns:

the current namespace

setReader

public void setReader(Reader reader)

Sets the interpreter’s standard reader.

Parameters:

reader - the reader.

setWriter

public void setWriter(Writer writer)

Sets the interpreter’s standard writer.

Parameters:

writer - the writer.

setErrorWriter

public void setErrorWriter(Writer writer)

Sets the interpreter’s standard error writer.

Parameters:

writer - the error writer.

setRandomSeed

public void setRandomSeed(Long randomSeed)
                   throws PsyUndefinedException

Reseeds the interpreter’s standard pseudorandom generator, using the given seed.

Parameters:

randomSeed - the seed.

Throws:

PsyUndefinedException - when TODO

setClassPath

public void setClassPath(String[] classPath)
                  throws PsyLimitCheckException,
PsyRangeCheckException,
PsyUndefinedException

Throws:

PsyLimitCheckException

PsyRangeCheckException

PsyUndefinedException

setLibraryPath

public void setLibraryPath(String[] libraryPath)
                    throws PsyLimitCheckException,
PsyRangeCheckException,
PsyUndefinedException

Throws:

PsyLimitCheckException

PsyRangeCheckException

PsyUndefinedException

interpret

public void interpret(Reader reader)

interpret

public void interpret(String string)

interpret

public void interpret(PsyReader oReader)

Description copied from interface: PsyContext

Interprets the Psylla code from the reader object.

Specified by:

interpret in interface PsyContext

Parameters:

oReader - the reader object.

interpretBraced

public void interpretBraced(PsyReader oReader)
                     throws PsyLimitCheckException

Specified by:

interpretBraced in interface PsyContext

Throws:

PsyLimitCheckException

errorDict

public PsyFormalDict<PsyObject> errorDict()
                                   throws PsyUndefinedException

Throws:

PsyUndefinedException

showStacks

public void showStacks(PrintWriter pw)

Specified by:

showStacks in interface PsyContext

execLevel

public int execLevel()

Description copied from interface: PsyContext

Returns the size of the execution stack.

Specified by:

execLevel in interface PsyContext

Returns:

the size of the execution stack

getStopped

public boolean getStopped()

Description copied from interface: PsyContext

Returns the value of the stopped flag.

Specified by:

getStopped in interface PsyContext

Returns:

the value of the stopped flag

setStopped

public void setStopped(boolean stopped)

Description copied from interface: PsyContext

Sets the stopped flag to the specified value.

Specified by:

setStopped in interface PsyContext

Parameters:

stopped - the value of the stopped flag.

setScriptName

public void setScriptName(String scriptName)

setShellArguments

public void setShellArguments(String[] args)
                       throws PsyLimitCheckException,
PsyUndefinedException

Throws:

PsyLimitCheckException

PsyUndefinedException

setEnvironment

public void setEnvironment(Map<String,String> env)

quit

public void quit()

Specified by:

quit in interface PsyContext

repl

public void repl()
          throws PsyIOErrorException

Specified by:

repl in interface PsyContext

Throws:

PsyIOErrorException

prompt

public String prompt()

Returns the REPL prompt.

Returns:

the REPL prompt

start

public void start()

run

public void run()

Specified by:

run in interface Runnable

join

public void join()
          throws InterruptedException

Specified by:

join in interface PsyContext

Throws:

InterruptedException

join

public void join(long millis)
          throws InterruptedException

Throws:

InterruptedException

getId

public long getId()

Specified by:

getId in interface PsyContext

stop

public void stop()

Specified by:

stop in interface PsyContext

loadLibraryResource

public boolean loadLibraryResource(String resourceName)
                            throws PsyFileAccessDeniedException,
PsyFileNotFoundException,
PsyIOErrorException,
PsySecurityErrorException,
PsyUndefinedException,
PsyErrorException

Throws:

PsyFileAccessDeniedException

PsyFileNotFoundException

PsyIOErrorException

PsySecurityErrorException

PsyUndefinedException

PsyErrorException

loadType

public boolean loadType(String typeName)

psyRequire

public void psyRequire(PsyTextual oResourceName)
                throws PsyFileAccessDeniedException,
PsyFileNotFoundException,
PsyIOErrorException,
PsySecurityErrorException,
PsyUndefinedException,
PsyErrorException

Specified by:

psyRequire in interface PsyContext

Throws:

PsyFileAccessDeniedException

PsyFileNotFoundException

PsyIOErrorException

PsySecurityErrorException

PsyUndefinedException

PsyErrorException