lib.util.run_cmd(): Add parameter ec: ExecContext

Allow to specify the ExecContext in a call to run_cmd(). This
effectively makes run_cmd() an thin wrapper around ExecContext.run(),
which is what's going to be used in the future. The wrapper is for
backwards-compatibility.

Signed-off-by: Jan Lindemann <jan@janware.com>

src/python/jw/pkg/lib/ExecContext.py

@@ -22,8 +22,50 @@ class ExecContext(abc.ABC):
     async def _run(self, *args, **kwargs) -> Result:
         pass
 
-    async def run(self, *args, **kwargs) -> Result:
-        return await self._run(*args, **kwargs)
+    async def run(
+        self,
+        args: list[str],
+        wd: str|None = None,
+        throw: bool = True,
+        verbose: bool = False,
+        cmd_input: str|None = None,
+        env: dict[str, str]|None = None,
+        title: str=None,
+        output_encoding: str|None = None,  # None => unchanged; "bytes" => return raw bytes
+    ) -> Result:
+        """
+        Run a command asynchronously and return its output
+
+        Args:
+            args:    Command and arguments
+            wd:      Optional working directory
+            throw:   Raise an exception on non-zero exit status if True
+            verbose: Emit log output while the command runs
+            cmd_input:
+                - None                 -> stdin from /dev/null
+                - "mode:interactive"   -> Inherit terminal stdin
+                - "mode:auto"          -> Inherit terminal stdin if it is a TTY
+                - otherwise            -> String fed to stdin
+            output_encoding:
+                - None      -> unchanged behavior (decode stdout via sys.stdout.encoding, stderr via sys.stderr.encoding)
+                - "bytes"   -> return raw bytes instead of decoded strings
+                - otherwise -> decode stdout/stderr using this encoding
+
+        Returns:
+            (stdout, stderr, exit_status):
+              stdout: stderr each as a string/bytes or None
+              In PTY mode stderr is always None because PTY merges stdout/stderr.
+        """
+        return await self._run(
+            args=args,
+            wd=wd,
+            throw=throw,
+            verbose=verbose,
+            cmd_input=cmd_input,
+            env=env,
+            title=title,
+            output_encoding=output_encoding
+        )
 
     @abc.abstractmethod
     async def _sudo(self, cmd: list[str], mod_env: dict[str, str] = {}, opts: list[str]=[], verbose=True) -> Result: