Add Radicli.call

Author: ines

README.md

@@ -502,6 +502,20 @@ if __name__ == "__main__":
 | -------- | --------------------- | ----------------------------------------------------------------------------------------- |
 | `args`   | `Optional[List[str]]` | Optional command to pass in. Will be read from `sys.argv` if not set (standard use case). |
 
+#### <kbd>method</kbd> `Radicli.call`
+
+Call a command with args.
+
+```python
+command = cli.commands["hello"]
+cli.call(command, ["Alex", "--age", "35"])
+```
+
+| Argument  | Type                  | Description                                                                               |
+| --------- | --------------------- | ----------------------------------------------------------------------------------------- |
+| `command` | `Command`             | The command.                                                                              |
+| `args`    | `Optional[List[str]]` | Optional command to pass in. Will be read from `sys.argv` if not set (standard use case). |
+
 #### <kbd>method</kbd> `Radicli.parse`
 
 Parse a list of arguments for a given command. Typically internals, but can also be used for testing.

radicli/cli.py

@@ -6,6 +6,7 @@
 from pathlib import Path
 from contextlib import contextmanager
 import json
+import copy
 
 from .parser import ArgumentParser, HelpFormatter
 from .util import Arg, ArgparseArg, get_arg, join_strings, format_type, format_table
@@ -249,6 +250,15 @@ def func(*args, **kwargs) -> None:
         )
         self.commands[name] = dummy
 
+    def call(self, command: Command, args: Optional[List[str]] = None) -> None:
+        """Call a single command."""
+        run_args = args if args is not None else [*sys.argv[1:]]
+        cmd = copy.deepcopy(command)
+        cmd.name = ""  # for nicer display in help text
+        values = self.parse(run_args, cmd)
+        with self.handle_errors():
+            command.func(**values)
+
     def run(self, args: Optional[List[str]] = None) -> None:
         """
         Run the CLI. Should typically be used in the __main__.py nested under a