Function run_cmd

monai/utils/misc.py:877–907

Run a command by using ``subprocess.run`` with capture_output=True and stderr=subprocess.STDOUT so that the raise exception will have that information. The argument `capture_output` can be set explicitly if desired, but will be overriden with the debug status from the variable. Arg

(cmd_list: list[str], **kwargs: Any)

def run_cmd(cmd_list: list[str], **kwargs: Any) -> subprocess.CompletedProcess:
    """
    Run a command by using ``subprocess.run`` with capture_output=True and stderr=subprocess.STDOUT
    so that the raise exception will have that information. The argument `capture_output` can be set explicitly
    if desired, but will be overriden with the debug status from the variable.

    Args:
        cmd_list: a list of strings describing the command to run.
        kwargs: keyword arguments supported by the ``subprocess.run`` method.

    Returns:
        a CompletedProcess instance after the command completes.
    """
    debug = MONAIEnvVars.debug()
    # Always capture output when check=True so that error details are available
    # in the CalledProcessError exception for debugging subprocess failures.
    if kwargs.get("check", False):
        kwargs.setdefault("capture_output", True)
    else:
        kwargs["capture_output"] = kwargs.get("capture_output", debug)

    if kwargs.pop("run_cmd_verbose", False):
        import monai

        monai.apps.utils.get_logger("monai.utils.run_cmd").info(f"{cmd_list}")  # type: ignore[attr-defined]
    try:
        return subprocess.run(cmd_list, **kwargs)
    except subprocess.CalledProcessError as e:
        output = str(e.stdout.decode(errors="replace")) if e.stdout else ""
        errors = str(e.stderr.decode(errors="replace")) if e.stderr else ""
        raise RuntimeError(f"subprocess call error {e.returncode}: {errors}, {output}") from e


def is_sqrt(num: Sequence[int] | int) -> bool: