class RatatuiRuby::Tea::Command::Batch

A fire-and-forget parallel command.

Applications fetch data from multiple sources. Dashboard panels load users, stats, and notifications. Waiting sequentially is slow. Managing threads and error handling manually is error-prone.

This command runs children in parallel. Each child sends its own messages independently. The batch completes when all children finish or when cancellation fires. On cancellation, emits Command.cancel(self).

Use it for parallel fetches, concurrent refreshes, or any work that does not need coordinated results.

Example

def update(msg, model)
  case msg
  in :refresh_all
    batch = Command.batch(
      Command.http(:get, "/users", :users),
      Command.http(:get, "/stats", :stats),
    )
    [model.with(loading: true), batch]
  in :users | :stats
    [model.with(msg => data), nil]
  end
end

Public Class Methods

new (*args)

Source

# File lib/ratatui_ruby/tea/command/batch.rb, line 42
def self.new(*args)
  # DWIM: accept (cmd1, cmd2) or ([cmd1, cmd2])
  commands = (args.size == 1 && args.first.is_a?(Array)) ? args.first : args

  if RatatuiRuby::Debug.enabled?
    commands.each do |cmd|
      unless Ractor.shareable?(cmd)
        raise RatatuiRuby::Error::Invariant,
          "Command is not Ractor-shareable: #{cmd.inspect}\n" \
            "Use Ractor.make_shareable or a Data.define command."
      end
    end
  end

  instance = allocate
  instance.__send__(:initialize, commands: commands.freeze)
  instance
end

Initialize

Public Instance Methods

call (out, token)

Source

# File lib/ratatui_ruby/tea/command/batch.rb, line 62
def call(out, token)
  futures = commands.map do |command|
    Concurrent::Promises.future { command.call(out, token) }
  end

  all_done = Concurrent::Promises.zip_futures(*futures)
  Concurrent::Promises.any_event(all_done, token.origin).wait

  # Re-raise any child exception for runtime to wrap in Command::Error
  futures.each { |f| raise f.reason if f.rejected? }

  out.put(Command.cancel(self)) if token.canceled?
end

Call it