Camel.interpreters.internal python interpreter

​

InternalPythonInterpreter

class InternalPythonInterpreter(BaseInterpreter):

• action_space (Dict[str, Any], optional): A dictionary that maps action names to their corresponding functions or objects. The interpreter can only execute functions that are either directly listed in this dictionary or are member functions of objects listed in this dictionary. The concept of :obj:action_space is derived from EmbodiedAgent, representing the actions that an agent is capable of performing. If None, set to empty dict. (default: :obj:None)
• import_white_list (List[str], optional): A list that stores the Python modules or functions that can be imported in the code. All submodules and functions of the modules listed in this list are importable. Any other import statements will be rejected. The module and its submodule or function name are separated by a period (:obj:.). (default: :obj:None)
• unsafe_mode (bool, optional): If True, the interpreter runs the code by eval() or exec() without any security check. (default: :obj:False)
• raise_error (bool, optional): Raise error if the interpreter fails. (default: :obj:False)
• allow_builtins (bool, optional): If True, safe built-in functions like print, len, str, etc. are added to the action space. (default: :obj:True)

​

init

def __init__(
    self,
    action_space: Optional[Dict[str, Any]] = None,
    import_white_list: Optional[List[str]] = None,
    unsafe_mode: bool = False,
    raise_error: bool = False,
    allow_builtins: bool = True
):

​

_add_safe_builtins

def _add_safe_builtins(self):

​

run

def run(self, code: str, code_type: str = 'python'):

• code (str): The python code to be executed.
• code_type (str): The type of the code, which should be one of the supported code types (python, py, python3, python2). (default: obj:python)

​

update_action_space

def update_action_space(self, action_space: Dict[str, Any]):

​

supported_code_types

def supported_code_types(self):

​

execute

def execute(
    self,
    code: str,
    state: Optional[Dict[str, Any]] = None,
    fuzz_state: Optional[Dict[str, Any]] = None,
    keep_state: bool = True
):

• code (str): Generated python code to be executed.
• state (Optional[Dict[str, Any]], optional): External variables that may be used in the generated code. (default: :obj:None)
• fuzz_state (Optional[Dict[str, Any]], optional): External variables that do not have certain variable names. The interpreter will use fuzzy matching to access these variables. For example, if :obj:fuzz_state has a variable :obj:image, the generated code can use :obj:input_image to access it. (default: :obj:None)
• keep_state (bool, optional): If :obj:True, :obj:state and :obj:fuzz_state will be kept for later execution. Otherwise, they will be cleared. (default: :obj:True)

​

clear_state

def clear_state(self):

​

_execute_ast

def _execute_ast(self, expression: ast.AST):

​

_execute_assign

def _execute_assign(self, assign: ast.Assign):

​

_assign

def _assign(self, target: ast.expr, value: Any):

​

_execute_call

def _execute_call(self, call: ast.Call):

​

_execute_subscript

def _execute_subscript(self, subscript: ast.Subscript):

​

_execute_name

def _execute_name(self, name: ast.Name):

​

_execute_condition

def _execute_condition(self, condition: ast.Compare):

​

_execute_if

def _execute_if(self, if_statement: ast.If):

​

_execute_for

def _execute_for(self, for_statement: ast.For):

​

_execute_import

def _execute_import(self, import_module: ast.Import):

​

_execute_import_from

def _execute_import_from(self, import_from: ast.ImportFrom):

​

_validate_import

def _validate_import(self, full_name: str):

​

_execute_binop

def _execute_binop(self, binop: ast.BinOp):

​

_execute_unaryop

def _execute_unaryop(self, unaryop: ast.UnaryOp):

​

_get_value_from_state

def _get_value_from_state(self, key: str):

​

execute_command

def execute_command(self, command: str):

• command (str): The command to execute.