Function shell

contrib/review-prs.py:56–70

Run a shell command, capturing the lines of stdout. The command WILL be parsed in a shell-like fashion. Be careful with quoting when interpolating variables into it. Use shlex.quote() if necessary. suppress_stderr: if False (default), stderr will be sent to the terminal. check_returnco

(cmd: str, suppress_stderr=False, check_returncode=True)

    return result[0]

def shell(cmd: str, suppress_stderr=False, check_returncode=True) -> List[str]:
    """Run a shell command, capturing the lines of stdout.

    The command WILL be parsed in a shell-like fashion. Be careful with quoting when interpolating variables into it. Use shlex.quote() if necessary.

    suppress_stderr: if False (default), stderr will be sent to the terminal.
    check_returncode: if True (default), throw an exception if the return code is nonzero."""

    handle_stderr = subprocess.PIPE if suppress_stderr else None

    # If check is True, a CalledProcessError will be raised on nonzero exit code.
    if ECHO_COMMANDS:
        print(f" > {cmd}")
    result = subprocess.run(["sh", "-c", cmd], stdout=subprocess.PIPE, stderr=handle_stderr, check=check_returncode)
    return result.stdout.decode("utf-8").rstrip().split("\n")

def prompt_chars(prompt: str, chars: str) -> str:
    """Prompt the user with a multiple-choice question."""