robotcode-repl 2.8.0.dev677__py3-none-any.whl → 2.9.0.dev68__py3-none-any.whl

robotcode/repl/__version__.py

@@ -1 +1 @@
-__version__ = "2.8.0-dev.677"
+__version__ = "2.9.0-dev.68"

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/cli.py

@@ -10,7 +10,7 @@ from robotcode.plugin._agent_detection import is_running_in_ai_agent
 from robotcode.plugin.click_helper.aliases import AliasedCommand
 from robotcode.plugin.click_helper.types import add_options
 from robotcode.plugin.click_helper.wrappable import wrappable
-from robotcode.runner.cli.robot import ROBOT_OPTIONS, ROBOT_VERSION_OPTIONS
+from robotcode.runner.cli.robot import ROBOT_OPTIONS, ROBOT_VERSION_OPTIONS, load_robot_profile
 
 from .__version__ import __version__
 from ._backends import BACKEND_CHOICES
@@ -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,
@@ -456,6 +483,9 @@ def repl(
     if files:
         files = tuple(f.absolute() for f in files)
 
+    # Before the interpreter is created, so that the session runs under the `wrapper`.
+    load_robot_profile(app, tuple(str(f) for f in files))
+
     # The shell starts with the debugger *detached* — a failing keyword prints
     # its error and you stay at the prompt — unless a pause trigger was given
     # (then attach so `--break …` just works) or `--debugger-attached` forces it.
@@ -477,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.
@@ -559,6 +590,9 @@ def robot_debug(
     Takes the same arguments as `robotcode robot`, but pauses at breakpoints so
     you can inspect and step through the run at a debug prompt.
     """
+    # Before the interpreter and the debugger are created, so that the run runs under the `wrapper`.
+    load_robot_profile(app, robot_options_and_args)
+
     # Debugging a real run: the debugger is attached by default (the point of the
     # command), breaking on the first uncaught failure unless turned off. Only an
     # explicit `--no-debugger-attached` detaches it (then it runs like `robot`).
@@ -566,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/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/doc_cli.py

@@ -88,6 +88,8 @@ class KeywordEntry:
     short_doc: str
     tags: List[str]
     doc: str
+    source: str
+    lineno: int
 
 
 @dataclass
@@ -394,6 +396,8 @@ def _keyword_entries(library: LibraryDoc, page: str, keywords: List[KeywordDoc])
             short_doc=_one_line(kw.format_text(getshortdoc(kw.doc))),
             tags=list(kw.tags),
             doc=kw.format_text(kw.doc),
+            source=kw.source or "",
+            lineno=kw.line_no,
         )
         for kw in keywords
     ]

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.8.0.dev677.dist-info → robotcode_repl-2.9.0.dev68.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: robotcode-repl
-Version: 2.8.0-dev.677
+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.8.0-dev.677
+Requires-Dist: robotcode-runner==2.9.0-dev.68
 Description-Content-Type: text/markdown
 
 # robotcode-repl

{robotcode_repl-2.8.0.dev677.dist-info → robotcode_repl-2.9.0.dev68.dist-info}/RECORD

@@ -1,16 +1,16 @@
 robotcode/repl/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robotcode/repl/__version__.py,sha256=0xyLlet74gxp40f05fA-fjXhAr2XdtEik3UuIJs6yAM,30
+robotcode/repl/__version__.py,sha256=VKDQl3EnWjlaGGS16iOqZ2LLnLORneHG-g4VFPliDAk,29
 robotcode/repl/_backends.py,sha256=s7PV-HBhnAvwjn2le0cbOJ5hwLb4MjahUo6KWtRC3lc,110
 robotcode/repl/_indent.py,sha256=jwFKaHNvTWYpUwIWHu6JHoaCz7ljOxneR5sBrKcAjpI,3303
 robotcode/repl/_keyword_lookup.py,sha256=c8InMUDGKsw4wYmiqJzBr9GGxPC-59sRZHI0C-GWjFA,7748
 robotcode/repl/_progress.py,sha256=BaSbDGOy5UOXvD855Kd-lDrYbqPrYIWRVs507vJznK4,2586
 robotcode/repl/_session_export.py,sha256=sTSkLEMoSxNQOsII3xfDY8h-nV-mrem-4h6Iug7VQv4,2841
-robotcode/repl/base_interpreter.py,sha256=haLDzqVqrgs7uqmAGVjma8W8j110GcLA0KZlv0QHKxI,29856
-robotcode/repl/cli.py,sha256=jt0fvcQqZ40wX7GwfPawGDAd53BFCggsKSnydZYsHvc,22029
-robotcode/repl/console_interpreter.py,sha256=4PwPwsE3D6ZE8qYe0ZRc58gTuf3GWQQa7Hh5hqs7hJw,87781
-robotcode/repl/doc_cli.py,sha256=24ZzA37cOt21wPzggx1fi_K2_GCpBekA6xiAp5_WRE0,23122
+robotcode/repl/base_interpreter.py,sha256=ep1xqH5QCtkn2U2P77IJQCk_Q5TTBsYOcRjGC5hV5cY,30176
+robotcode/repl/cli.py,sha256=1o8_p0I8bCPsnhI_QoHXWr9U6t9Mj11PrI1E3XG2e1c,23706
+robotcode/repl/console_interpreter.py,sha256=K8GP7nR_L0o7LpV456OZsRFHym7xH5CyK3NkeD9UvHc,88757
+robotcode/repl/doc_cli.py,sha256=lJ1KrS-oxqW32XyRSFiyhSrtKVvzA7TuMclMuZRYIrE,23221
 robotcode/repl/hooks.py,sha256=huqeT18sHWxG2dQNCGmgQUkb11CzVQkOoDgrDAy9hqg,238
-robotcode/repl/prompt_toolkit_interpreter.py,sha256=0xbh71AMbuJt8nyIRVv0gEfIhnRrmO7ZVNKVss5yfNw,13344
+robotcode/repl/prompt_toolkit_interpreter.py,sha256=fq0uRsWucGhjKwGekUShz4r4Vt0nvbeAa-phLvI6WNw,13416
 robotcode/repl/py.typed,sha256=bWew9mHgMy8LqMu7RuqQXFXLBxh2CRx0dUbSx-3wE48,27
 robotcode/repl/run.py,sha256=IWeiGZm56vkLn-hykP-_mWLrdpDciNyMk33_dT-6EJA,5327
 robotcode/repl/Repl/__init__.py,sha256=-j2WxY3MzdLfsMvpa2wMs6WVF_eeJygdshtMN50r67U,43
@@ -24,7 +24,7 @@ robotcode/repl/_pt/components.py,sha256=kuYVXJc4bFJq4b3-JtAtBYymvS7ssSwlKDldWYFG
 robotcode/repl/_pt/doc_viewer.py,sha256=iazNOQEvRygPSUyqKH2qOYShzdYqd7vufZcxPziJx8Q,71648
 robotcode/repl/_pt/history.py,sha256=Rvbdu4LtbYk9dPgYJY7D1JpfyT1SETUdNmtevxo21H4,1591
 robotcode/repl/_pt/lexer.py,sha256=YXtDMWQXPIocwceMXFlvULWyGXCDmqeAtTer_Ecuvwk,13925
-robotcode_repl-2.8.0.dev677.dist-info/METADATA,sha256=CyoaFOvfxm8TR7cjRxoz2KAjNgG80_SekfEcquFhSyc,2835
-robotcode_repl-2.8.0.dev677.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-robotcode_repl-2.8.0.dev677.dist-info/entry_points.txt,sha256=lI4idVOEmSWxmmioejg-_QvHXTLySK6ZxJ13R_v8ykU,40
-robotcode_repl-2.8.0.dev677.dist-info/RECORD,,
+robotcode_repl-2.9.0.dev68.dist-info/METADATA,sha256=LsjjHtQEfaFbqU5N4pG91dDZiUm2BqaGyEJ1mYFrJ24,2833
+robotcode_repl-2.9.0.dev68.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+robotcode_repl-2.9.0.dev68.dist-info/entry_points.txt,sha256=lI4idVOEmSWxmmioejg-_QvHXTLySK6ZxJ13R_v8ykU,40
+robotcode_repl-2.9.0.dev68.dist-info/RECORD,,

{robotcode_repl-2.8.0.dev677.dist-info → robotcode_repl-2.9.0.dev68.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.32.4
+Generator: hatchling 1.33.0
 Root-Is-Purelib: true
 Tag: py3-none-any