robotcode 2.7.0__py3-none-any.whl → 2.8.0.dev631__py3-none-any.whl

robotcode/cli/__init__.py

@@ -6,7 +6,7 @@ import shlex
 import subprocess
 import sys
 from pathlib import Path
-from typing import Any, List, Literal, Optional
+from typing import IO, Any, List, Literal, Optional
 
 import click
 
@@ -20,6 +20,7 @@ from robotcode.plugin import (
 )
 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.manager import PluginManager
@@ -94,11 +95,14 @@ def _maybe_reexec_under_wrapper(
             verbose_callback=app.verbose,
         )
         # `evaluated_with_env` also applies the profile's `env` to `os.environ`,
-        # so the wrapper command can rely on it.
+        # 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=app.error)
-            .evaluated_with_env(verbose_callback=app.verbose, error_callback=app.error)
+            .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:
@@ -117,6 +121,13 @@ def _maybe_reexec_under_wrapper(
     else:
         return
 
+    # 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
+
     # 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
@@ -143,8 +154,52 @@ def _maybe_reexec_under_wrapper(
         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.
+    """
+
+    exit_code = 252
+
+    def __init__(self, error: click.ClickException) -> None:
+        super().__init__(error.message)
+        self.error = error
+
+    def show(self, file: Optional[IO[Any]] = None) -> None:
+        self.error.show(file)
+
+
+class RobotCodeGroup(AliasedGroup):
+    """The root command group.
+
+    Commands that run Robot Framework (`wrappable`) or pass on the exit code of a Robot
+    Framework tool (`robot_exit_codes`) answer with its exit codes, where 1-250 counts the
+    failed tests. An error robotcode reports itself for such a command - a Click error with
+    exit code 1 or 2, such as a broken configuration, a wrapper that doesn't start or an
+    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.
+    """
+
+    def invoke(self, ctx: click.Context) -> Any:
+        try:
+            return super().invoke(ctx)
+        except click.ClickException as e:
+            if e.exit_code in (1, 2) and self._passes_on_robot_exit_codes(ctx):
+                raise RobotDataError(e) from e
+            raise
+
+    def _passes_on_robot_exit_codes(self, ctx: click.Context) -> bool:
+        name = ctx.invoked_subcommand
+        cmd = self.get_command(ctx, name) if name else None
+        return cmd is not None and (is_wrappable(cmd) or has_robot_exit_codes(cmd))
+
+
 @click.group(
-    cls=AliasedGroup,
+    cls=RobotCodeGroup,
     context_settings={"auto_envvar_prefix": "ROBOTCODE"},
     invoke_without_command=False,
 )
@@ -205,8 +260,9 @@ def _maybe_reexec_under_wrapper(
     "color",
     default=None,
     help=(
-        "Force or disable colored output. Default (no flag): auto-detect — colors only when stdout is a TTY,"
-        " disabled if `NO_COLOR` is set, forced if `FORCE_COLOR` is set."
+        "Enable or disable colored output. Color codes are written only to a terminal; set `FORCE_COLOR` to get"
+        " them in a pipe. Default (no flag): auto-detect — colors only when stdout is a TTY, disabled if `NO_COLOR`"
+        " is set, forced if `FORCE_COLOR` is set."
     ),
     show_envvar=True,
 )
@@ -215,7 +271,8 @@ def _maybe_reexec_under_wrapper(
     "pager",
     default=None,
     help=(
-        "Force or disable the pager. Default (no flag): auto-page when the rendered output exceeds the terminal height."
+        "Force or disable the pager on a terminal; no pager starts when stdout isn't a TTY. Default (no flag):"
+        " auto-page when the rendered output exceeds the terminal height."
     ),
     show_envvar=True,
 )

robotcode/cli/__version__.py

@@ -1 +1 @@
-__version__ = "2.7.0"
+__version__ = "2.8.0-dev.631"

{robotcode-2.7.0.dist-info → robotcode-2.8.0.dev631.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: robotcode
-Version: 2.7.0
+Version: 2.8.0-dev.631
 Summary: Command line interface for RobotCode
 Project-URL: Homepage, https://robotcode.io
 Project-URL: Donate, https://opencollective.com/robotcode
@@ -23,6 +23,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Debuggers
 Classifier: Topic :: Software Development :: Quality Assurance
@@ -33,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.7.0
-Requires-Dist: robotcode-plugin==2.7.0
-Requires-Dist: robotcode-robot==2.7.0
+Requires-Dist: robotcode-core==2.8.0-dev.631
+Requires-Dist: robotcode-plugin==2.8.0-dev.631
+Requires-Dist: robotcode-robot==2.8.0-dev.631
 Provides-Extra: all
 Requires-Dist: docutils; extra == 'all'
 Requires-Dist: pyyaml>=5.4; extra == 'all'
-Requires-Dist: robotcode-analyze==2.7.0; extra == 'all'
-Requires-Dist: robotcode-debugger==2.7.0; extra == 'all'
-Requires-Dist: robotcode-language-server==2.7.0; extra == 'all'
-Requires-Dist: robotcode-repl-server==2.7.0; extra == 'all'
-Requires-Dist: robotcode-repl==2.7.0; extra == 'all'
-Requires-Dist: robotcode-runner==2.7.0; extra == 'all'
+Requires-Dist: robotcode-analyze==2.8.0-dev.631; extra == 'all'
+Requires-Dist: robotcode-debugger==2.8.0-dev.631; extra == 'all'
+Requires-Dist: robotcode-language-server==2.8.0-dev.631; extra == 'all'
+Requires-Dist: robotcode-repl-server==2.8.0-dev.631; extra == 'all'
+Requires-Dist: robotcode-repl==2.8.0-dev.631; extra == 'all'
+Requires-Dist: robotcode-runner==2.8.0-dev.631; extra == 'all'
 Requires-Dist: robotframework-robocop>=6.0.0; extra == 'all'
 Provides-Extra: analyze
-Requires-Dist: robotcode-analyze==2.7.0; extra == 'analyze'
+Requires-Dist: robotcode-analyze==2.8.0-dev.631; extra == 'analyze'
 Provides-Extra: debugger
-Requires-Dist: robotcode-debugger==2.7.0; extra == 'debugger'
+Requires-Dist: robotcode-debugger==2.8.0-dev.631; extra == 'debugger'
 Provides-Extra: languageserver
-Requires-Dist: robotcode-language-server==2.7.0; extra == 'languageserver'
+Requires-Dist: robotcode-language-server==2.8.0-dev.631; extra == 'languageserver'
 Provides-Extra: lint
 Requires-Dist: robotframework-robocop>=2.0.0; extra == 'lint'
 Provides-Extra: repl
-Requires-Dist: robotcode-repl==2.7.0; extra == 'repl'
+Requires-Dist: robotcode-repl==2.8.0-dev.631; extra == 'repl'
 Provides-Extra: replserver
-Requires-Dist: robotcode-repl-server==2.7.0; extra == 'replserver'
+Requires-Dist: robotcode-repl-server==2.8.0-dev.631; extra == 'replserver'
 Provides-Extra: rest
 Requires-Dist: docutils; extra == 'rest'
 Provides-Extra: runner
-Requires-Dist: robotcode-runner==2.7.0; extra == 'runner'
+Requires-Dist: robotcode-runner==2.8.0-dev.631; extra == 'runner'
 Provides-Extra: yaml
 Requires-Dist: pyyaml>=5.4; extra == 'yaml'
 Description-Content-Type: text/markdown
@@ -69,7 +70,7 @@ Description-Content-Type: text/markdown
 # RobotCode - The Ultimate Robot Framework Toolset
 
 [![License](https://img.shields.io/github/license/robotcodedev/robotcode?style=flat&logo=apache)](https://github.com/robotcodedev/robotcode/blob/main/LICENSE)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/robotcodedev/robotcode/build-test-package-publish.yml?branch=main&style=flat&logo=github)](https://github.com/robotcodedev/robotcode/actions?query=workflow:build_test_package_publish)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/robotcodedev/robotcode/build-test-package.yml?branch=main&style=flat&logo=github)](https://github.com/robotcodedev/robotcode/actions/workflows/build-test-package.yml)
 [![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/d-biehl.robotcode?style=flat&label=VS%20Marketplace&logo=visual-studio-code)](https://marketplace.visualstudio.com/items?itemName=d-biehl.robotcode)
 [![Installs](https://img.shields.io/visual-studio-marketplace/i/d-biehl.robotcode?style=flat)](https://marketplace.visualstudio.com/items?itemName=d-biehl.robotcode)
 [![JetBrains Marketplace](https://img.shields.io/jetbrains/plugin/v/26216.svg)](https://plugins.jetbrains.com/plugin/26216)
@@ -131,9 +132,22 @@ For the complete feature reference, see the [official documentation](https://rob
 - Python 3.10 or newer
 - Robot Framework 5.0 or newer
 
+**Supported combinations:** each Robot Framework version is supported with the Python versions that it officially supports itself:
+
+| Robot Framework | Python |
+|---|---|
+| 5.0 | 3.10 |
+| 6.0 | 3.10 – 3.11 |
+| 6.1, 7.0 | 3.10 – 3.12 |
+| 7.1, 7.2 | 3.10 – 3.13 |
+| 7.3, 7.4 | 3.10 – 3.14 |
+| 7.5 | 3.10 – 3.15 |
+
+RobotCode's CI tests only these combinations, to keep the effort low. Other combinations may work, but using them is your own responsibility. For example, Robot Framework versions before 7.5 may not work with Python 3.15.
+
 **Editor / IDE — any LSP-capable editor works.** For the dedicated extensions you need one of:
-- Visual Studio Code 1.108.0 or newer
-- PyCharm / IntelliJ IDEA 2025.3 or newer
+- Visual Studio Code 1.127.0 or newer
+- PyCharm / IntelliJ IDEA 2026.1 or newer
 
 Other editors (Neovim, Sublime Text, Helix, Emacs, …) connect to the language server via the `languageserver` extra from PyPI — see [Command Line and Other Editors](#command-line-and-other-editors) below.
 
@@ -143,7 +157,7 @@ Other editors (Neovim, Sublime Text, Helix, Emacs, …) connect to the language
 ### Visual Studio Code
 
 1. **Install the RobotCode Extension** from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=d-biehl.robotcode).
-2. **Continue with the [Getting Started Guide](https://robotcode.io/02_get_started/)** for setup, your first `robot.toml`, and running your first test.
+2. **Continue with the [Getting Started Guide](https://robotcode.io/getting-started/)** for setup, your first `robot.toml`, and running your first test.
 
 **Extensions:**
 RobotCode declares dependencies on the [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python) and [Python Debugger](https://marketplace.visualstudio.com/items?itemName=ms-python.debugpy) extensions so VS Code installs them when required. Additional extensions may be needed depending on your project.
@@ -157,7 +171,7 @@ RobotCode declares dependencies on the [Python](https://marketplace.visualstudio
    - **[JetBrains Marketplace](https://plugins.jetbrains.com/plugin/26216):** click <kbd>Install to ...</kbd> if your IDE is running.
    - **Manual:** download the [latest release](https://github.com/robotcodedev/robotcode/releases/latest) and use <kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>⚙️</kbd> > <kbd>Install plugin from disk...</kbd>.
 
-2. **Continue with the [Getting Started Guide](https://robotcode.io/02_get_started/)** for setup, your first `robot.toml`, and running your first test.
+2. **Continue with the [Getting Started Guide](https://robotcode.io/getting-started/)** for setup, your first `robot.toml`, and running your first test.
 
 **Plugins:**
 RobotCode declares a dependency on [LSP4IJ](https://plugins.jetbrains.com/plugin/23257) so your IDE installs it automatically. Additional plugins may be required depending on your project needs.
@@ -168,10 +182,10 @@ RobotCode declares a dependency on [LSP4IJ](https://plugins.jetbrains.com/plugin
 For CI pipelines, the command line, or LSP-compatible editors like Neovim, Sublime Text, or Helix, install RobotCode from PyPI. The base `robotcode` package is only the CLI core; the actual commands live in extras such as `runner`, `analyze`, `debugger`, `languageserver`, and `repl`:
 
 ```bash
-pip install robotcode[runner,analyze]
+pip install "robotcode[runner,analyze]"
 ```
 
-Pick the extras that match your use case — see the [CLI reference](https://robotcode.io/03_reference/cli) for the available packages and how to install them.
+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.
 
 
 ## Documentation
@@ -179,10 +193,10 @@ 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.
-- **[Tips & Tricks](https://robotcode.io/04_tip_and_tricks/):** Common pitfalls, editor customization, and setup recipes.
-- **[Command Line Tools Reference](https://robotcode.io/03_reference/cli):** Comprehensive documentation on using RobotCode's CLI tools.
+- **[Guides](https://robotcode.io/guides/):** How to use RobotCode's commands and set up projects, plus common pitfalls and editor customization.
+- **[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/05_contributing/):** Ways to back the project — financial, code, feedback.
+- **[Support & Contribute](https://robotcode.io/contributing/):** Ways to back the project — financial, code, feedback.
 
 
 ## Sponsor RobotCode

robotcode-2.8.0.dev631.dist-info/RECORD

@@ -0,0 +1,12 @@
+robotcode/cli/__init__.py,sha256=kdPYL7SnMNmVf6jZ0p7xAvHIFKo5aUxWMt9TwLcd1Sw,18158
+robotcode/cli/__main__.py,sha256=hX3nwROMTnsYGT1KS0rXUYrslu9sFzctYdAh66Rcckw,153
+robotcode/cli/__version__.py,sha256=9SGjqX5uvERIavT5Cjgw0TSLgQ-nKCFaQ13-E6K7MDA,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.dev631.dist-info/METADATA,sha256=Rtnj2zN_ogJv2vwpnQ1s9PMp51A2HD8hYyts24ad2sA,15310
+robotcode-2.8.0.dev631.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+robotcode-2.8.0.dev631.dist-info/entry_points.txt,sha256=Pb4DKVVdJb5PboVl48njwk3DkKQHBJOL1A8KkpemqA8,58
+robotcode-2.8.0.dev631.dist-info/licenses/LICENSE.txt,sha256=B05uMshqTA74s-0ltyHKI6yoPfJ3zYgQbvcXfDVGFf8,10280
+robotcode-2.8.0.dev631.dist-info/RECORD,,

{robotcode-2.7.0.dist-info → robotcode-2.8.0.dev631.dist-info}/WHEEL

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

robotcode-2.7.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-robotcode/cli/__init__.py,sha256=qvIUqcHP8K1FNyu3whFDe6M_Wyeo_SKCqwBxtPeQfy0,15608
-robotcode/cli/__main__.py,sha256=hX3nwROMTnsYGT1KS0rXUYrslu9sFzctYdAh66Rcckw,153
-robotcode/cli/__version__.py,sha256=EtKWW0Hnl5oWglRNH0HZigvcDT2FEs58ek8buJdwW1E,22
-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.7.0.dist-info/METADATA,sha256=nJWf0wXHOE5LlTfA-cTYK3NsBzv6tGYnOfKj8XZSt9M,14582
-robotcode-2.7.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-robotcode-2.7.0.dist-info/entry_points.txt,sha256=Pb4DKVVdJb5PboVl48njwk3DkKQHBJOL1A8KkpemqA8,58
-robotcode-2.7.0.dist-info/licenses/LICENSE.txt,sha256=B05uMshqTA74s-0ltyHKI6yoPfJ3zYgQbvcXfDVGFf8,10280
-robotcode-2.7.0.dist-info/RECORD,,