robotcode-runner 2.6.2__py3-none-any.whl → 2.8.0.dev548__py3-none-any.whl

robotcode/runner/cli/robot.py

@@ -1,7 +1,7 @@
 import os
 import weakref
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Set, Tuple, Union, cast
+from typing import Any, Dict, List, Optional, Tuple, Union, cast
 
 import click
 from robot.errors import DataError, Information
@@ -12,15 +12,18 @@ from robot.version import get_full_version
 import robotcode.modifiers
 from robotcode.core.ignore_spec import DEFAULT_SPEC_RULES, GIT_IGNORE_FILE, ROBOT_IGNORE_FILE, IgnoreSpec
 from robotcode.core.utils.path import path_is_relative_to
+from robotcode.modifiers.metadata_modifiers import MetadataPattern
 from robotcode.plugin import Application, pass_application
 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.robot.config.loader import load_robot_config_from_path
 from robotcode.robot.config.model import RobotBaseProfile
 from robotcode.robot.config.utils import get_config_files
 from robotcode.robot.utils import RF_VERSION
 
 from ..__version__ import __version__
+from ._robot_version import RobotVersionOption
 from ._search import SearchMatcher, SearchModifier
 
 _app: Optional[Application] = None
@@ -159,6 +162,8 @@ class RobotFrameworkEx(RobotFramework):
         by_longname: Tuple[str, ...] = (),
         exclude_by_longname: Tuple[str, ...] = (),
         search_matcher: Optional[SearchMatcher] = None,
+        by_test_metadata: Tuple[str, ...] = (),
+        exclude_by_test_metadata: Tuple[str, ...] = (),
     ) -> None:
         super().__init__()
         self.app = app
@@ -169,6 +174,8 @@ class RobotFrameworkEx(RobotFramework):
         self.by_longname = by_longname
         self.exclude_by_longname = exclude_by_longname
         self.search_matcher = search_matcher
+        self.by_test_metadata = by_test_metadata
+        self.exclude_by_test_metadata = exclude_by_test_metadata
 
     def parse_arguments(self, cli_args: Any) -> Any:
         try:
@@ -178,7 +185,13 @@ class RobotFrameworkEx(RobotFramework):
                     if Path(arg).is_absolute():
                         continue
 
-                    arguments[i] = str((self._orig_cwd / Path(arg)).absolute().relative_to(self.root_folder))
+                    absolute = (self._orig_cwd / Path(arg)).absolute()
+                    try:
+                        arguments[i] = str(absolute.relative_to(self.root_folder))
+                    except ValueError:
+                        # The path lies outside the project root, which the run changes into,
+                        # so it stays valid only as an absolute path.
+                        arguments[i] = str(absolute)
 
         except DataError:
             options, arguments = super().parse_arguments((*cli_args, *self.paths))
@@ -186,6 +199,11 @@ class RobotFrameworkEx(RobotFramework):
         if not arguments:
             arguments = self.paths
 
