Package org.daiitech.naftah.parser

Class REPLContext

java.lang.Object

org.daiitech.naftah.parser.DefaultContext

org.daiitech.naftah.parser.REPLContext

public class REPLContext
extends DefaultContext

REPLContext extends DefaultContext to provide a managed context environment for REPL (Read-Eval-Print Loop) execution.

It maintains an eternal context shared across all instances and supports registering and deregistering contexts with inheritance of variables, functions, and parse tree execution states.

Author:

Chakib Daii

Field Summary

Fields

Modifier and Type	Field	Description
protected static final DefaultContext	ETERNAL_CONTEXT	The eternal, shared base context for all REPL executions.

Fields inherited from class org.daiitech.naftah.parser.DefaultContext

ACCESSIBLE_CLASSES, ARABIC_CLASS_QUALIFIERS, arguments, ASYNC_BOOT_STRAP, awaitingTask, blockImports, BOOT_STRAP_FAILED, BOOT_STRAPPED, BUILTIN_FUNCTIONS, CACHE_PATH, CALL_STACK, CLASS_NAMES, CLASS_QUALIFIERS, CLASSES, CONTEXTS, creatingObject, CURRENT_CONTEXT, CURRENT_LOOKUP_JVM_CLASS_INITIALIZERS, CURRENT_LOOKUP_JVM_FUNCTIONS, CURRENT_TASK_SCOPE, declarationOfAssignment, depth, FORCE_BOOT_STRAP, functionCallId, functions, implementationName, implementations, IMPORTS, INSTANTIABLE_CLASSES, JVM_CLASS_INITIALIZERS, JVM_FUNCTIONS, LOADER_CONSUMER, LOADER_TASK, LOOP_STACK, loopLabel, loopVariables, MINIMAL_CACHE_PATH, MINIMAL_LOADER_CONSUMER, MINIMAL_LOADER_TASK, owner, parameters, parent, parseTreeExecution, parsingAssignment, parsingFunctionCallId, pendingRemoval, pendingTasks, SHOULD_BOOT_STRAP, variables

Constructor Summary

Constructors

Constructor	Description
REPLContext()

Method Summary

Modifier and Type	Method	Description
static void	clear()	Clears all REPL-related contexts.
static void	dropFunctions(String[] ids)	Removes the specified functions from the current REPL session.
static void	dropImplementations(String[] ids)	Removes the specified implementations (behaviors) from the current REPL session.
static void	dropImports(String[] ids)	Removes the specified imports from the REPL session.
static void	dropVariables(String[] ids)	Removes the specified variables from the current REPL session.
static Collection<DeclaredFunction<?>>	getFunctions()	Returns all declared functions in the current REPL session.
static Collection<DeclaredImplementation>	getImplementations()	Returns all declared implementations (behaviors) in the current REPL session.
static Collection<String>	getImports()	Returns all currently imported elements in the REPL session.
static Collection<DeclaredVariable>	getVariables()	Returns all declared variables in the current REPL session.
static DefaultContext	registerContext()	Registers a new context using the eternal context as the parent.
static DefaultContext	registerContext(Map<String,DeclaredParameter> parameters, Map<String,Object> arguments)	Registers a new context with specified parameters and arguments.
static DefaultContext	registerContext(DefaultContext parent)	Registers a new DefaultContext with the specified parent context.
static DefaultContext	registerContext(DefaultContext parent, Map<String,String> blockImports)	Registers a new DefaultContext with the specified parent context and an initial set of block imports.
static DefaultContext	registerContext(DefaultContext parent, Map<String,String> blockImports, Map<String,DeclaredParameter> parameters, Map<String,Object> arguments)	Registers a fully configured DefaultContext with the specified parent context, block imports, declared parameters, and argument values.

Methods inherited from class org.daiitech.naftah.parser.DefaultContext

bootstrap, callLoader, cleanClassThreadLocals, cleanThreadLocals, completeTask, containsDeclaredFunction, containsDeclaredImplementation, containsDeclaredImplementation, containsFunction, containsFunctionArgument, containsFunctionParameter, containsJvmClassInitializer, containsLocalVariable, containsLoopVariable, containsVariable, copyDeclarationsToParent, currentLoopLabel, defaultBootstrap, defineFunction, defineFunctionArgument, defineFunctionArguments, defineFunctionParameter, defineFunctionParameters, defineImplementation, defineImport, defineLoopVariable, defineVariable, defineVariables, deregisterContext, deregisterContext, deserializeClassScanningResult, doGetJavaType, endScope, generateCallId, generateLoopId, generateParameterOrArgumentName, getAccessibleClasses, getBuiltinFunctions, getChildren, getChildren, getClasses, getCompletions, getContextsByDepth, getCurrentContext, getCurrentLookupJvmClassInitializers, getCurrentLookupJvmFunctions, getDeclarationOfAssignment, getDeclaredImplementationFunction, getDepth, getFunction, getFunctionArgument, getFunctionArgumentName, getFunctionCallId, getFunctionParameter, getFunctionParameterName, getImplementationName, getInstantiableClasses, getJavaType, getJvmClassInitializer, getJvmClassInitializers, getJvmFunctions, getLoopLabel, getLoopLabels, getLoopVariable, getLoopVariableName, getLoopVariableNames, getParseTreeExecution, getSiblings, getVariable, getVariable, hasAnyExecutedChildOrSubChildOfType, isAwaitingTask, isCreatingObject, isExecuted, isParsingAssignment, isParsingFunctionCallId, lookupJvmClassInitializer, lookupJvmFunctions, loopContainsLabel, markExecuted, markForRemoval, matchImport, matchVariable, newNaftahBugExistentFunctionArgumentError, newNaftahBugExistentFunctionError, newNaftahBugExistentFunctionParameterError, newNaftahBugExistentImplementationError, newNaftahBugExistentVariableError, newNaftahBugForeachTargetDuplicatesError, newNaftahBugForeachTargetDuplicatesError, newNaftahBugVariableNotFoundError, newNaftahBugVariableNotFoundError, peekCall, popCall, popLoop, prepareLoopVariable, prepareParseTreeExecution, pushCall, pushLoop, putAllInBuiltinFunctions, registerContext, registerTask, removeLoopVariable, removeVariable, serializeClassScanningResult, setAwaitingTask, setBuiltinFunctions, setContextFromClassScanningResult, setCreatingObject, setCurrentContext, setCurrentLookupJvmClassInitializers, setCurrentLookupJvmFunctions, setDeclarationOfAssignment, setFunction, setFunctionArgument, setFunctionCallId, setFunctionParameter, setImplementation, setImplementationName, setLoopLabel, setLoopVariable, setParsingAssignment, setParsingFunctionCallId, setVariable, startScope, tryDeregisterContext

