Utility Classes¶
-
class
cmd2.utils.
StdSim
(inner_stream, echo: bool = False, encoding: str = 'utf-8', errors: str = 'replace')¶ Class to simulate behavior of sys.stdout or sys.stderr. Stores contents in internal buffer and optionally echos to the inner stream it is simulating.
-
class
cmd2.utils.
ByteBuf
(std_sim_instance: cmd2.utils.StdSim)¶ Used by StdSim to write binary data and stores the actual bytes written
-
class
cmd2.utils.
ProcReader
(proc: subprocess.Popen, stdout: Union[cmd2.utils.StdSim, TextIO], stderr: Union[cmd2.utils.StdSim, TextIO])¶ Used to capture stdout and stderr from a Popen process if any of those were set to subprocess.PIPE. If neither are pipes, then the process will run normally and no output will be captured.
-
class
cmd2.utils.
ContextFlag
¶ A context manager which is also used as a boolean flag value within the default sigint handler.
Its main use is as a flag to prevent the SIGINT handler in cmd2 from raising a KeyboardInterrupt while a critical code section has set the flag to True. Because signal handling is always done on the main thread, this class is not thread-safe since there is no need.
-
class
cmd2.utils.
RedirectionSavedState
(self_stdout: Union[cmd2.utils.StdSim, TextIO], sys_stdout: Union[cmd2.utils.StdSim, TextIO], pipe_proc_reader: Optional[cmd2.utils.ProcReader])¶ Created by each command to store information about their redirection.