+        # Parsed before anything runs: an invalid pattern raises `DataError`,
+        # which Robot reports like an invalid option.
+        test_metadata_patterns = [MetadataPattern(p) for p in self.by_test_metadata]
+        excluded_test_metadata_patterns = [MetadataPattern(p) for p in self.exclude_by_test_metadata]
+
         if self.dry:
             line_end = "\n"
             raise Information(
@@ -203,6 +221,12 @@ class RobotFrameworkEx(RobotFramework):
         if self.exclude_by_longname:
             modifiers.append(robotcode.modifiers.ExcludedByLongName(*self.exclude_by_longname, root_name=root_name))
 
+        if test_metadata_patterns:
+            modifiers.append(robotcode.modifiers.ByTestMetadata(*test_metadata_patterns))
+
+        if excluded_test_metadata_patterns:
+            modifiers.append(robotcode.modifiers.ExcludedByTestMetadata(*excluded_test_metadata_patterns))
+
         if self.search_matcher is not None:
             modifiers.append(SearchModifier(self.search_matcher))
 
@@ -213,21 +237,21 @@ class RobotFrameworkEx(RobotFramework):
 
 
 # mypy: disable-error-code="arg-type"
-ROBOT_VERSION_OPTIONS = {
+ROBOT_VERSION_OPTIONS = [
     click.version_option(
         version=__version__,
         package_name="robotcode.runner",
         prog_name="RobotCode Runner",
         message=f"%(prog)s %(version)s\n{USAGE.splitlines()[0].split(' -- ')[0].strip()} {get_full_version()}",
     ),
-}
+]
 
-ROBOT_SIMPLE_OPTIONS: Set[click.Command] = {
+ROBOT_SIMPLE_OPTIONS = [
     *ROBOT_VERSION_OPTIONS,
     click.argument("robot_options_and_args", nargs=-1, type=click.Path()),
-}
+]
 
-ROBOT_OPTIONS: Set[click.Command] = {
+ROBOT_OPTIONS = [
     click.option(
         "--by-longname",
         "-bl",
@@ -242,8 +266,29 @@ ROBOT_OPTIONS: Set[click.Command] = {
         multiple=True,
         help="Excludes tests/tasks or suites by longname.",
     ),
+    # test metadata exists since Robot Framework 7.5
+    click.option(
+        "--by-test-metadata",
+        "-btm",
+        cls=RobotVersionOption,
+        since=(7, 5),
+        type=str,
+        multiple=True,
+        metavar="PATTERN",
+        help="Select tests/tasks by their metadata, for example `Issue:4409 AND Author:Hans*`.",
+    ),
+    click.option(
+        "--exclude-by-test-metadata",
+        "-ebtm",
+        cls=RobotVersionOption,
+        since=(7, 5),
+        type=str,
+        multiple=True,
+        metavar="PATTERN",
+        help="Excludes tests/tasks by their metadata. Same patterns as `--by-test-metadata`.",
+    ),
     *ROBOT_SIMPLE_OPTIONS,
-}
+]
 
 
 def handle_robot_options(
@@ -293,6 +338,7 @@ def handle_robot_options(
     return root_folder, profile, cmd_options
 
 
+@wrappable
 @click.command(
     cls=AliasedCommand,
     aliases=["run"],
@@ -306,6 +352,8 @@ def robot(
     app: Application,
     by_longname: Tuple[str, ...],
     exclude_by_longname: Tuple[str, ...],
+    by_test_metadata: Tuple[str, ...],
+    exclude_by_test_metadata: Tuple[str, ...],
     robot_options_and_args: Tuple[str, ...],
 ) -> None:
     """Runs `robot` with the selected configuration, profiles, options and arguments.
@@ -352,6 +400,8 @@ def robot(
                     orig_folder,
                     by_longname,
                     exclude_by_longname,
+                    by_test_metadata=by_test_metadata,
+                    exclude_by_test_metadata=exclude_by_test_metadata,
                 ).execute_cli((*cmd_options, *console_links_args, *robot_options_and_args), exit=False),
             )
         )

robotcode/runner/cli/testdoc.py

@@ -6,6 +6,7 @@ from robot.testdoc import USAGE, TestDoc
 from robot.version import get_full_version
 
 from robotcode.plugin import Application, pass_application
+from robotcode.plugin.click_helper.exit_codes import robot_exit_codes
 from robotcode.robot.config.loader import load_robot_config_from_path
 from robotcode.robot.config.model import TestDocProfile
 from robotcode.robot.config.utils import get_config_files
@@ -35,6 +36,7 @@ class TestDocEx(TestDoc):
         return super().main(arguments, **options)
 
 
+@robot_exit_codes
 @click.command(
     context_settings={"allow_extra_args": True, "ignore_unknown_options": True},
     add_help_option=True,
@@ -80,11 +82,12 @@ def testdoc(app: Application, robot_options_and_args: Tuple[str, ...]) -> None:
         except (TypeError, ValueError) as e:
             raise click.ClickException(str(e)) from e
 
-        testdoc_options = profile.testdoc
-        if testdoc_options is None:
-            testdoc_options = TestDocProfile()
-
+        # `testdoc` gets the settings outside of `[testdoc]` that it shares with `robot`. `[testdoc]` comes last, so
+        # it wins and its `extend-` settings add to them.
+        testdoc_options = TestDocProfile()
         testdoc_options.add_options(profile)
+        if profile.testdoc is not None:
+            testdoc_options.add_options(profile.testdoc)
 
         options = testdoc_options.build_command_line()
 

{robotcode_runner-2.6.2.dist-info → robotcode_runner-2.8.0.dev548.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: robotcode-runner
-Version: 2.6.2
+Version: 2.8.0-dev.548
 Summary: RobotCode runner for Robot Framework
 Project-URL: Homepage, https://robotcode.io
 Project-URL: Donate, https://opencollective.com/robotcode
@@ -20,15 +20,16 @@ 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: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: robotcode-modifiers==2.6.2
-Requires-Dist: robotcode-plugin==2.6.2
-Requires-Dist: robotcode-robot==2.6.2
-Requires-Dist: robotcode==2.6.2
+Requires-Dist: robotcode-modifiers==2.8.0-dev.548
+Requires-Dist: robotcode-plugin==2.8.0-dev.548
+Requires-Dist: robotcode-robot==2.8.0-dev.548
+Requires-Dist: robotcode==2.8.0-dev.548
 Requires-Dist: robotframework>=5.0.0
 Provides-Extra: html
 Requires-Dist: html-to-markdown>=2.0; extra == 'html'

robotcode_runner-2.8.0.dev548.dist-info/RECORD

@@ -0,0 +1,25 @@
+robotcode/runner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robotcode/runner/__version__.py,sha256=4qGR5Sg7VszfoERVpnszHJ_tsWJ0G_bUZdheH0_dqx4,30
+robotcode/runner/hooks.py,sha256=MSqEHc3wQIBgCXf9U9B0sA_zE8vbiTdoAlfaWz_3uIo,270
+robotcode/runner/py.typed,sha256=bWew9mHgMy8LqMu7RuqQXFXLBxh2CRx0dUbSx-3wE48,27
+robotcode/runner/cli/__init__.py,sha256=ozQtrMXxWIlJz3QKZhaGEIDjSCL0TPtF1XeP8WL8HrE,240
+robotcode/runner/cli/_markdown.py,sha256=4tHR4514XiHZiat-eMzxMclO_E7bwtdMTIo11rap80Q,12474
+robotcode/runner/cli/_robot_version.py,sha256=aXpMkrA4IHtCvqi_Dv9hr2D6UqBEI7j8PwsMgMJ0P-E,961
+robotcode/runner/cli/_search.py,sha256=JhKCDAdu_Mv89ug0p6nMumxdMAAwgbtdLt2CoJEZjsI,15874
+robotcode/runner/cli/libdoc.py,sha256=IanGjNOkm45VESVO_3pNoMpXtjpXMX9Li-J8lhPL2X8,3782
+robotcode/runner/cli/rebot.py,sha256=QIKYJD-4w7wquv46EygylNhBWXq1hj7-jV7vZvAHuHw,4922
+robotcode/runner/cli/robot.py,sha256=jJc26J3jYhbvZjzRILiyK4s-yjQDir-dxwwDoPHTrOc,13930
+robotcode/runner/cli/testdoc.py,sha256=UMpa1GOuyAIENGziepSprM4vHmR0QNfyBYWKN9cqd38,3756
+robotcode/runner/cli/discover/__init__.py,sha256=CRFSvVDlOX1avV3kx-d2QUOugDvgKPy8RBApsAUq15s,55
+robotcode/runner/cli/discover/_models.py,sha256=mkRwJTyQUWLVGbupCtYMVAHFhUouuMJ3TfR7_gz_lZI,2127
+robotcode/runner/cli/discover/_render.py,sha256=3GYv0bNPVOLDAabg6FYXmbCDLLztjeLFrEhj-1inUvY,20091
+robotcode/runner/cli/discover/discover.py,sha256=joZHF2UPdJ8v6b3OxfBkhl4Z2aGtaxzRObVLEZTxM3U,46621
+robotcode/runner/cli/results/__init__.py,sha256=aEyNen0WWvq3kF_VTRLz99_B5CMChM0aelpzWKW6Rac,52
+robotcode/runner/cli/results/_html.py,sha256=MD_6RZMeYNORFOINB8RJA8UhKEgXl6pldCToF51Y3qo,19422
+robotcode/runner/cli/results/_models.py,sha256=ESn9VKIF-mySCnE144wNoYMmYMKuniZKQW5O61lko5I,7458
+robotcode/runner/cli/results/_render.py,sha256=9DNk1d7F01bGQBCKBgtcqw_asvmnX1pJ02-kU02ptss,32471
+robotcode/runner/cli/results/results.py,sha256=CljvnJ_k2qJAYAubspLq-b7s3GNYsuXE42C5lzJ6K6k,73723
+robotcode_runner-2.8.0.dev548.dist-info/METADATA,sha256=WCMmPwAz0l6ts9mO40ULysTr0gC3ZhBrewgC9s6P0Q0,3059
+robotcode_runner-2.8.0.dev548.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+robotcode_runner-2.8.0.dev548.dist-info/entry_points.txt,sha256=igwjQYHlUfgCN-SohGVeQOnxOtqUzd2Jq94Ie8Se1Aw,44
+robotcode_runner-2.8.0.dev548.dist-info/RECORD,,

{robotcode_runner-2.6.2.dist-info → robotcode_runner-2.8.0.dev548.dist-info}/WHEEL

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

robotcode_runner-2.6.2.dist-info/RECORD

@@ -1,24 +0,0 @@
-robotcode/runner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robotcode/runner/__version__.py,sha256=53Sii4w6BIWn-1RhaTyqUO46gDe4nDCRQDAcpsWFH24,22
-robotcode/runner/hooks.py,sha256=MSqEHc3wQIBgCXf9U9B0sA_zE8vbiTdoAlfaWz_3uIo,270
-robotcode/runner/py.typed,sha256=bWew9mHgMy8LqMu7RuqQXFXLBxh2CRx0dUbSx-3wE48,27
-robotcode/runner/cli/__init__.py,sha256=ozQtrMXxWIlJz3QKZhaGEIDjSCL0TPtF1XeP8WL8HrE,240
-robotcode/runner/cli/_markdown.py,sha256=6zXGB3wYngaKg5tu-GuwCuZvvRKSxfl97jUxjRSkfEU,12022
-robotcode/runner/cli/_search.py,sha256=r6Uh-0ftc8WnkNOfkIgNBgJ2tSRWzgO0M_bM6cPFnxY,14421
-robotcode/runner/cli/libdoc.py,sha256=VOKb0Xpct9mGgZkCdUng13o3ZpvxnPg_LqWNP13BEJU,3468
-robotcode/runner/cli/rebot.py,sha256=LhMvkn92PQBQaniA1vRlu9J_XJ9N_wj95v48sdIvlG4,3943
-robotcode/runner/cli/robot.py,sha256=B-uQgqeU61LSqfAiDGR-Xp3L8NIlFBYrvhXSVDJkSbI,11795
-robotcode/runner/cli/testdoc.py,sha256=qc11KKwgGVXUydqsPS1M6x-j69wrtkFACeZEBeGXZBk,3479
-robotcode/runner/cli/discover/__init__.py,sha256=CRFSvVDlOX1avV3kx-d2QUOugDvgKPy8RBApsAUq15s,55
-robotcode/runner/cli/discover/_models.py,sha256=IUDmpWFUjYVvUmnynCvrf_daHrmf_4tagUoK_e-dtIA,1762
-robotcode/runner/cli/discover/_render.py,sha256=C1tee_gitlS4JsF1NVIuYczzqnTTKXOnTiEAJfGtCW0,16523
-robotcode/runner/cli/discover/discover.py,sha256=ly9_aJ3YPGepKN2u5WU9zb_Qr3CpWq8cOcwoco5kHS0,38122
-robotcode/runner/cli/results/__init__.py,sha256=aEyNen0WWvq3kF_VTRLz99_B5CMChM0aelpzWKW6Rac,52
-robotcode/runner/cli/results/_html.py,sha256=MD_6RZMeYNORFOINB8RJA8UhKEgXl6pldCToF51Y3qo,19422
-robotcode/runner/cli/results/_models.py,sha256=1zo-LoR-_lLIrnEwZh61qAryCgirQWkJNcZ5yzognKo,7271
-robotcode/runner/cli/results/_render.py,sha256=IVQiD_plufMyEU3WIDntGx_aqTiFc-Pg10jtS0dfXFk,32104
-robotcode/runner/cli/results/results.py,sha256=Vofh1RAYxM_uTJAjAyjYB7vJFROOHD6S9KkQzeGyzHI,67126
-robotcode_runner-2.6.2.dist-info/METADATA,sha256=HxDngjvRChNRYG_657BPm-DXFOfdYTrTA3AJ2x1ZXx0,2968
-robotcode_runner-2.6.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-robotcode_runner-2.6.2.dist-info/entry_points.txt,sha256=igwjQYHlUfgCN-SohGVeQOnxOtqUzd2Jq94Ie8Se1Aw,44
-robotcode_runner-2.6.2.dist-info/RECORD,,