Method _read_raw_input

cmd2/cmd2.py:3435–3491

Execute the low-level input read from either a terminal or a redirected stream. If input is coming from a TTY, it uses `prompt_toolkit` to render a UI with completion and `patch_stdout` protection. Otherwise it performs a direct line read from `stdin`. :param prompt

(
        self,
        prompt: Callable[[], ANSI | str] | ANSI | str,
        session: PromptSession[str],
        **prompt_kwargs: Any,
    )

        return not isinstance(session.input, DummyInput)

    def _read_raw_input(
        self,
        prompt: Callable[[], ANSI | str] | ANSI | str,
        session: PromptSession[str],
        **prompt_kwargs: Any,
    ) -> str:
        """Execute the low-level input read from either a terminal or a redirected stream.

        If input is coming from a TTY, it uses `prompt_toolkit` to render a
        UI with completion and `patch_stdout` protection. Otherwise it performs
        a direct line read from `stdin`.

        :param prompt: the prompt text or a callable that returns the prompt.
        :param session: the PromptSession instance to use for reading.
        :param prompt_kwargs: additional arguments passed directly to session.prompt().
        :return: the stripped input string.
        :raises EOFError: if the input stream is closed or the user signals EOF (e.g., Ctrl+D)
        """
        # Check if the session is configured for interactive terminal use.
        if self._is_tty_session(session):
            if not callable(prompt):
                prompt = pt_filter_style(prompt)

            with patch_stdout():
                try:
                    # Set this session as the active one for UI/completion logic.
                    self.active_session = session
                    return session.prompt(prompt, **prompt_kwargs)
                finally:
                    # Revert back to the main session.
                    self.active_session = self.main_session

        # We're not at a terminal, so we're likely reading from a file or a pipe.
        prompt_obj = prompt() if callable(prompt) else prompt
        prompt_str = prompt_obj.value if isinstance(prompt_obj, ANSI) else prompt_obj

        # If this is an interactive pipe, then display the prompt first
        if self.interactive_pipe:
            self.poutput(prompt_str, end="")
            self.stdout.flush()

        # Wait for the next line of input
        line = self.stdin.readline()

        # If the stream is empty, we've reached the end of the input.
        if not line:
            raise EOFError

        # If not interactive and echo is on, we want the output to simulate a
        # live session. Print the prompt and the command so they appear in the
        # output stream before the results.
        if not self.interactive_pipe and self.echo:
            end = "" if line.endswith("\n") else "\n"

            self.poutput(f"{prompt_str}{line}", end=end)

        return line.rstrip("\r\n")