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

robotcode/cli/__init__.py

@@ -2,11 +2,8 @@ import json
 import logging
 import logging.config
 import os
-import shlex
-import subprocess
-import sys
 from pathlib import Path
-from typing import IO, Any, List, Literal, Optional
+from typing import IO, Any, List, Literal, Mapping, Optional
 
 import click
 
@@ -17,12 +14,13 @@ from robotcode.plugin import (
     ColoredOutput,
     OutputFormat,
     pass_application,
+    show_error,
 )
 from robotcode.plugin._agent_detection import is_running_in_ai_agent
 from robotcode.plugin.click_helper.aliases import AliasedGroup
 from robotcode.plugin.click_helper.exit_codes import has_robot_exit_codes
 from robotcode.plugin.click_helper.types import EnumChoice
-from robotcode.plugin.click_helper.wrappable import WRAPPER_APPLIED_ENV, is_wrappable
+from robotcode.plugin.click_helper.wrappable import WRAPPER_APPLIED_ENV, invoked_command_is_wrappable, is_wrappable
 from robotcode.plugin.manager import PluginManager
 
 from .__version__ import __version__
@@ -51,125 +49,77 @@ class RobotCodeFormatter(logging.Formatter):
         super().__init__(*args, defaults=defaults, **kwargs)
 
 
