Pane.send_keys
Behavior: Pane input and capture.
Source and package
-
Description#
Behavior contract: Pane input and capture.
Examples#
Send a command to a shell, poll the pane until its output line appears, then capture it. Match a whole output line so the echoed command cannot satisfy the check. Use Ruby 3.3 or newer with Bundler, and tmux 3.3a or newer, on Unix with
/bin/catand/bin/shavailable. In an empty directory, save thisGemfile:source "https://rubygems.org"gem "libtmux", "0.1.1"Save this complete program as
capture.rb. ItsServer.start()block owns a private tmux server and stops it on exit, including after an error. View source# frozen_string_literal: truebegin# docs:begin mainrequire "libtmux"LibTmux::Server.start do |server|created = server.new_session(name: "capture", command: ["/bin/sh"],environment: {"ENV" => "/dev/null"}, receipt: true)pane = created.panepane.send_text("printf '\\nlibtmux capture ready\\n'")pane.send_keys("Enter")deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + 5captured = pane.capture.stdout.lines(chomp: true)until captured.include?("libtmux capture ready")raise "Output did not arrive within five seconds" if Process.clock_gettime(Process::CLOCK_MONOTONIC) > deadlinesleep 0.05captured = pane.capture.stdout.lines(chomp: true)endraise "Expected output is absent from the pane" unless captured.include?("libtmux capture ready")puts "libtmux capture ready"end# docs:end mainrescue StandardError => errorwarn "#{error.class}: #{error.message}"exit 1endInstall the gem and run the program. An operation or cleanup error makes it exit unsuccessfully:
Terminal window $ bundle install && \bundle exec ruby capture.rbExpected output:
libtmux capture ready
tmux command#
The tmux commands behind send_keys.
tmux C API#
The C declarations in tmux that implement these commands.
In other ports#
Send keystrokes to a pane
| Language | Equivalent |
|---|---|
| Python | libtmux |
| Lua | libtmux |
| TypeScript | pane |
| Rust | pane |
| Go | tmux |
| Java | no direct equivalent; Pane.paste writes a buffer instead |
| Kotlin | io |
| Scala | io |
| C# | Lib |
| C++ | libtmux:: |
| Swift | Server |
No equivalent is recorded in PowerShell, Julia, Elixir or F#.