Window.hook
Read one hook's commands, or None when it holds nothing.
Source and package
- Qualified name
-
libtmux::window:: Window:: hook - Module
- window
- Declared in
Window- Package
- libtmux
- Source
- crates/libtmux/src/window/settings.rs
-
Description#
There is deliberately no listing counterpart at this scope. tmux does not enumerate hooks set on a window or a pane:
show-hooksreports nothing for them, andshow-optionsomits them while still listing ordinary options. A listing here could only ever answer empty, which would read as "no hooks" rather than "tmux will not say". Reading one by name works, so that is what is offered;crate::Server::hooks()andcrate::Session::hooks()list the scopes tmux does enumerate.Errors
Returns an error when tmux cannot be reached or refuses the listing.
Examples#
let guard = libtmux::test::TestServer::new().await?;let session = guard.server().new_session("hooked").await?;let window = session.new_window("w").await?;assert!(window.hook("pane-died").await?.is_none());window.set_hook("pane-died", "display-message rang").await?;assert!(window.hook("pane-died").await?.is_some());guard.shutdown().await?;