Method command

tests/conftest.py:278–345

(
        self,
        args,
        as_table=False,
        as_lines=False,
        as_json=False,
        cwd=None,
        wait=True,
        expect_fail=None,
        stdin=None,
        log=False,
        ignore_stderr=False,
        env=None,
        use_server_dir=True,
        cmd_prefix: Optional[List[str]] = None,
    )

        return None

    def command(
        self,
        args,
        as_table=False,
        as_lines=False,
        as_json=False,
        cwd=None,
        wait=True,
        expect_fail=None,
        stdin=None,
        log=False,
        ignore_stderr=False,
        env=None,
        use_server_dir=True,
        cmd_prefix: Optional[List[str]] = None,
    ):
        cmd_prefix = cmd_prefix if cmd_prefix is not None else []
        if isinstance(args, str):
            args = [args]
        else:
            args = list(args)

        if isinstance(stdin, str):
            stdin = stdin.encode()

        final_args = cmd_prefix + [get_hq_binary(self.debug)]
        if use_server_dir:
            final_args += ["--server-dir", self.server_dir]
        final_args += args
        cwd = cwd or self.work_path
        environment = self.make_default_env(log=log)
        if env is not None:
            environment.update(env)
        stderr = subprocess.DEVNULL if ignore_stderr else subprocess.STDOUT

        if not wait:
            return subprocess.Popen(final_args, stderr=stderr, cwd=cwd, env=environment)

        else:
            process = subprocess.Popen(
                final_args,
                stdout=subprocess.PIPE,
                stderr=stderr,
                cwd=cwd,
                env=environment,
                stdin=subprocess.PIPE if stdin is not None else subprocess.DEVNULL,
            )
            stdout = process.communicate(stdin)[0].decode()
            if process.returncode != 0:
                if expect_fail:
                    if expect_fail not in stdout:
                        raise Exception(f"Command should failed with message '{expect_fail}' but got:\n{stdout}")
                    else:
                        return
                print(f"Process output: {stdout}")
                raise Exception(f"Process failed with exit-code {process.returncode}\n\n{stdout}")
            if expect_fail is not None:
                raise Exception("Command should failed")