Source at 4d73c9795adca3e49eea74d1d2cbbbbdcbea0b6c
SHA-256: a17fa14cc48c9f5d55f66ab02fd1e30b63179512e3ec2eff6e1e12dde0c99da3
# Build commands before running them Prepare a literal session rename and a pane resize, then submit the values explicitly. Building validates their captured target and arguments without contacting tmux. Execution checks the endpoint origin and returns the native one-shot result. The resize uses an operation handle so waiting is explicit. This complete program checks the name before execution, awaits the resize, reads fresh dimensions and verifies that earlier rows keep their values. The runner owns the private fixture and verifies cleanup: ```console $ mise exec -- escript tools/run_examples.escript commands ``` <!-- example: examples/command_demo.erl --> ```erlang -module(command_demo). -moduledoc "Build captured-target commands, then execute and inspect them.". -export([run/2]). -spec run(binary(), binary()) -> map(). run(Socket, Executable) -> Endpoint = #{socket_path => Socket, executable => Executable}, {ok, Server} = tmux_server:open(Endpoint), tmux_scope:run_or_error(fun() -> {ok, Session} = tmux_session:create(Server, #{name => <<"commands">>, width => 120, height => 30, launch => #{argv => [<<"/bin/cat">>]}}), tmux_scope:run_or_error(fun() -> SessionId = tmux_model:get(id, Session), {ok, Snapshot} = tmux_server:snapshot(Server), [Anchor] = tmux_snapshot:panes(Snapshot), {ok, Pane} = tmux_pane:split(Anchor, #{direction => horizontal, size => {cells, 40}, launch => #{argv => [<<"/bin/cat">>]}}), {ok, Rename} = tmux_session:rename_command( Session, <<"commands-ready">>), {ok, Resize} = tmux_pane:resize_command(Pane, #{width => 60}), {ok, OtherEndpoint} = tmux_server:open(Endpoint), tmux_scope:run_or_error(fun() -> {error, #{code := different_owner, submitted := false}} = tmux_server:command(OtherEndpoint, Rename, #{}) end, fun() -> ok = tmux_server:close(OtherEndpoint) end), {ok, Before} = tmux_session:get(Server, SessionId), <<"commands">> = tmux_model:get(name, Before), 40 = tmux_model:get(width, Pane), {ok, #{exit_status := 0, cleanup := complete}} = tmux_server:command(Server, Rename, #{}), {ok, Operation} = tmux_operation:start(Server, Resize, #{}), {ok, #{exit_status := 0, cleanup := complete}} = tmux_operation:await(Operation, 900), {ok, Current} = tmux_pane:get(Server, tmux_model:get(id, Pane)), 60 = tmux_model:get(width, Current), {ok, Renamed} = tmux_session:get(Server, SessionId), <<"commands-ready">> = tmux_model:get(name, Renamed), <<"commands">> = tmux_model:get(name, Session), 40 = tmux_model:get(width, Pane), #{name => <<"commands-ready">>, initial_width => 40, actual_width => 60, captured_values_unchanged => true, foreign_origin_rejected => true} end, fun() -> {ok, _} = tmux_session:kill(Session), ok end) end, fun() -> ok = tmux_server:close(Server) end). ``` <!-- example-output: command_demo --> ```json { "name": "commands-ready", "initial_width": 40, "actual_width": 60, "captured_values_unchanged": true, "foreign_origin_rejected": true } ``` The archive check runs this program through the installed public package. `tmux_session:rename/2` and `tmux_pane:resize/2` perform their operations immediately; their command builders return reusable values. Reusing a value requires explicit intent each time. An uncertain mutation result must not trigger an automatic retry. A command keeps the originating row's endpoint token. Submitting it through another endpoint returns `different_owner` with `submitted = false`, even if both servers happen to use the same pane or session ID. Building alone does not establish endpoint liveness. The example rejects a second endpoint handle to the same daemon too. To act through another endpoint, bind the row there and build a new command. Bind detached rows with `tmux_server:bind/2` before building their commands. `tmux_command:to_config/1` renders command syntax without executing it. Serialized configuration carries no origin token; the caller must choose and validate that destination explicitly. See [jobs and operations](jobs.md) for wait timeouts, ownership and cancellation, the [configuration guide](configuration.md) for rendering, and [current support](compatibility.md) for transport qualification.