Runbox Ruby Client

gem "runbox"

require "runbox"

# Configure (or use environment variables)
Runbox.configure do |config|
  config.url = "http://localhost:8080"
  config.api_key = "your-api-key"
end

# Create a client
client = Runbox::Client.new

# Step 1: Set up a container and get environment info
setup = client.setup(
  identifier: "my-session",
  language: "python"
)

puts setup.container_id  # => "runbox-my-session-python"
puts setup.environment_snapshot.runtime_version  # => "3.11.6"
puts setup.environment_snapshot.packages["requests"]  # => "2.31.0"

# Step 2: Run code in the container
result = client.run(
  container_id: setup.container_id,
  files: [{ path: "main.py", content: "print('Hello!')" }],
  run_command: "python main.py"
)

puts result.stdout  # => "Hello!\n"
puts result.success?  # => true

Runbox.configure do |config|
  config.url = "http://localhost:8080"
  config.api_key = "your-api-key"
  config.timeout = 60  # HTTP timeout
end

client = Runbox::Client.new(
  url: "http://localhost:8080",
  api_key: "your-api-key"
)

setup = client.setup(
  identifier: "session-123",
  language: "python",
  env: { "API_KEY" => "secret" },  # Optional: set environment variables
  memory: "512m",                   # Optional: memory limit
  network_allow: ["api.stripe.com"] # Optional: allowed network destinations
)

# Access environment information
puts setup.container_id  # => "runbox-session-123-python"
puts setup.cached?       # => false (true if container was reused)

env = setup.environment_snapshot
puts env.os_name          # => "debian"
puts env.os_version       # => "12"
puts env.runtime_name     # => "python"
puts env.runtime_version  # => "3.11.6"
puts env.packages         # => {"pip" => "23.0.1", "requests" => "2.31.0", ...}

result = client.run(
  container_id: "runbox-session-123-python",
  files: [{ path: "main.py", content: "print('Hello!')" }],
  run_command: "python main.py",
  env: { "DEBUG" => "true" },  # Optional: runtime environment variables
  timeout: 30                   # Optional: execution timeout in seconds
)

puts result.success?          # => true
puts result.exit_code         # => 0
puts result.stdout            # => "Hello!\n"
puts result.stderr            # => ""
puts result.execution_time_ms # => 42
puts result.timeout?          # => false

# Python example
result = client.run(
  container_id: container_id,
  files: [{ path: "main.py", content: "import requests; print(requests.__version__)" }],
  run_command: "python main.py",
  new_dependencies: ["requests==2.31.0", "pytest"]
)

puts result.packages  # => {"pip"=>"23.0.1", "requests"=>"2.31.0", "pytest"=>"7.4.0", ...}

# Ruby example
result = client.run(
  container_id: container_id,
  files: [{ path: "main.rb", content: "require 'rake'; puts Rake::VERSION" }],
  run_command: "ruby main.rb",
  new_dependencies: ["rake", "rspec"]
)

# Shell example (uses apk)
result = client.run(
  container_id: container_id,
  files: [{ path: "script.sh", content: "#!/bin/sh\ncurl --version" }],
  run_command: "sh script.sh",
  new_dependencies: ["curl", "jq", "git"]
)

deleted = client.delete_containers("session-123")
puts deleted  # => ["runbox-session-123-python"]

health = client.health
puts health[:status]  # => "healthy"
puts health[:version] # => "1.0.0"

begin
  setup = client.setup(identifier: "test", language: "python")
  result = client.run(
    container_id: setup.container_id,
    files: [{ path: "main.py", content: "print('hi')" }],
    run_command: "python main.py"
  )
rescue Runbox::AuthenticationError => e
  puts "Invalid API key"
rescue Runbox::NotFoundError => e
  puts "Container not found (did you call setup first?)"
rescue Runbox::ValidationError => e
  puts "Invalid request: #{e.message}"
rescue Runbox::RunError => e
  puts "Run failed: #{e.message}"
rescue Runbox::ConnectionError => e
  puts "Could not connect to Runbox"
end