Client._resolve_attached
Resolve live attachment with a single list-clients refresh.
Source and package
- Qualified name
-
libtmux.Client ._resolve _attached - Module
- libtmux
- Declared in
- Client
- Package
- libtmux
- Source
- src/libtmux/client.py
-
Description#
The three
attached_session/attached_window/attached_paneproperties each trigger their ownlist-clientsrefresh — calling them in sequence performs three tmux reads for one conceptual "where is this client attached now" read._resolve_attachedshares a single refresh across the triple and returns the three values together.- Returns
-
tuple[Session | None, Window | None, Pane | None] *
(None, None, None)when tmux no longer reports thisclient_namethroughlist-clients, when the client snapshot has nosession_id, or when the snapshotsession_idno longer names a live session. *(session, None, None)when the attached session has no active window. *(session, window, pane)for a fully-resolved live attachment.paneisNoneonly when the active window has no active pane.MultipleActiveWindowspropagates rather than collapsing to(session, None, None)— multiple active windows in one session indicates inconsistent tmux state that callers should see, not absent attachment.