Methods inherited from class java.lang.Object

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

Field Details

ETERNAL_CONTEXT

protected static final DefaultContext ETERNAL_CONTEXT

The eternal, shared base context for all REPL executions.

Initialized statically with empty parameters and arguments, and prepared for parse tree execution.

Constructor Details

REPLContext

public REPLContext()

Method Details

registerContext

public static DefaultContext registerContext()

Registers a new context using the eternal context as the parent.

The new context is prepared for parse tree execution before returning.

Returns:

a new DefaultContext instance with ETERNAL_CONTEXT as parent

registerContext

public static DefaultContext registerContext(Map<String,DeclaredParameter> parameters,
 Map<String,Object> arguments)

Registers a new context with specified parameters and arguments.

The new context uses the eternal context as its parent. It is prepared for parse tree execution before returning.

Parameters:

parameters - the declared parameters for the new context

arguments - the argument values for the new context

Returns:

a new DefaultContext initialized with given parameters and arguments

registerContext

public static DefaultContext registerContext(DefaultContext parent)

Registers a new DefaultContext with the specified parent context.

The new context inherits configuration and state from the parent context, and is automatically prepared for parse tree execution before being returned.

Parameters:

parent - the parent DefaultContext of the new context; may be null

Returns:

a new DefaultContext instance linked to the specified parent

registerContext

public static DefaultContext registerContext(DefaultContext parent,
 Map<String,String> blockImports)

Registers a new DefaultContext with the specified parent context and an initial set of block imports.

The new context inherits its parent’s configuration and is initialized with the provided blockImports mapping. It is automatically prepared for parse tree execution before being returned.

Parameters:

parent - the parent DefaultContext of the new context; may be null

blockImports - a map of block-level imports to associate with the new context; may be null

Returns:

a new DefaultContext instance configured with the specified parent and block imports

registerContext

public static DefaultContext registerContext(DefaultContext parent,
 Map<String,String> blockImports,
 Map<String,DeclaredParameter> parameters,
 Map<String,Object> arguments)

Registers a fully configured DefaultContext with the specified parent context, block imports, declared parameters, and argument values.

This method provides the most flexible initialization for new contexts. The created context inherits from its parent, applies the given block imports, parameters, and argument mappings, and is automatically prepared for parse tree execution before being returned.

Parameters:

parent - the parent DefaultContext of the new context; may be null

blockImports - a map of block-level imports to associate with the new context; may be null

parameters - a map of declared parameters to register with the new context; may be null

arguments - a map of argument values corresponding to the declared parameters; may be null

Returns:

a new DefaultContext instance initialized with the specified configuration

clear

public static void clear()

Clears all REPL-related contexts.

This method performs two main actions:

1. Calls DefaultContext.clear() to remove all globally stored contexts.
2. Invokes DefaultContext.cleanThreadLocals() to reset any thread-local data associated with the REPL, preventing leakage across sessions.

After calling this method, the REPL state is fully reset and ready for a fresh session.

getImports

public static Collection<String> getImports()

Returns all currently imported elements in the REPL session.

Each import is returned as a string in the format: <imported_element> تحت_إسم <alias> (meaning "under the name").

Returns:

a collection of strings representing all imports and their aliases

dropImports

public static void dropImports(String[] ids)

Removes the specified imports from the REPL session.

Parameters:

ids - an array of import identifiers to remove; whitespace is trimmed

getVariables

public static Collection<DeclaredVariable> getVariables()

Returns all declared variables in the current REPL session.

Returns:

a collection of DeclaredVariable objects

dropVariables

public static void dropVariables(String[] ids)

Removes the specified variables from the current REPL session.

Parameters:

ids - an array of variable names to remove; whitespace is trimmed

getFunctions

public static Collection<DeclaredFunction<?>> getFunctions()

Returns all declared functions in the current REPL session.

Returns:

a collection of DeclaredFunction objects

dropFunctions

public static void dropFunctions(String[] ids)

Removes the specified functions from the current REPL session.

Parameters:

ids - an array of function names to remove; whitespace is trimmed

getImplementations

public static Collection<DeclaredImplementation> getImplementations()

Returns all declared implementations (behaviors) in the current REPL session.

Returns:

a collection of DeclaredImplementation objects

dropImplementations

public static void dropImplementations(String[] ids)

Removes the specified implementations (behaviors) from the current REPL session.

Parameters:

ids - an array of implementation names to remove; whitespace is trimmed