+ ,jf^RIHt^RIHt^RIHtRt!RR4t R# ]]3dRtLi;i) ) annotations)Optional) PyPtySessionTFc]tRt^t$RtR]R&RRlt]RRl4tRR lt R R lt R R lt RRlt RRRllt RRltRtR#) PtySessiona A pseudoterminal (PTY) session for interactive shell use. This is the higher-level PTY API built on top of PtyProcess. It provides convenient methods for interactive shell sessions with: - Easy command sending via send_line() - Interactive mode with wait_until pattern matching - Automatic buffering and flushing Use this for interactive shell sessions where you want to send commands and optionally hand over control to the user. r_innerc V^8dQhRRRR/#)commandz list[str]returnNone)formats"7lib/python3.14/site-packages/rattler/pty/pty_session.py __annotate__PtySession.__annotate__s',', ',d',c T\'g \R4h\V4VnR#)a Create a new PTY session with the given command. The PTY session is created with echo enabled by default, which is appropriate for interactive shell use. Arguments: command: A list of strings representing the command and its arguments. The first element is the executable, subsequent elements are arguments. Raises: RuntimeError: If the PTY session could not be created. Examples -------- ```python >>> from rattler.pty import PtySession >>> # Start an interactive bash session >>> session = PtySession(["bash"]) >>> session.send_line("export MY_VAR=hello") >>> # Hand over control to the user (blocks until shell exits) >>> exit_code = session.interact() >>> ``` If you want to send commands without using interact() (which blocks), use exit() to clean up when done: ```python >>> from rattler.pty import PtySession >>> session = PtySession(["bash"]) >>> session.send_line("echo hello") >>> status = session.exit() # Clean up the session >>> ``` z3PTY functionality is not available on this platformN)_PTY_AVAILABLE ImportErrorrr)selfr s&&r__init__PtySession.__init__s"J~ST T"7+ rc V^8dQhRRRR/#)r py_pty_sessionrr rr)rs"rrrHs,:rc 4VPV4pWnV#)z'Construct from FFI PyPtySession object.)__new__r)clsrsessions&& r_from_py_pty_sessionPtySession._from_py_pty_sessionGs++c"'rc V^8dQhRRRR/#)r linestrr intr)rs"rrrNs++c+c+rc 8VPPV4#)ar Send a string followed by a newline to the PTY session. This is like typing a command and pressing Enter. The command is flushed immediately, so the shell will receive it right away. Arguments: line: The string to send (newline will be added automatically). Returns: The number of bytes written. Raises: RuntimeError: If the write operation fails. Examples -------- ```python >>> from rattler.pty import PtySession >>> session = PtySession(["bash"]) >>> session.send_line("export MY_VAR=hello") 22 >>> session.send_line("echo $MY_VAR") 13 >>> session.exit() # Clean up when done 'Signaled(SIGTERM)' >>> ``` )r send_line)rr#s&&rr'PtySession.send_lineNs<{{$$T**rc V^8dQhRRRR/#)r datar$r r%r)rs"rrrns&&&&rc 8VPPV4#)a Send a string to the PTY session without adding a newline. Note: You'll need to call flush() to ensure the data is sent. Arguments: data: The string to send. Returns: The number of bytes written. Raises: RuntimeError: If the write operation fails. Examples -------- ```python >>> from rattler.pty import PtySession >>> session = PtySession(["bash"]) >>> session.send("echo") 4 >>> session.send(" hello\n") 7 >>> session.flush() >>> session.exit() # Clean up when done 'Signaled(SIGTERM)' >>> ``` )rsend)rr*s&&rr,PtySession.sendns<{{%%rcV^8dQhRR/#)r r r r)rs"rrrstrc :VPP4R#)a Flush any pending output to the PTY. This is automatically called by send_line(), but can be called manually if you use send(). Raises: RuntimeError: If the flush operation fails. Examples -------- ```python >>> from rattler.pty import PtySession >>> session = PtySession(["bash"]) >>> session.send("echo hello\n") 11 >>> session.flush() # Make sure the command is sent >>> session.exit() # Clean up when done 'Signaled(SIGTERM)' >>> ``` N)rflushrs&rr0PtySession.flushs. rcV^8dQhRR/#r r r$r)rs"rrrs""c"rc 6VPP4#)a Exit the process gracefully by sending SIGTERM. This method blocks until the process has exited. Useful for cleaning up PTY sessions when you're done sending commands but don't want to use interact(). Returns: A string describing the exit status. Raises: RuntimeError: If the process could not be terminated. Examples -------- ```python >>> from rattler.pty import PtySession >>> session = PtySession(["bash"]) >>> session.send_line("echo hello") 11 >>> status = session.exit() >>> print(status) Signaled(SIGTERM) >>> ``` )rexitr1s&rr6PtySession.exits4{{!!rNc V^8dQhRRRR/#)r wait_untilz Optional[str]r z Optional[int]r)rs"rrrs+0+0=+0M+0rc 8VPPV4#)a Start an interactive session, optionally waiting for a pattern first. This method: 1. Sets the terminal to raw mode 2. If wait_until is provided, buffers output until that pattern appears 3. Then forwards all I/O between the user's terminal and the PTY 4. Returns when the shell process exits Arguments: wait_until: Optional pattern to wait for before showing output. Useful for waiting for shell initialization to complete. If not found within 1 second, a warning is shown and interaction begins anyway. Returns: The exit code of the shell process, or None if terminated by signal. Raises: RuntimeError: If interaction fails. Examples -------- ```python >>> session = PtySession(["bash"]) >>> # Send some setup commands >>> session.send_line("export MY_VAR=hello") >>> session.send_line("echo 'READY'") >>> # Wait for "READY" before handing control to user >>> exit_code = session.interact(wait_until="READY") >>> print(f"Session exited with code: {exit_code}") Session exited with code: 0 >>> ``` ```python >>> session = PtySession(["bash"]) >>> # Interact immediately without waiting >>> exit_code = session.interact() >>> ``` )rinteract)rr9s&&rr;PtySession.interactsV{{##J//rcV^8dQhRR/#r4r)rs"rrrs#rc R#)z PtySession()rr1s&r__repr__PtySession.__repr__sr)r)N)__name__ __module__ __qualname____firstlineno____doc____annotations__r classmethodr r'r,r0r6r;r?__static_attributes__rrrrrsO  ',R +@&@2"8+0ZrrN) __future__rtypingrrattler.rattlerrrrAttributeErrorrrrrrMs?",N cc ^$Ns " 00