-def _maybe_reexec_under_wrapper(
-    ctx: click.Context, app: Application, cli_wrapper: Optional[str] = None, no_wrapper: bool = False
-) -> None:
-    """Re-execute this process through a configured ``wrapper`` command.
-
-    When a ``wrapper`` is configured - either via ``--wrapper`` on the command
-    line (``cli_wrapper``) or the selected profile's ``wrapper`` (e.g. to run
-    the tests inside a specific X11/Wayland session) - and the invoked command
-    is ``@wrappable`` (i.e. it executes Robot Framework), the process
-    re-executes itself **once** through that command before Robot Framework
-    starts. ``--wrapper`` overrides the profile; ``--no-wrapper`` disables
-    wrapping for this run. The guard env var prevents infinite recursion and
-    lets an outer layer suppress the re-exec by setting it itself.
+def _warn_about_ignored_wrapper(ctx: click.Context, app: Application) -> None:
+    """Warn about a ``--wrapper`` that does not apply.
+
+    The command itself starts robotcode under the ``wrapper``, once it has loaded its
+    configuration (see `robotcode.plugin.click_helper.wrappable.run_under_wrapper`).
     """
-    if no_wrapper:
-        if cli_wrapper:
+    if app.config.no_wrapper:
+        if app.config.wrapper:
             app.warning("Ignoring --wrapper because --no-wrapper was given.")
         return
-    if os.environ.get(WRAPPER_APPLIED_ENV):
+    if not app.config.wrapper or os.environ.get(WRAPPER_APPLIED_ENV) or not ctx.invoked_subcommand:
         return
+    if not invoked_command_is_wrappable(ctx):
+        app.warning(f"Ignoring --wrapper: '{ctx.invoked_subcommand}' does not execute Robot Framework.")
 
-    sub_name = ctx.invoked_subcommand
-    if not sub_name:
-        return
-    # The command itself opts in via @wrappable; aliases resolve to the same
-    # command object, so this is alias-safe and needs no central name list.
-    sub_cmd = ctx.command.get_command(ctx, sub_name) if isinstance(ctx.command, click.Group) else None
-    if sub_cmd is None or not is_wrappable(sub_cmd):
-        if cli_wrapper:
-            app.warning(f"Ignoring --wrapper: '{sub_name}' does not execute Robot Framework.")
-        return
 
-    from robotcode.robot.config.loader import load_robot_config_from_path
-    from robotcode.robot.config.utils import get_config_files
-
-    profile_wrapper = None
-    try:
-        config_files, _, _ = get_config_files(
-            config_files=app.config.config_files,
-            root_folder=app.config.root,
-            no_vcs=app.config.no_vcs,
-            verbose_callback=app.verbose,
-        )
-        # `evaluated_with_env` also applies the profile's `env` to `os.environ`,
-        # so the wrapper command can rely on it. Profile errors are swallowed
-        # here: the command loads the config again and reports them, so they
-        # show up once. (Without a callback they would raise, and an unknown
-        # profile would make us skip the wrapper of a valid one.)
-        profile = (
-            load_robot_config_from_path(*config_files, verbose_callback=app.verbose)
-            .combine_profiles(*(app.config.profiles or []), verbose_callback=app.verbose, error_callback=lambda _: None)
-            .evaluated_with_env(verbose_callback=app.verbose, error_callback=lambda _: None)
-        )
-        profile_wrapper = profile.wrapper
-    except Exception as e:
-        # Don't fail early on config problems here; the actual command loads the
-        # config again and reports errors properly. An explicit --wrapper is
-        # still honored below.
-        message = str(e)
-        app.verbose(lambda: f"Skipping profile wrapper detection: {message}")
-
-    # `--wrapper` overrides the profile's `wrapper`. The evaluated profile turns
-    # StringExpression entries into plain strings.
-    if cli_wrapper:
-        wrapper = shlex.split(cli_wrapper)
-    elif profile_wrapper:
-        wrapper = [str(w) for w in profile_wrapper]
+def _set_output_options(app: Application, color: Optional[bool], pager: Optional[bool]) -> None:
+    """Set the colour and pager choice of `app` from `--color/--no-color` and `--pager/--no-pager`."""
+    if color is None:
+        app.config.colored_output = ColoredOutput.AUTO
+    elif color:
+        app.config.colored_output = ColoredOutput.YES
     else:
-        return
+        app.config.colored_output = ColoredOutput.NO
+    app.config.pager = pager
 
-    # A dry run must not start the wrapper: it would set up and tear down the
-    # real environment. Show it instead; the command itself then prints its own
-    # dry-run output.
-    if app.config.dry:
-        app.echo(f"Dry run, not executing the wrapper. Would run robotcode under: {' '.join(wrapper)}")
-        return
+    # AI-agent auto-detect: when running inside a known agent session
+    # (Claude Code, Copilot, OpenCode, …) demote colour and pager
+    # defaults so the agent's stdout capture stays clean. Explicit CLI
+    # flags and `NO_COLOR` / `FORCE_COLOR` keep their precedence.
+    if is_running_in_ai_agent():
+        if color is None and not os.environ.get("NO_COLOR") and not os.environ.get("FORCE_COLOR"):
+            app.config.colored_output = ColoredOutput.NO
+        if pager is None:
+            app.config.pager = False
 
-    # Rebuild the invocation the way this process was actually started, so the
-    # re-exec finds robotcode even when it runs from a bundled path (VS Code) and
-    # is not installed in the interpreter. `launcher_script` is set only when we
-    # were started through a bundled entry (its `__main__` sets it) or an explicit
-    # `--launcher-script`; otherwise robotcode is importable directly and
-    # `-m robotcode.cli` is correct. We deliberately do NOT consult the
-    # ROBOTCODE_BUNDLED_ROBOTCODE_MAIN env var: VS Code sets it in every terminal,
-    # so a directly started robotcode would be diverted to the bundled copy.
-    # Mirrors the debug launcher's `debugger_script` handling.
-    entry = [str(app.config.launcher_script)] if app.config.launcher_script else ["-m", "robotcode.cli"]
-    command = [*wrapper, sys.executable, *entry, *sys.argv[1:]]
-    app.verbose(lambda: "Running under wrapper: " + " ".join(command))
-
-    # Run robotcode again under the wrapper; the guard env stops the spawned
-    # robotcode from wrapping a second time. On POSIX we replace this process with
-    # execvp (no extra process); Windows has no such exec, so there we spawn the
-    # command, wait, and forward its exit code.
-    os.environ[WRAPPER_APPLIED_ENV] = "1"
-    try:
-        if sys.platform == "win32":
-            sys.exit(subprocess.run(command).returncode)
-        os.execvp(command[0], command)
-    except OSError as e:
-        raise click.ClickException(f"Failed to execute wrapper command {wrapper!r}: {e}") from e
-
-
-class RobotDataError(click.ClickException):
-    """An error robotcode reports itself for a command that passes on Robot Framework's
-    exit codes.
 
