Server.panes(where:)
Panes matching expression.
Source and package
- Qualified name
-
Server.panes(where:) - Declared in
Server- Package
- libtmux-swift
- Source
- Sources/LibTmux/FilteredListings.swift
-
Examples#
Filter panes with a typed expression. Create an inactive split and ask for active panes using a FilterExpr built from a Swift key path. The server evaluates the filter and returns matching Pane snapshots; the original pane stays active. Use Swift 6.2 or newer and tmux 3.3a or newer on Linux or macOS. In an empty directory, save this consumer package as
Package.swift; SwiftPM fetches the library from release 0.1.1:// swift-tools-version: 6.2import PackageDescriptionlet package = Package(name: "ApiExample",platforms: [.macOS(.v13)],dependencies: [.package(url: "https://github.com/libtmux/libtmux-swift.git", from: "0.1.1")],targets: [.executableTarget(name: "ApiExample",dependencies: [.product(name: "LibTmux", package: "libtmux-swift"),.product(name: "TmuxFixture", package: "libtmux-swift"),],path: "Sources")])Create a
Sourcesdirectory and save this complete program asSources/Example.swift. ThewithTmuxServerfixture owns a private tmux server and stops it after success or failure. Ordinary application code usesServerfor its own socket; these examples use the fixture until their setup moves to ordinary server objects. View sourceimport Foundationimport LibTmuximport TmuxFixture@mainstruct ApiQueryPanes {static func main() async {do {try await withTmuxServer { @Sendable server inguard let original = try await server.panes().first else {throw ExampleError.paneMissing}_ = try await server.split(original, direction: .right)let expression = try FilterExpr<Pane>.where(\.isActive, .equals(true))let active = try await server.panes(where: expression)print("Active panes: \(active.count)")print("Original stays active: \(active.contains { $0.id == original.id })")}} catch {FileHandle.standardError.write(Data("Example failed: \(error)\n".utf8))exit(EXIT_FAILURE)}}enum ExampleError: Error {case paneMissing}}Build and run the saved program. An operation or cleanup error produces a failing exit status. Set
LIBTMUX_TMUX_BINto an absolute executable path to select a tmux version:Terminal window $ swift run ApiExampleExpected output:
Active panes: 1Original stays active: true- Parameters
-
-
where(FilterExpr <Pane>) #
-
- Raises
tmux command#
The tmux commands behind panes(where:).
list-panes -a server scope, cmd_list_panes_server tmux C API#
The C declarations in tmux that implement these commands.