robotcode-repl 2.9.0.dev51__tar.gz → 2.9.0.dev68__tar.gz

{robotcode_repl-2.9.0.dev51 → robotcode_repl-2.9.0.dev68}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: robotcode-repl
-Version: 2.9.0-dev.51
+Version: 2.9.0-dev.68
 Summary: RobotCode REPL for Robot Framework
 Project-URL: Homepage, https://robotcode.io
 Project-URL: Donate, https://opencollective.com/robotcode
@@ -27,7 +27,7 @@ Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: prompt-toolkit!=3.0.52
-Requires-Dist: robotcode-runner==2.9.0-dev.51
+Requires-Dist: robotcode-runner==2.9.0-dev.68
 Description-Content-Type: text/markdown
 
 # robotcode-repl

{robotcode_repl-2.9.0.dev51 → robotcode_repl-2.9.0.dev68}/pyproject.toml

@@ -29,7 +29,7 @@ classifiers = [
 ]
 dynamic = ["version"]
 dependencies = [
-  "robotcode-runner==2.9.0-dev.51",
+  "robotcode-runner==2.9.0-dev.68",
   "prompt_toolkit!=3.0.52"
 ]
 

robotcode_repl-2.9.0.dev68/src/robotcode/repl/__version__.py

@@ -0,0 +1 @@
+__version__ = "2.9.0-dev.68"

{robotcode_repl-2.9.0.dev51 → robotcode_repl-2.9.0.dev68}/src/robotcode/repl/base_interpreter.py

@@ -597,13 +597,19 @@ class BaseInterpreter(abc.ABC):
                     # Checked after marking the statement: a SIGTERM in between can't be missed.
                     if kw is None or self._termination_requested:
                         break
-                    self.set_last_result(self.run_keyword(kw))
+                    result = self.run_keyword(kw)
+                    self.set_last_result(result)
+                    self.show_result(kw, result)
                 finally:
                     self._running_statement = False
 
     def set_last_result(self, result: Any) -> None:
         self.last_result = result
 
