On this page

window.Window.cmd

Module: window
Declared in: Window
Package: libtmux
Source: crates/libtmux/src/window.rs

cmd ( self , command : Command ) → Result<CommandResult, Error> method [source] ¶ method [source] ¶ cmd

Run a raw tmux command against this window.

The escape hatch for anything this crate does not wrap. -t is placed after the subcommand for you, because tmux stops reading flags at the first positional: a target appended after one is taken as text, and the command then succeeds having acted on something else.

A non-zero exit status comes back in the [ CommandResult ] rather than as an error, the same as crate::Server::cmd.

Errors

Returns an error when the process cannot be started, captured, or awaited.

Examples

let guard = libtmux::test::TestServer::new().await?;
let session = guard.server().new_session("raw").await?;
let window = session.active_window().await?.expect("a window");

let result = window
    .cmd(libtmux::Command::new("display-message").arg("-p").arg("#{window_id}"))
    .await?;
assert_eq!(result.stdout_lossy().trim(), window.id().to_string());

guard.shutdown().await?;

0 declared, 0 inherited