Class: Microsandbox::ExecHandle

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/microsandbox/exec_handle.rb

Overview

A live, streaming command execution, returned by Sandbox#exec_stream and Sandbox#shell_stream.

Iterate it (it is Enumerable) to consume ExecEvents as they arrive, or call #collect to drain it into an ExecOutput.

Examples:

handle = sb.exec_stream("python", ["-u", "script.py"])
handle.each do |event|
  print event.text if event.stdout? || event.stderr?
end

Instance Method Summary collapse

Constructor Details

#initialize(native) ⇒ ExecHandle

Returns a new instance of ExecHandle.



93
94
95
 
# File 'lib/microsandbox/exec_handle.rb', line 93

def initialize(native)
  @native = native
end

Instance Method Details

#collect ⇒ ExecOutput

Drain the stream and collect all output.

Returns:



123
124
125
 
# File 'lib/microsandbox/exec_handle.rb', line 123

def collect
  ExecOutput.new(@native.collect)
end

#each {|event| ... } ⇒ self, Enumerator

Yield each Microsandbox::ExecEvent until the stream ends. Returns an Enumerator when called without a block.

Yield Parameters:

Returns:

  • (self, Enumerator) 


106
107
108
109
110
111
112
113
 
# File 'lib/microsandbox/exec_handle.rb', line 106

def each
  return enum_for(:each) unless block_given?

  while (event = @native.recv)
    yield ExecEvent.new(event)
  end
  self
end

#id ⇒ String

Returns the correlation id for this execution.

Returns:

  • (String) —

    the correlation id for this execution



98
99
100
 
# File 'lib/microsandbox/exec_handle.rb', line 98

def id
  @native.id
end

#kill ⇒ nil

Kill the running process (SIGKILL).

Returns:

  • (nil) 


136
137
138
139
 
# File 'lib/microsandbox/exec_handle.rb', line 136

def kill
  @native.kill
  nil
end

#resize(rows, cols) ⇒ nil

Resize the pseudo-terminal (only meaningful when started with tty: true).

Returns:

  • (nil) 


143
144
145
146
 
# File 'lib/microsandbox/exec_handle.rb', line 143

def resize(rows, cols)
  @native.resize(Integer(rows), Integer(cols))
  nil
end

#signal(sig) ⇒ nil

Send a signal (integer) to the running process.

Returns:

  • (nil) 


129
130
131
132
 
# File 'lib/microsandbox/exec_handle.rb', line 129

def signal(sig)
  @native.signal(Integer(sig))
  nil
end

#stdin ⇒ ExecStdin?

The stdin writer, or nil if stdin was not piped. Returned only once.

Returns:



150
151
152
153
154
155
 
# File 'lib/microsandbox/exec_handle.rb', line 150

def stdin
  return @stdin if defined?(@stdin)

  native_sink = @native.take_stdin
  @stdin = native_sink && ExecStdin.new(native_sink)
end

#wait ⇒ ExitStatus

Block until the process exits.

Returns:



117
118
119
 
# File 'lib/microsandbox/exec_handle.rb', line 117

def wait
  ExitStatus.new(@native.wait)
end