wexample-cli 0.3.0__tar.gz → 0.4.0__tar.gz

{wexample_cli-0.3.0 → wexample_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: Reusable CLI primitives — command decorators, options, middlewares, and the enriched command runner — extracted from wex-core so any kernel built on wexample-app can opt in without depending on the full wex framework.
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -10,7 +10,7 @@ Classifier: Operating System :: OS Independent
 Project-URL: homepage, https://github.com/wexample/python-cli
 Requires-Python: >=3.10
 Requires-Dist: attrs>=23.1.0
-Requires-Dist: wexample-app>=15.2.0
+Requires-Dist: wexample-app>=15.3.0
 Requires-Dist: wexample-helpers>=13.1.0
 Requires-Dist: wexample-prompt>=9.1.0
 Provides-Extra: dev
@@ -20,7 +20,7 @@ Description-Content-Type: text/markdown
 
 # cli
 
-Version: 0.3.0
+Version: 0.4.0
 
 Reusable CLI primitives — command decorators, options, middlewares, and the enriched command runner — extracted from wex-core so any kernel built on wexample-app can opt in without depending on the full wex framework.
 
@@ -100,7 +100,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 ## Dependencies
 
 - attrs: >=23.1.0
-- wexample-app: >=15.2.0
+- wexample-app: >=15.3.0
 - wexample-helpers: >=13.1.0
 - wexample-prompt: >=9.1.0
 

{wexample_cli-0.3.0 → wexample_cli-0.4.0}/README.md

@@ -1,6 +1,6 @@
 # cli
 
-Version: 0.3.0
+Version: 0.4.0
 
 Reusable CLI primitives — command decorators, options, middlewares, and the enriched command runner — extracted from wex-core so any kernel built on wexample-app can opt in without depending on the full wex framework.
 
@@ -80,7 +80,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 ## Dependencies
 
 - attrs: >=23.1.0
-- wexample-app: >=15.2.0
+- wexample-app: >=15.3.0
 - wexample-helpers: >=13.1.0
 - wexample-prompt: >=9.1.0
 

{wexample_cli-0.3.0 → wexample_cli-0.4.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-cli"
-version = "0.3.0"
+version = "0.4.0"
 description = "Reusable CLI primitives — command decorators, options, middlewares, and the enriched command runner — extracted from wex-core so any kernel built on wexample-app can opt in without depending on the full wex framework."
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -19,7 +19,7 @@ classifiers = [
 ]
 dependencies = [
     "attrs>=23.1.0",
-    "wexample-app>=15.2.0",
+    "wexample-app>=15.3.0",
     "wexample-helpers>=13.1.0",
     "wexample-prompt>=9.1.0",
 ]

{wexample_cli-0.3.0 → wexample_cli-0.4.0}/src/wexample_cli/command/extended_command.py

@@ -226,6 +226,27 @@ class ExtendedCommand(Command):
             if value is not None:
                 option.value = function_kwargs[option.name] = value
 
+        # `--` passthrough: if the user supplied extra args after `--`, the
+        # parser put them in parsed_args["__extra_args__"]. Forward them as
+        # `extra_args` if the wrapped function declares that parameter;
+        # otherwise raise so misuse fails loudly instead of silently dropping
+        # input.
+        if "__extra_args__" in parsed_args:
+            import inspect
+
+            sig = inspect.signature(self.command_wrapper.function)
+            if "extra_args" in sig.parameters:
+                function_kwargs["extra_args"] = parsed_args["__extra_args__"]
+            else:
+                from wexample_app.exception.command_unexpected_argument_exception import (
+                    CommandUnexpectedArgumentException,
+                )
+
+                raise CommandUnexpectedArgumentException(
+                    argument="--",
+                    allowed_arguments=self.command_wrapper.get_options_names(),
+                )
+
         return function_kwargs
 
     async def _execute_passes_parallel(

wexample_cli-0.4.0/src/wexample_cli/helpers/extra_args.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import shlex
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from wexample_cli.context.execution_context import ExecutionContext
+
+
+def resolve_shell_command(
+    *,
+    context: ExecutionContext,
+    command: str | None,
+    extra_args: list[str] | None,
+) -> str | None:
+    """Pick the shell command string from `--command "..."` or `-- args...`.
+
+    Pattern intended for commands that wrap an underlying shell call (SSH,
+    docker exec, sub-shell, ...). Returns the resolved command string ready
+    to be passed to the remote shell, or None if neither form was provided
+    (caller should then error/exit).
+
+    - `extra_args` (positional, post-`--`) wins over `command` (legacy `-c`),
+      because positional form is the one that round-trips complex quoting.
+    - Args in `extra_args` are joined with `shlex.join`, which single-quotes
+      tokens that need protection — `$VAR` is NOT expanded by the remote
+      shell, which is the safer default. Use the legacy `--command "..."`
+      form if you intentionally want remote expansion.
+    """
+    if extra_args and command:
+        context.io.warning(
+            "Both --command and `-- <args>` were given; using `-- <args>`."
+        )
+    if extra_args:
+        return shlex.join(extra_args)
+    if command:
+        return command
+    return None