Package org.eclipse.ease
Interface IDebugEngine
- All Superinterfaces:
IScriptEngine
- All Known Subinterfaces:
IPythonDebugEngine
- All Known Implementing Classes:
Py4jDebuggerEngine
,TestSuiteScriptEngine
public interface IDebugEngine extends IScriptEngine
Interface to be implemented by a script debug engine.
-
Field Summary
Fields inherited from interface org.eclipse.ease.IScriptEngine
TRACE_SCRIPT_ENGINE
-
Method Summary
Modifier and Type Method Description ScriptStackTrace
getExceptionStackTrace()
Get the stack trace of the last thrown exception of the current thread.ScriptStackTrace
getExceptionStackTrace(Object thread)
Get the stack trace of the last thrown exception of the given thread.ScriptStackTrace
getStackTrace()
Get the current stack trace.Collection<EaseDebugVariable>
getVariables(Object scope)
Get variables within a specific scope or child elements for a given object.Object
removeVariable(String name)
Remove a variable from the scope.void
setupDebugger(org.eclipse.debug.core.ILaunch launch, boolean suspendOnStartup, boolean suspendOnScriptLoad, boolean showDynamicCode)
Methods inherited from interface org.eclipse.ease.IScriptEngine
addExecutionListener, addSecurityCheck, execute, getDescription, getErrorStream, getExecutedFile, getInputStream, getLaunch, getMonitor, getName, getOutputStream, getVariable, getVariables, hasVariable, inject, isFinished, joinEngine, joinEngine, registerJar, removeExecutionListener, schedule, setCloseStreamsOnTerminate, setErrorStream, setInputStream, setOutputStream, setVariable, terminate, terminateCurrent
-
Method Details
-
getStackTrace
ScriptStackTrace getStackTrace()Get the current stack trace. A trace is a stack starting with the root file executed by the engine. Function calls and files (called via include command) will be put on top of that stack. Each entry may contain a pointer to the current line number executed. Traces might be created dynamically on demand or accumulated during execution depending on the underlying engine.- Returns:
- current stack trace
-
getExceptionStackTrace
ScriptStackTrace getExceptionStackTrace()Get the stack trace of the last thrown exception of the current thread. Will be populated when an exception is thrown by the script engine. Can be evaluated in a try/catch statement within the script. Only available during script runtime.- Returns:
- last exception stack trace or
null
-
getExceptionStackTrace
Get the stack trace of the last thrown exception of the given thread. Will be populated when an exception is thrown by the script engine. Can be evaluated in a try/catch statement within the script. Only available during script runtime.- Parameters:
thread
- thread to get last exception stacktrace from- Returns:
- last exception stack trace or
null
-
setupDebugger
void setupDebugger(org.eclipse.debug.core.ILaunch launch, boolean suspendOnStartup, boolean suspendOnScriptLoad, boolean showDynamicCode) -
removeVariable
Remove a variable from the scope.- Parameters:
name
- variable to be removed.- Returns:
- variable content
-
getVariables
Get variables within a specific scope or child elements for a given object.- Parameters:
scope
- scope or parent object- Returns:
- variables assigned to scope
-