Add isctest.run.cmd() helper function

diff --git a/bin/tests/system/isctest/run.py b/bin/tests/system/isctest/run.py
index 2efb39d1371fbb55ba98f6fe4da1c09d4c3e0be4..e48e1c1b57c225e45cea64596e333287f64b033f 100644 (file)
--- a/bin/tests/system/isctest/run.py
+++ b/bin/tests/system/isctest/run.py
@@ -9,7 +9,56 @@
 # See the COPYRIGHT file distributed with this work for additional
 # information regarding copyright ownership.
 
+import subprocess
 import time
+from typing import Optional
+
+import isctest.log
+
+
+def cmd(  # pylint: disable=too-many-arguments
+    args,
+    cwd=None,
+    timeout=60,
+    stdout=subprocess.PIPE,
+    stderr=subprocess.PIPE,
+    log_stdout=False,
+    log_stderr=True,
+    input_text: Optional[bytes] = None,
+    raise_on_exception=True,
+):
+    """Execute a command with given args as subprocess."""
+    isctest.log.debug(f"command: {' '.join(args)}")
+
+    def print_debug_logs(procdata):
+        if procdata:
+            if log_stdout and procdata.stdout:
+                isctest.log.debug(
+                    f"~~~ cmd stdout ~~~\n{procdata.stdout.decode('utf-8')}\n~~~~~~~~~~~~~~~~~~"
+                )
+            if log_stderr and procdata.stderr:
+                isctest.log.debug(
+                    f"~~~ cmd stderr ~~~\n{procdata.stderr.decode('utf-8')}\n~~~~~~~~~~~~~~~~~~"
+                )
+
+    try:
+        proc = subprocess.run(
+            args,
+            stdout=stdout,
+            stderr=stderr,
+            input=input_text,
+            check=True,
+            cwd=cwd,
+            timeout=timeout,
+        )
+        print_debug_logs(proc)
+        return proc
+    except subprocess.CalledProcessError as exc:
+        print_debug_logs(exc)
+        isctest.log.debug(f"  return code: {exc.returncode}")
+        if raise_on_exception:
+            raise exc
+        return exc
 
 
 def retry_with_timeout(func, timeout, delay=1, msg=None):