Struct TerminalHandle 

pub struct TerminalHandle { /* private fields */ }

Available on crate feature terminal only.

Handle to a running terminal instance.

Multiple Terminal components can share the same handle. The PTY is closed when the last handle is dropped.

Implementations

impl TerminalHandle

pub fn new( id: TerminalId, command: CommandBuilder, scrollback_length: Option<usize>, ) -> Result<TerminalHandle, TerminalError>

Spawn a PTY for command and return a handle. Defaults to 1000 lines of scrollback when scrollback_length is None.

Example

use freya_terminal::prelude::*;
use portable_pty::CommandBuilder;

let mut cmd = CommandBuilder::new("bash");
cmd.env("TERM", "xterm-256color");

let handle = TerminalHandle::new(TerminalId::new(), cmd, None).unwrap();

pub fn write(&self, data: &[u8]) -> Result<(), TerminalError>

Write data to the PTY. Drops any selection and snaps the viewport to the bottom.

pub fn last_write_elapsed(&self) -> Duration

Time since the user last wrote input to the PTY.

pub fn write_key( &self, key: &Key, modifiers: Modifiers, ) -> Result<bool, TerminalError>

Write a key event to the PTY as the matching escape sequence. Returns whether it was recognised.

pub fn paste(&self, text: &str) -> Result<(), TerminalError>

Paste text into the PTY, wrapping in bracketed-paste markers if the app enabled them.

pub fn resize(&self, rows: u16, cols: u16)

Resize the terminal. Lossless: the grid reflows on width, preserves scrollback on height.

pub fn scroll(&self, delta: i32)

Scroll by delta. Positive moves up into scrollback (vt100 convention).

pub fn scroll_to_bottom(&self)

Scroll to the bottom of the buffer.

pub fn cwd(&self) -> Option<PathBuf>

Current working directory reported via OSC 7.

pub fn title(&self) -> Option<String>

Window title reported via OSC 0 / 2.

pub fn clipboard_content(&self) -> Option<String>

Latest clipboard content set via OSC 52.

pub fn mouse_move(&self, row: f32, col: f32)

Handle a mouse move/drag. row and col are fractional cell units; the fraction of col picks which cell half anchors the selection.

pub fn mouse_down( &self, row: f32, col: f32, button: TerminalMouseButton, selection_type: SelectionType, )

Handle a mouse button press. selection_type picks the selection kind when not in mouse mode: SelectionType::Semantic for double-click (word), SelectionType::Lines for triple-click. See Self::mouse_move for the fractional coordinates.

pub fn mouse_up(&self, row: f32, col: f32, button: TerminalMouseButton)

Handle a mouse button release.

pub fn release(&self)

Handle a mouse button release from outside the terminal viewport.

pub fn wheel(&self, delta_y: f64, row: f32, col: f32)

Route a wheel event to scrollback, PTY mouse, or arrow-key sequences depending on the active mouse mode and alt-screen state (matches wezterm/kitty).

pub fn term(&self) -> Ref<'_, Term<EventProxy>>

Borrow the underlying alacritty Term for direct read access.

pub fn output_received(&self) -> impl Future<Output = ()>

Future that completes each time new output is received from the PTY.

pub fn title_changed(&self) -> impl Future<Output = ()>

Future that completes when the window title changes (OSC 0 / OSC 2).

pub fn clipboard_changed(&self) -> impl Future<Output = ()>

Future that completes when clipboard content changes (OSC 52).

pub fn closed(&self) -> impl Future<Output = ()>

Future that completes when the PTY closes.

pub fn id(&self) -> TerminalId

Unique identifier for this terminal instance.

pub fn shift_pressed(&self, pressed: bool)

Track whether shift is currently pressed.

pub fn start_selection(&self, row: f32, col: f32, selection_type: SelectionType)

Start a new selection of selection_type. See Self::mouse_move for the fractional coordinates.

pub fn update_selection(&self, row: f32, col: f32)

Extend the in-progress selection, if any.

pub fn get_selected_text(&self) -> Option<String>

Currently selected text, if any.

Trait Implementations

impl Clone for TerminalHandle

fn clone(&self) -> TerminalHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl PartialEq for TerminalHandle

fn eq(&self, other: &TerminalHandle) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.