bsdkrun 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b23de4b48a88b521c5909ad2aa610d8557e9b06661e450db3d862292cc3bb296
-  data.tar.gz: be6175dd5884c7ec861a57f355c3dff05d01e759355117d8e21e27904b717063
+  metadata.gz: 14072fa1b965040c136001ee65a8ef384205cbc119ef91658c387e2ed84100fb
+  data.tar.gz: c3981e13c6a964c084b3a1b54a051801ab373eda107f74dd869e789242c744df
 SHA512:
-  metadata.gz: 9b2b575fc9be711c375a053537e8ba687d162c4180c1e7075aaa5e3d27d8992655615c10c28ca5894a066213a3d8382c9f6f7c31fdca7118b8dc72707bddf86f
-  data.tar.gz: 38d9ba56709b1b870df9873d70c658e68534fb2eb90fa6c6793a2e87aa80d9fe1f076a6324579f4834a9241554960b35c6501ebc05e3896a781da3166be2c565
+  metadata.gz: 5dcbfd7f46c6e412acc0eccc6ccbe639fdffaf875a8ac56e8af0bbac4ec4654804a149f8eff78316ad0ca06cf2338414de320cf6ba05ca8a8ea11d579167c92e
+  data.tar.gz: 165af797cc3af4b111c9fad1c02f8f1b788d1e900e1d49715e8547b02e8849b768b21ed3cc81d4f922accb073b46f33f7400d7ff854f5868de92869802d3699a

data/README.md

@@ -91,6 +91,8 @@ box.exec("ruby",
   cwd: "/app",
   stdin: "data on stdin",
   tty: true,                 # allocate a PTY
+  on_stdout: ->(chunk) { $stdout.write(chunk) },
+  on_stderr: ->(chunk) { $stderr.write(chunk) },
   throw_on_error: true)      # raise on non-zero exit (default: false)
 
 # Vercel-Sandbox-style alias:
@@ -105,6 +107,10 @@ result.lines        # non-empty stdout lines
 `exec` returns a `Bsdkrun::Result`. It only raises `CommandFailed` when you pass
 `throw_on_error: true` (or call `result.throw_if_failed!`).
 
+The callbacks run as chunks arrive, and the same bytes remain buffered in the
+returned result. They do not require `tty`; a PTY changes command semantics and
+may merge stderr into stdout.
+
 ## Lifecycle & inventory
 
 ```ruby

data/lib/bsdkrun/process.rb

@@ -27,11 +27,30 @@ module Bsdkrun
     # @param stdin [String, nil] data piped to the child's stdin.
     # @param log_level [Integer] bsdkrun global log level (0=off .. 5=trace).
     # @return [RawResult]
-    def run(args, env: {}, stdin: nil, log_level: 0)
+    def run(args, env: {}, stdin: nil, log_level: 0, on_stdout: nil, on_stderr: nil)
       bin = Binary.resolve
       full = ["--log-level", log_level.to_s, *args]
       merged_env = env.to_h.transform_keys(&:to_s).transform_values(&:to_s)
-      out, err, status = Open3.capture3(merged_env, bin, *full, stdin_data: stdin || "")
+      out = +""
+      err = +""
+      status = nil
+      Open3.popen3(merged_env, bin, *full) do |child_in, child_out, child_err, wait|
+        writer = Thread.new { child_in.write(stdin) if stdin; child_in.close }
+        stdout_reader = Thread.new do
+          while (chunk = child_out.readpartial(8192) rescue nil)
+            out << chunk
+            on_stdout&.call(chunk)
+          end
+        end
+        stderr_reader = Thread.new do
+          while (chunk = child_err.readpartial(8192) rescue nil)
+            err << chunk
+            on_stderr&.call(chunk)
+          end
+        end
+        [writer, stdout_reader, stderr_reader].each(&:join)
+        status = wait.value
+      end
       RawResult.new(stdout: out, stderr: err, exit_code: status.exitstatus || 0)
     end
 

data/lib/bsdkrun/sandbox.rb

@@ -69,7 +69,7 @@ module Bsdkrun
       # @return [Sandbox]
       # @raise [SandboxNotFound]
       def get(id)
-        row = list(all: true).find { |m| m.id == id || m.id.start_with?(id) }
+        row = list(all: true).find { |m| m.id == id || m.id.start_with?(id) || m.name == id }
         raise SandboxNotFound, id unless row
 
         new(row.id)
@@ -109,9 +109,11 @@ module Bsdkrun
     # @param cwd [String, nil] working directory (emulated via +sh -c 'cd …'+).
     # @param throw_on_error [Boolean] raise {CommandFailed} on a non-zero exit.
     # @param log_level [Integer] per-command bsdkrun log level.
+    # @param on_stdout [Proc, nil] called with each stdout chunk as it arrives.
+    # @param on_stderr [Proc, nil] called with each stderr chunk as it arrives.
     # @return [Result]
     def exec(command, args: [], env: {}, tty: false, stdin: nil, cwd: nil,
-             throw_on_error: false, log_level: 0)
+             throw_on_error: false, log_level: 0, on_stdout: nil, on_stderr: nil)
       argv = command.is_a?(Array) ? command.dup : [command, *args]
 
       if cwd
@@ -124,7 +126,8 @@ module Bsdkrun
       env.each { |k, v| cli.push("-e", "#{k}=#{v}") }
       cli.push(@id, *argv)
 
-      res = Process.run(cli, stdin: stdin, log_level: log_level)
+      res = Process.run(cli, stdin: stdin, log_level: log_level,
+                        on_stdout: on_stdout, on_stderr: on_stderr)
       result = Result.new(
         stdout: res.stdout, stderr: res.stderr, exit_code: res.exit_code,
         command: "exec #{argv.join(' ')}"

data/lib/bsdkrun/version.rb

@@ -2,5 +2,5 @@
 
 module Bsdkrun
   # The bsdkrun Ruby SDK version.
-  VERSION = "0.3.0"
+  VERSION = "0.3.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bsdkrun
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - Tsiry Sandratraina
@@ -42,7 +42,7 @@ description: |
   BSD/Linux/unikernel microVMs programmatically: create sandboxes, exec commands, manage
   lifecycle, and wire up global networks, volumes and images.
 email:
-- tsiry.sndr@gmail.com
+- tsiry.sndr@rocksky.app
 executables: []
 extensions: []
 extra_rdoc_files: []