Function run

tools/git_tools.py:29–55

Run a shell command with optional output capture and verbosity. Args: cmd (str | list): The command to run. cwd (str): The current working directory. verbose (bool): If True, print the command being run. **kwargs: Extra arguments passed to subprocess.run().

(cmd, verbose=False, **kwargs)

def run(cmd, verbose=False, **kwargs):
    """
    Run a shell command with optional output capture and verbosity.

    Args:
        cmd (str | list): The command to run.
        cwd (str): The current working directory.
        verbose (bool): If True, print the command being run.
        **kwargs: Extra arguments passed to subprocess.run().

    Returns:
        str | None: If capture is True, returns the command's stdout as a string; otherwise None.
    """
    if verbose:
        print(cmd if isinstance(cmd, str) else shlex.join(cmd))

    result = subprocess.run(cmd,
                            shell=isinstance(cmd, str),
                            check=True,
                            capture_output=True,
                            text=True,
                            **kwargs).stdout.strip()

    if verbose:
        print(result)

    return result


def get_top():