-    Shows the original error unchanged, but exits with Robot Framework's code for invalid
-    data or command line options instead of Click's 1 or 2.
-    """
+def _application_for(params: Mapping[str, Any]) -> Application:
+    """An `Application` for an error that comes before the root command has set one up,
+    set up from robotcode's own options `params` as far as they are known."""
+    app = Application()
+    _set_output_options(app, params.get("color"), params.get("pager"))
+    return app
+
 
-    exit_code = 252
+class RobotCodeError(click.ClickException):
+    """An error that stops a robotcode command, written as robotcode writes the errors it
+    reports (`robotcode.plugin.show_error`). Keeps the exit code of the error."""
 
-    def __init__(self, error: click.ClickException) -> None:
+    def __init__(self, error: click.ClickException, app: Application) -> None:
         super().__init__(error.message)
         self.error = error
+        self.app = app
+        # click declares the exit code on the class; this one is the code of the error
+        self.exit_code = error.exit_code  # type: ignore[misc]
 
     def show(self, file: Optional[IO[Any]] = None) -> None:
-        self.error.show(file)
+        show_error(self.app, self.error, file)
+
+
+class RobotDataError(RobotCodeError):
+    """An error robotcode reports itself for a command that passes on Robot Framework's
+    exit codes.
+
+    Exits with Robot Framework's code for invalid data or command line options instead of
+    Click's 1 or 2.
+    """
+
+    def __init__(self, error: click.ClickException, app: Application) -> None:
+        super().__init__(error, app)
+        self.exit_code = 252  # type: ignore[misc]
 
 
 class RobotCodeGroup(AliasedGroup):
@@ -182,15 +132,40 @@ class RobotCodeGroup(AliasedGroup):
     invalid option - exits with Robot Framework's 252 instead. Robot Framework's own exit
     codes never arrive as Click errors, so they pass through unchanged, and so does any
     other code.