+    def show_result(self, statement: Keyword, result: Any) -> None:
+        """Show the result of a statement of the input after it has run. Each interpreter knows how;
+        the REPL server returns results through its protocol."""
+
     @abc.abstractmethod
     def log_message(
         self, message: str, level: str, html: Union[str, bool] = False, timestamp: Union[datetime, str, None] = None

{robotcode_repl-2.9.0.dev51 → robotcode_repl-2.9.0.dev68}/src/robotcode/repl/cli.py

@@ -28,6 +28,7 @@ def _pick_interpreter(
     inspect: bool,
     no_history: bool,
     backend: str,
+    show_prompt: bool,
 ) -> ConsoleInterpreter:
     """Construct the interpreter that matches ``backend``.
 
@@ -43,6 +44,7 @@ def _pick_interpreter(
             show_keywords=show_keywords,
             inspect=inspect,
             no_history=no_history,
+            show_prompt=show_prompt,
         )
     if backend not in ("auto", "prompt-toolkit"):
         raise ValueError(f"Unknown backend: {backend!r}. Choose from {BACKEND_CHOICES}.")
@@ -52,6 +54,7 @@ def _pick_interpreter(
         show_keywords=show_keywords,
         inspect=inspect,
         no_history=no_history,
+        show_prompt=show_prompt,
     )
 
 
@@ -153,6 +156,20 @@ def _resolve_backend(plain: bool, backend: str) -> str:
     return backend
 
 
+def _resolve_show_prompt(show_prompt: Optional[bool]) -> bool:
+    """Whether `repl` shows its `>>> ` / `... ` prompt.
+
+    Always on an interactive terminal. Otherwise `--show-prompt` / `--no-show-prompt`
+    (or `ROBOTCODE_REPL_SHOW_PROMPT`) decides, and without either a recognised AI
+    agent gets the prompt: it marks where the output of a statement ends.
+    """
+    if _is_interactive_stdin():
+        return True
+    if show_prompt is not None:
+        return show_prompt
+    return is_running_in_ai_agent()
+
+
 def _resolve_attached(
     debugger_attached: Optional[bool],
     *,
@@ -302,6 +319,15 @@ SHELL_OPTIONS = [
         default=False,
         help="Activate inspection mode. This forces a prompt to appear after the REPL script is executed.",
     ),
+    click.option(
+        "--show-prompt/--no-show-prompt",
+        default=None,
+        envvar="ROBOTCODE_REPL_SHOW_PROMPT",
+        help="Show (`--show-prompt`) or hide (`--no-show-prompt`) the `>>>` prompt when the input is not a "
+        "terminal, such as piped input. Without either option it shows there only in the session of a "
+        "recognised AI agent, where it marks the end of each statement's output. On a terminal the prompt "
+        "always shows.",
+    ),
     click.option(
         "-d",
         "--outputdir",
@@ -430,6 +456,7 @@ def repl(
     pythonpath: Tuple[str, ...],
     show_keywords: bool,
     inspect: bool,
+    show_prompt: Optional[bool],
     no_history: bool,
     backend: str,
     plain: bool,
@@ -480,6 +507,7 @@ def repl(
         inspect=inspect,
         no_history=no_history,
         backend=backend,
+        show_prompt=_resolve_show_prompt(show_prompt),
     )
     # Only `repl` fails its session test on unhandled failures — not `robot-debug`,
     # which builds its interpreter the same way.
@@ -572,8 +600,15 @@ def robot_debug(
 
     backend = _resolve_backend(plain, backend)
 
+    # A run stops at `(rdb) `, which always shows; `robot-debug` has no option for `>>> `.
     interpreter = _pick_interpreter(
-        app=app, files=[], show_keywords=False, inspect=False, no_history=no_history, backend=backend
+        app=app,
+        files=[],
+        show_keywords=False,
+        inspect=False,
+        no_history=no_history,
+        backend=backend,
+        show_prompt=_is_interactive_stdin(),
     )
     controller = _attach_debugger(
         interpreter,

{robotcode_repl-2.9.0.dev51 → robotcode_repl-2.9.0.dev68}/src/robotcode/repl/console_interpreter.py

@@ -348,6 +348,7 @@ class ConsoleInterpreter(BaseInterpreter):
         show_keywords: bool = False,
         inspect: Optional[bool] = False,
         no_history: bool = False,
+        show_prompt: bool = False,
     ) -> None:
         del no_history  # plain mode has no history file to honour the flag against
         super().__init__()
@@ -356,6 +357,8 @@ class ConsoleInterpreter(BaseInterpreter):
         self.files = files
         self.show_keywords = show_keywords
         self.inspect = inspect
+        # Whether `>>> ` and `... ` show; `robotcode repl` decides it (`_resolve_show_prompt`).
+        self.show_prompt = show_prompt
 
         self.executed_files: List[Path] = []
         # REPL inputs that parsed cleanly — `.save` exports them as a
@@ -368,6 +371,8 @@ class ConsoleInterpreter(BaseInterpreter):
         # runs, then the session ends without reading again — on a terminal, a
         # read after Ctrl-D waits for more input instead of ending.
         self._input_ended = False
+        # Set while the statements of a script file run: like the body of a test, they show no results.
+        self._input_from_file = False
         # Set while a prompt waits for input: SIGTERM then ends the wait (`_end_waiting`).
         self._reading = False
 
@@ -868,7 +873,7 @@ class ConsoleInterpreter(BaseInterpreter):
                     self.set_last_result(self.run_keyword(kw))
         finally:
             self.record_failures = record_failures
-        self._echo(f"=> {_repr.repr(self.last_result)}")
+        self._echo_result(test.body[-1], self.last_result)
 
     # ------------------------------------------------------------------
     # Robot integration
@@ -892,6 +897,18 @@ class ConsoleInterpreter(BaseInterpreter):
             # than crash the REPL.
             pass
 
+    def show_result(self, statement: Keyword, result: Any) -> None:
+        if not self._input_from_file:
+            self._echo_result(statement, result)
+
+    def _echo_result(self, statement: Any, result: Any) -> None:
+        """Print the result of `statement` as `=> <value>`, at the `>>>` and the `(rdb)` prompt alike.
+        `None` shows nothing, and neither does an assignment: the message that sets the variable
+        names the value."""
+        if result is None or getattr(statement, "assign", None):
+            return
+        self._echo(f"=> {_repr.repr(result)}")
+
     def _alias_setting_imports(self, test: "running.TestCase") -> None:
         """REPL-only: rewrite top-level ``Library`` / ``Resource`` / ``Variables``
         keyword calls into the BuiltIn ``Import …`` keywords.
@@ -929,8 +946,10 @@ class ConsoleInterpreter(BaseInterpreter):
             text = file.read_text(encoding="utf-8")
 
             # Run like a test body: an invalid statement fails when execution reaches it.
+            self._input_from_file = True
             yield from self._body_to_run(self.parse_input(text))
         else:
+            self._input_from_file = False
             if self._input_ended:
                 raise EOFError
 
@@ -938,7 +957,7 @@ class ConsoleInterpreter(BaseInterpreter):
             last_one = False
             while True:
                 prompt = ""
-                if sys.stdin.isatty():
+                if self.show_prompt:
                     prompt = ">>> " if not lines else "... "
 
                 prefill = compute_indent(lines) if lines else ""

{robotcode_repl-2.9.0.dev51 → robotcode_repl-2.9.0.dev68}/src/robotcode/repl/prompt_toolkit_interpreter.py

@@ -67,6 +67,7 @@ class PromptToolkitConsoleInterpreter(ConsoleInterpreter):
         show_keywords: bool = False,
         inspect: Optional[bool] = False,
         no_history: bool = False,
+        show_prompt: bool = False,
     ) -> None:
         super().__init__(
             app=app,
@@ -74,6 +75,7 @@ class PromptToolkitConsoleInterpreter(ConsoleInterpreter):
             show_keywords=show_keywords,
             inspect=inspect,
             no_history=no_history,
+            show_prompt=show_prompt,
         )
 
         self._history_store: History

robotcode_repl-2.9.0.dev51/src/robotcode/repl/__version__.py

@@ -1 +0,0 @@
-__version__ = "2.9.0-dev.51"