Core Library0.xAPI Reference

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

method libtmux-rs latest

Session.hooks

Read every hook set at this session.

Source and package
Qualified name
libtmux::session::Session::hooks
Module
session
Declared in
Session
Package
libtmux
Source
crates/libtmux/src/session/settings.rs
Other languages
Perlmethod Erlang PowerShell Julia Elixir Haskell Common Lisp PythonRubyLuaTypeScriptGoJavaC#C++Swift Kotlin Scala OCamlfunction F# Clojure
pub async fn hooks(&self) -> Result< BTreeMap<String, IndexedHooks>, Error >

Description#

Only hooks holding something are reported: tmux lists every hook name it knows, and the ones holding nothing are absent here rather than present and empty.

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?;
session.set_hook("alert-bell", "display-message rang").await?;
let hooks = session.hooks().await?;
assert!(hooks.contains_key("alert-bell"));
guard.shutdown().await?;

tmux hooks#

Events that run tmux commands, with the scope each hook belongs to and where tmux fires it.

In other ports#

Read a session's hooks

Equivalents of Read a session's hooks in other languages
Language Equivalent
Python libtmux.Session.show_hooks
Ruby LibTmux::Session#hooks
Lua libtmux.Session:list_hooks
Haskell No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing.
TypeScript session.Session.showHooks
Go tmux.Session.Hooks
Java io.github.libtmux.Session.hooks
C# LibTmux.Session.Hooks
C++ libtmux::Session::hooks
Swift Server.hooks(_:)
OCaml Libtmux_unix.Client.capture_hooks Pass the corresponding explicit Options scope; captured tables preserve their source and inheritance policy.
Perl LibTmux::Server::show_hooks Use an explicit session target ID; raw bytes preserve sparse hook indexes and tmux quoting.

No equivalent is recorded in PowerShell, Julia, Erlang, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.

Esc

Type to search.

Reference previewOpen reference