+
+    Every Click error of a command or of the group's own options is written as
+    `[ ERROR ] <message>`, with the `Application` of the command. An error that comes
+    before the root command has set it up - a command name that does not exist or is
+    missing, an invalid option of robotcode itself - gets one set up from robotcode's own
+    options, so that `--no-color` and AI-agent sessions apply to it too.
     """
 
+    def make_context(
+        self, info_name: Optional[str], args: List[str], parent: Optional[click.Context] = None, **extra: Any
+    ) -> click.Context:
+        # Click's parser takes the arguments out of the list it gets
+        command_line = list(args)
+        try:
+            return super().make_context(info_name, args, parent, **extra)
+        except click.ClickException as e:
+            # Click stops at an invalid option before it takes any value; read robotcode's
+            # own options again as Click's shell completion does, without errors or
+            # callbacks, passing over unknown options
+            lenient = {**extra, "resilient_parsing": True, "ignore_unknown_options": True}
+            try:
+                params = super().make_context(info_name, command_line, parent, **lenient).params
+            except click.ClickException:
+                params = {}
+            raise RobotCodeError(e, _application_for(params)) from e
+
     def invoke(self, ctx: click.Context) -> Any:
         try:
             return super().invoke(ctx)
         except click.ClickException as e:
+            app = ctx.find_object(Application) or _application_for(ctx.params)
             if e.exit_code in (1, 2) and self._passes_on_robot_exit_codes(ctx):
-                raise RobotDataError(e) from e
-            raise
+                raise RobotDataError(e, app) from e
+            raise RobotCodeError(e, app) from e
 
     def _passes_on_robot_exit_codes(self, ctx: click.Context) -> bool:
         name = ctx.invoked_subcommand
@@ -443,31 +418,17 @@ def robotcode(
     app.config.root = root
     app.config.no_vcs = no_vcs
 
-    if color is None:
-        app.config.colored_output = ColoredOutput.AUTO
-    elif color:
-        app.config.colored_output = ColoredOutput.YES
-    else:
-        app.config.colored_output = ColoredOutput.NO
-    app.config.pager = pager
-
-    # AI-agent auto-detect: when running inside a known agent session
-    # (Claude Code, Copilot, OpenCode, …) demote colour and pager
-    # defaults so the agent's stdout capture stays clean. Explicit CLI
-    # flags and `NO_COLOR` / `FORCE_COLOR` keep their precedence.
-    if is_running_in_ai_agent():
-        if color is None and not os.environ.get("NO_COLOR") and not os.environ.get("FORCE_COLOR"):
-            app.config.colored_output = ColoredOutput.NO
-        if pager is None:
-            app.config.pager = False
+    _set_output_options(app, color, pager)
     app.config.output_format = format
     app.config.launcher_script = launcher_script
     app.config.default_paths = default_path
     app.config.log_enabled = log
     app.config.log_level = log_level
     app.config.log_calls = log_calls
+    app.config.wrapper = wrapper
+    app.config.no_wrapper = no_wrapper
 
-    _maybe_reexec_under_wrapper(ctx, app, wrapper, no_wrapper)
+    _warn_about_ignored_wrapper(ctx, app)
 
     if log_config:
         if log_calls:

robotcode/cli/__version__.py

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

robotcode/cli/commands/profiles.py

@@ -13,6 +13,7 @@ from robotcode.robot.config.loader import (
     DiscoverdBy,
     load_robot_config_from_path,
 )
+from robotcode.robot.config.model import UnknownProfile
 from robotcode.robot.config.utils import get_config_files
 
 
@@ -85,8 +86,20 @@ def list(app: Application, paths: List[Path], show_hidden: bool = False, sort_by
 
         config = load_robot_config_from_path(*config_files, verbose_callback=app.verbose)
 
+        # the editors fill their profile lists with this command, also when their selection names a profile that is
+        # gone, so a name that selects no profile is only reported, and those of the selection are listed for them
+        unknown_selected: List[str] = []
+
+        def report_unknown(unknown: UnknownProfile) -> None:
+            app.error(unknown.message)
+            if unknown.selected:
+                unknown_selected.append(unknown.name)
+
         _, selected_profiles, enabled_names = config.combine_profiles_ex(
-            *(app.config.profiles or []), verbose_callback=app.verbose, error_callback=app.error
+            *(app.config.profiles or []),
+            verbose_callback=app.verbose,
+            error_callback=app.error,
+            unknown_profile_callback=report_unknown,
         )
 
         selected_names = [k for k in selected_profiles.keys()]
@@ -121,6 +134,8 @@ def list(app: Application, paths: List[Path], show_hidden: bool = False, sort_by
             messages += ["No profiles defined."]
         if messages:
             result["messages"] = messages
+        if unknown_selected:
+            result["unknownSelected"] = unknown_selected
 
         if app.config.output_format is None or app.config.output_format == OutputFormat.TEXT:
             for v in result["profiles"]:

{robotcode-2.8.0.dev677.dist-info → robotcode-2.9.0.dev68.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: robotcode
-Version: 2.8.0-dev.677
+Version: 2.9.0-dev.68
 Summary: Command line interface for RobotCode
 Project-URL: Homepage, https://robotcode.io
 Project-URL: Donate, https://opencollective.com/robotcode
@@ -34,35 +34,35 @@ Classifier: Topic :: Text Editors :: Integrated Development Environments (IDE)
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: robotcode-core==2.8.0-dev.677
-Requires-Dist: robotcode-plugin==2.8.0-dev.677
-Requires-Dist: robotcode-robot==2.8.0-dev.677
+Requires-Dist: robotcode-core==2.9.0-dev.68
+Requires-Dist: robotcode-plugin==2.9.0-dev.68
+Requires-Dist: robotcode-robot==2.9.0-dev.68
 Provides-Extra: all
 Requires-Dist: docutils; extra == 'all'
 Requires-Dist: pyyaml>=5.4; extra == 'all'
-Requires-Dist: robotcode-analyze==2.8.0-dev.677; extra == 'all'
-Requires-Dist: robotcode-debugger==2.8.0-dev.677; extra == 'all'
-Requires-Dist: robotcode-language-server==2.8.0-dev.677; extra == 'all'
-Requires-Dist: robotcode-repl-server==2.8.0-dev.677; extra == 'all'
-Requires-Dist: robotcode-repl==2.8.0-dev.677; extra == 'all'
-Requires-Dist: robotcode-runner==2.8.0-dev.677; extra == 'all'
+Requires-Dist: robotcode-analyze==2.9.0-dev.68; extra == 'all'
+Requires-Dist: robotcode-debugger==2.9.0-dev.68; extra == 'all'
+Requires-Dist: robotcode-language-server==2.9.0-dev.68; extra == 'all'
+Requires-Dist: robotcode-repl-server==2.9.0-dev.68; extra == 'all'
+Requires-Dist: robotcode-repl==2.9.0-dev.68; extra == 'all'
+Requires-Dist: robotcode-runner==2.9.0-dev.68; extra == 'all'
 Requires-Dist: robotframework-robocop>=6.0.0; extra == 'all'
 Provides-Extra: analyze
-Requires-Dist: robotcode-analyze==2.8.0-dev.677; extra == 'analyze'
+Requires-Dist: robotcode-analyze==2.9.0-dev.68; extra == 'analyze'
 Provides-Extra: debugger
-Requires-Dist: robotcode-debugger==2.8.0-dev.677; extra == 'debugger'
+Requires-Dist: robotcode-debugger==2.9.0-dev.68; extra == 'debugger'
 Provides-Extra: languageserver
-Requires-Dist: robotcode-language-server==2.8.0-dev.677; extra == 'languageserver'
+Requires-Dist: robotcode-language-server==2.9.0-dev.68; extra == 'languageserver'
 Provides-Extra: lint
 Requires-Dist: robotframework-robocop>=2.0.0; extra == 'lint'
 Provides-Extra: repl
-Requires-Dist: robotcode-repl==2.8.0-dev.677; extra == 'repl'
+Requires-Dist: robotcode-repl==2.9.0-dev.68; extra == 'repl'
 Provides-Extra: replserver
-Requires-Dist: robotcode-repl-server==2.8.0-dev.677; extra == 'replserver'
+Requires-Dist: robotcode-repl-server==2.9.0-dev.68; extra == 'replserver'
 Provides-Extra: rest
 Requires-Dist: docutils; extra == 'rest'
 Provides-Extra: runner
-Requires-Dist: robotcode-runner==2.8.0-dev.677; extra == 'runner'
+Requires-Dist: robotcode-runner==2.9.0-dev.68; extra == 'runner'
 Provides-Extra: yaml
 Requires-Dist: pyyaml>=5.4; extra == 'yaml'
 Description-Content-Type: text/markdown
@@ -185,7 +185,7 @@ For CI pipelines, the command line, or LSP-compatible editors like Neovim, Subli
 pip install "robotcode[runner,analyze]"
 ```
 
-Pick the extras that match your use case — see the [CLI reference](https://robotcode.io/reference/cli/) for the available packages and how to install them.
+Pick the extras that match your use case — see [Get Started on the Command Line](https://robotcode.io/getting-started/command-line/) for the commands each extra brings, installing with pip or uv and a first run, and the [CLI reference](https://robotcode.io/reference/cli/) for every command and option.
 
 
 ## Documentation
@@ -193,7 +193,7 @@ Pick the extras that match your use case — see the [CLI reference](https://rob
 For detailed instructions, visit our **[official documentation](https://robotcode.io)**. Additional resources:
 
 - **[Q&A](https://github.com/robotcodedev/robotcode/discussions/categories/q-a):** Answers to common questions about RobotCode.
-- **[Guides](https://robotcode.io/guides/):** How to use RobotCode's commands and set up projects, plus common pitfalls and editor customization.
+- **[Guides](https://robotcode.io/guides/):** How to work with RobotCode in VS Code, in PyCharm and on the command line, how to set up projects with `robot.toml`, and tips for Robot Framework code.
 - **[Command Line Tools Reference](https://robotcode.io/reference/cli/):** Comprehensive documentation on using RobotCode's CLI tools.
 - **[Changelog](https://github.com/robotcodedev/robotcode/blob/main/CHANGELOG.md):** Track changes, updates, and new features in each release.
 - **[Support & Contribute](https://robotcode.io/contributing/):** Ways to back the project — financial, code, feedback.

robotcode-2.9.0.dev68.dist-info/RECORD

@@ -0,0 +1,12 @@
+robotcode/cli/__init__.py,sha256=pJ9qw0tY7Zh8OKFTtMKhFuFSnAGx7_QMx5r-s3d32U4,16394
+robotcode/cli/__main__.py,sha256=hX3nwROMTnsYGT1KS0rXUYrslu9sFzctYdAh66Rcckw,153
+robotcode/cli/__version__.py,sha256=VKDQl3EnWjlaGGS16iOqZ2LLnLORneHG-g4VFPliDAk,29
+robotcode/cli/py.typed,sha256=bWew9mHgMy8LqMu7RuqQXFXLBxh2CRx0dUbSx-3wE48,27
+robotcode/cli/commands/__init__.py,sha256=XJHRt_YwMO2Ni2EfL2aj4jkJXMVG6NGFTpzvSVgIRnQ,92
+robotcode/cli/commands/config.py,sha256=0Jmf7HDIo7IIaOMU9M_bYi7PdHAfcae6x3SW93NA3EA,10481
+robotcode/cli/commands/profiles.py,sha256=tZ8K5KoPkbol4PwTyR3Qleb09CjvrFJaQVbY36MGVGE,6808
+robotcode-2.9.0.dev68.dist-info/METADATA,sha256=aP3XbL8DnLeUdL5P3CzlWc_UNpvP4So2W0oWMsgiP6w,15591
+robotcode-2.9.0.dev68.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+robotcode-2.9.0.dev68.dist-info/entry_points.txt,sha256=Pb4DKVVdJb5PboVl48njwk3DkKQHBJOL1A8KkpemqA8,58
+robotcode-2.9.0.dev68.dist-info/licenses/LICENSE.txt,sha256=B05uMshqTA74s-0ltyHKI6yoPfJ3zYgQbvcXfDVGFf8,10280
+robotcode-2.9.0.dev68.dist-info/RECORD,,

{robotcode-2.8.0.dev677.dist-info → robotcode-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

robotcode-2.8.0.dev677.dist-info/RECORD

@@ -1,12 +0,0 @@
-robotcode/cli/__init__.py,sha256=kdPYL7SnMNmVf6jZ0p7xAvHIFKo5aUxWMt9TwLcd1Sw,18158
-robotcode/cli/__main__.py,sha256=hX3nwROMTnsYGT1KS0rXUYrslu9sFzctYdAh66Rcckw,153
-robotcode/cli/__version__.py,sha256=0xyLlet74gxp40f05fA-fjXhAr2XdtEik3UuIJs6yAM,30
-robotcode/cli/py.typed,sha256=bWew9mHgMy8LqMu7RuqQXFXLBxh2CRx0dUbSx-3wE48,27
-robotcode/cli/commands/__init__.py,sha256=XJHRt_YwMO2Ni2EfL2aj4jkJXMVG6NGFTpzvSVgIRnQ,92
-robotcode/cli/commands/config.py,sha256=0Jmf7HDIo7IIaOMU9M_bYi7PdHAfcae6x3SW93NA3EA,10481
-robotcode/cli/commands/profiles.py,sha256=5H9lvSVCMggWXf0IH54QtgDgqupEEvpcUrEsTZvZsNM,6127
-robotcode-2.8.0.dev677.dist-info/METADATA,sha256=BBaU7KP1vgbgniX1KWl4JPMM2ACV0cf7OELorlcZHHE,15408
-robotcode-2.8.0.dev677.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-robotcode-2.8.0.dev677.dist-info/entry_points.txt,sha256=Pb4DKVVdJb5PboVl48njwk3DkKQHBJOL1A8KkpemqA8,58
-robotcode-2.8.0.dev677.dist-info/licenses/LICENSE.txt,sha256=B05uMshqTA74s-0ltyHKI6yoPfJ3zYgQbvcXfDVGFf8,10280
-robotcode-2.8.0.dev677.dist-info/RECORD,,