Module coneforest.psylla

Package coneforest.psylla.runtime

Class Interpreter

java.lang.Object

java.lang.Thread

coneforest.psylla.runtime.Interpreter

All Implemented Interfaces:

PsyContext, PsyObject, Runnable

public class Interpreter
extends Thread
implements PsyContext

The Psylla language interpreter.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

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_TONAME, PSY_TOSTRING, PSY_TYPE

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
String	banner()	Returns the Psylla banner.
ClassLoader	classLoader()	Returns the interpreter’s class loader.
PsyFormalDict	currentDict()	Returns the current dictionary (the topmost on the dictionary stack).
int	currentLoopLevel()	Returns the topmost execution level at the loop stack or -1 if the loop stack is empty.
PsyNamespace	currentNamespace()	Returns the current namespace.
int	currentStopLevel()	Returns the topmost execution level at the stop stack or -1 if the stop stack is empty.
DictStack	dictStack()	Returns the dictionary stack.
PsyFormalDict	errorDict()
int	execLevel()	Returns the size of the execution stack.
ExecutionStack	executionStack()	Returns the execution stack.
void	fork()
boolean	getStopped()	Gets the stopped flag to the specified value.
void	handleExecutionStack(int level)
void	interpret(PsyReader oReader)
void	interpret(Reader reader)
void	interpret(String string)
void	interpretBraced(PsyReader oReader)
<T extends PsyObject> T	load(String name)
boolean	loadLibraryResource(String resourceName)
boolean	loadType(String typeName)
NamespacePool	namespacePool()	Returns the namespace pool.
OperandStack	operandStack()	Returns the operand stack.
OperandStack	operandStackBacked(int count)
int	popLoopLevel()	Removes the execution level from the loop stack and returns this level or -1 if the loop stack is empty.
int	popStopLevel()	Removes the execution level from the stop stack and returns this level or -1 if the stop stack is empty.
String	prompt()	Returns the REPL prompt.
<T extends PsyObject> T	psyLoad(PsyTextual oKey)
void	psyRequire(PsyTextual oResourceName)
int	pushLoopLevel()	Pushes the current execution level onto the loop stack and returns this level.
int	pushStopLevel()	Pushes the current execution level onto the stop stack and returns this level.
void	quit()
void	repl()
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)
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()
void	stop_()
PsyFormalDict	systemDict()	Returns the system dictionary.
PsyFormalDict	userDict()	Returns the user dictionary.

Methods inherited from class java.lang.Thread

activeCount, checkAccess, countStackFrames, currentThread, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, onSpinWait, resume, run, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Methods inherited from interface coneforest.psylla.core.PsyContext

getId, join, psyWhere, toSyntaxString

Methods inherited from interface coneforest.psylla.core.PsyObject

convert, execute, invoke, psyClone, psyEq, psyHashCode, psyInstanceOf, psyNe, psySyntax, psyToName, psyToString, 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.

load

public <T extends PsyObject> T load(String name)
                             throws PsyUndefinedException

Throws:

PsyUndefinedException

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 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.

systemDict

public PsyFormalDict systemDict()

Description copied from interface: PsyContext

Returns the system dictionary.

Specified by:

systemDict in interface PsyContext

Returns:

the system dictionary.

userDict

public PsyFormalDict 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

Throws:

PsyUndefinedException

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)

Specified by:

interpret in interface PsyContext

interpretBraced

public void interpretBraced(PsyReader oReader)
                     throws PsyLimitCheckException

Specified by:

interpretBraced in interface PsyContext

Throws:

PsyLimitCheckException

errorDict

public PsyFormalDict errorDict()
                        throws PsyUndefinedException

Throws:

PsyUndefinedException

showStacks

public void showStacks()

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

Gets the stopped flag to the specified value.

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.

pushLoopLevel

public int pushLoopLevel()

Description copied from interface: PsyContext

Pushes the current execution level onto the loop stack and returns this level.

Specified by:

pushLoopLevel in interface PsyContext

Returns:

the current execution level.

popLoopLevel

public int popLoopLevel()

Description copied from interface: PsyContext

Removes the execution level from the loop stack and returns this level or -1 if the loop stack is empty.

Specified by:

popLoopLevel in interface PsyContext

Returns:

the execution level on the top of the loop stack or -1 if the loop stack is empty.

currentLoopLevel

public int currentLoopLevel()

Description copied from interface: PsyContext

Returns the topmost execution level at the loop stack or -1 if the loop stack is empty.

Specified by:

currentLoopLevel in interface PsyContext

Returns:

the topmost execution level at the loop stack or -1 if the loop stack is empty.

pushStopLevel

public int pushStopLevel()

Description copied from interface: PsyContext

Pushes the current execution level onto the stop stack and returns this level.

Specified by:

pushStopLevel in interface PsyContext

Returns:

the current execution level.

popStopLevel

public int popStopLevel()

Description copied from interface: PsyContext

Removes the execution level from the stop stack and returns this level or -1 if the stop stack is empty.

Specified by:

popStopLevel in interface PsyContext

Returns:

the execution level on the top of the stop stack or -1 if the stop stack is empty.

currentStopLevel

public int currentStopLevel()

Description copied from interface: PsyContext

Returns the topmost execution level at the stop stack or -1 if the stop stack is empty.

Specified by:

currentStopLevel in interface PsyContext

Returns:

the topmost execution level at the stop stack or -1 if the stop stack is empty.

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

banner

public String banner()

Returns the Psylla banner.

Returns:

the banner.

prompt

public String prompt()

Returns the REPL prompt.

Returns:

the REPL prompt.

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