Querying and filtering
server.sessions.get(session_name="work") selects by exact name and reports
an absent result. The complete program below uses that lookup, prints the
session name and leaves the existing server running.
Require exactly one match¶
Attaching to tmux provides the complete Python program
and its setup. It searches an existing server for work, prints the name and
reports an absent session. Its launcher checks that the server remains running.
For a more general predicate, decide whether zero or several results are valid before indexing a collection. Keep lookup and command failures visible: another client can change the server between a read and the operation using its result.
Declarative filters¶
Filtering and queries describes this port’s query APIs, accepted fields and result-count contracts. Use that contract when storing a query in configuration.
Case-insensitive matching¶
Choose case handling explicitly when your query needs it. The attach program
uses exact case because the intended session is named work.
Push the filter into tmux, or read once and filter locally¶
A tmux-side filter reduces returned rows; a captured collection can answer several local queries from one read. Neither reserves the result. Check unexpectedly empty format values before assuming that an object does not exist.