kobako 0.12.2 → 0.13.0

data/sig/kobako/sandbox.rbs

@@ -10,13 +10,13 @@ module Kobako
     def memory_limit: () -> Integer?
     def stdout_limit: () -> Integer?
     def stderr_limit: () -> Integer?
+    def profile: () -> Symbol
 
+    # Every keyword beyond wasm_path forwards verbatim to
+    # SandboxOptions.new (the four caps + the profile floor).
     def initialize: (
       ?wasm_path: String?,
-      ?stdout_limit: Integer?,
-      ?stderr_limit: Integer?,
-      ?timeout: (Float | Integer)?,
-      ?memory_limit: Integer?
+      **untyped options
     ) -> void
 
     def stdout: () -> String
@@ -42,14 +42,18 @@ module Kobako
 
     private
 
+    def build_runtime!: () -> Kobako::Runtime
+
     def install_dispatch_proc!: () -> void
 
     def begin_invocation!: () -> void
 
     def read_usage!: () -> void
 
+    def read_captures!: () -> void
+
     def trap_class_for: (Kobako::TrapError err) -> singleton(Kobako::TrapError)
 
-    def invoke!: (Symbol verb) { () -> Kobako::Snapshot } -> untyped
+    def invoke!: (Symbol verb) { () -> String } -> untyped
   end
 end

data/sig/kobako/sandbox_options.rbs

@@ -3,26 +3,33 @@ module Kobako
     DEFAULT_TIMEOUT_SECONDS: Float
     DEFAULT_MEMORY_LIMIT: Integer
     DEFAULT_OUTPUT_LIMIT: Integer
+    DEFAULT_PROFILE: Symbol
+    PROFILES: Array[Symbol]
 
     attr_reader timeout: Float?
     attr_reader memory_limit: Integer?
     attr_reader stdout_limit: Integer?
     attr_reader stderr_limit: Integer?
+    attr_reader profile: Symbol
 
     def self.new: (
       ?timeout: (Float | Integer)?,
       ?memory_limit: Integer?,
       ?stdout_limit: Integer?,
-      ?stderr_limit: Integer?
+      ?stderr_limit: Integer?,
+      ?profile: Symbol
     ) -> SandboxOptions
 
     def initialize: (
       ?timeout: (Float | Integer)?,
       ?memory_limit: Integer?,
       ?stdout_limit: Integer?,
-      ?stderr_limit: Integer?
+      ?stderr_limit: Integer?,
+      ?profile: Symbol
     ) -> void
 
+    def enforce_floor!: (Symbol declared) -> void
+
     private
 
     def normalize_timeout: ((Float | Integer)? timeout) -> Float?
@@ -30,5 +37,7 @@ module Kobako
     def normalize_memory_limit: (Integer? memory_limit) -> Integer?
 
     def normalize_output_limit: (Integer? limit, String name) -> Integer?
+
+    def normalize_profile: (untyped profile) -> Symbol
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kobako
 version: !ruby/object:Gem::Version
-  version: 0.12.2
+  version: 0.13.0
 platform: ruby
 authors:
 - Aotokitsuruya
@@ -60,6 +60,7 @@ files:
 - crates/kobako-runtime/src/dispatch.rs
 - crates/kobako-runtime/src/error.rs
 - crates/kobako-runtime/src/lib.rs
+- crates/kobako-runtime/src/profile.rs
 - crates/kobako-runtime/src/runtime.rs
 - crates/kobako-runtime/src/snapshot.rs
 - crates/kobako-runtime/src/yielder.rs
@@ -86,7 +87,6 @@ files:
 - ext/kobako/src/runtime.rs
 - ext/kobako/src/runtime/bridge.rs
 - ext/kobako/src/runtime/errors.rs
-- ext/kobako/src/snapshot.rs
 - lib/kobako.rb
 - lib/kobako/capture.rb
 - lib/kobako/catalog.rb
@@ -110,7 +110,6 @@ files:
 - lib/kobako/runtime.rb
 - lib/kobako/sandbox.rb
 - lib/kobako/sandbox_options.rb
-- lib/kobako/snapshot.rb
 - lib/kobako/snippet.rb
 - lib/kobako/snippet/binary.rb
 - lib/kobako/snippet/source.rb
@@ -149,7 +148,6 @@ files:
 - sig/kobako/runtime.rbs
 - sig/kobako/sandbox.rbs
 - sig/kobako/sandbox_options.rbs
-- sig/kobako/snapshot.rbs
 - sig/kobako/snippet.rbs
 - sig/kobako/snippet/binary.rbs
 - sig/kobako/snippet/source.rbs

data/ext/kobako/src/snapshot.rs

@@ -1,75 +0,0 @@
-//! `Kobako::Snapshot` — the Ruby-facing per-invocation observable bundle.
-//!
-//! The success-path view of the engine-neutral snapshot: the outcome bytes
-//! and the two captured output channels, exposed through five raw readers.
-//! The helper methods that pack them into `Kobako::Capture`
-//! (`Kobako::Snapshot#stdout` / `#stderr`) live in
-//! `lib/kobako/snapshot.rb`. The split keeps the ext side a pure value
-//! carrier and lets Ruby own the convenience surface. Usage is not on the
-//! Snapshot — `Sandbox#usage` reads it from `Kobako::Runtime#usage`, which
-//! survives the trap path where no `Kobako::Snapshot` is produced.
-
-use magnus::{method, prelude::*, Error as MagnusError, RModule, RString, Ruby};
-
-use kobako_runtime::snapshot::Capture;
-
-/// Per-invocation snapshot value. Magnus wraps it so a single ext call
-/// from `Runtime::eval` / `Runtime::run` returns the whole bundle — the
-/// Sandbox layer decomposes it without round-tripping into ext again. The
-/// fields are set once at construction and never mutated; the five public
-/// methods registered in `init` read them out one by one.
-#[magnus::wrap(class = "Kobako::Snapshot", free_immediately, size)]
-pub(crate) struct Snapshot {
-    return_bytes: Vec<u8>,
-    stdout: Capture,
-    stderr: Capture,
-}
-
-impl Snapshot {
-    /// Bundle the success outputs the Runtime collected once the guest
-    /// export returned with an outcome: the drained OUTCOME_BUFFER bytes
-    /// and the capture pipes clipped to their caps.
-    pub(crate) fn new(return_bytes: Vec<u8>, stdout: Capture, stderr: Capture) -> Self {
-        Self {
-            return_bytes,
-            stdout,
-            stderr,
-        }
-    }
-
-    fn return_bytes(&self) -> RString {
-        let ruby = Ruby::get().expect("Ruby thread");
-        ruby.str_from_slice(&self.return_bytes)
-    }
-
-    fn stdout_bytes(&self) -> RString {
-        let ruby = Ruby::get().expect("Ruby thread");
-        ruby.str_from_slice(&self.stdout.bytes)
-    }
-
-    fn stdout_truncated(&self) -> bool {
-        self.stdout.truncated
-    }
-
-    fn stderr_bytes(&self) -> RString {
-        let ruby = Ruby::get().expect("Ruby thread");
-        ruby.str_from_slice(&self.stderr.bytes)
-    }
-
-    fn stderr_truncated(&self) -> bool {
-        self.stderr.truncated
-    }
-}
-
-/// Register `Kobako::Snapshot` plus its five raw readers under the
-/// `Kobako` module. Called from `crate::init` after `Kobako::Runtime`
-/// is registered so the magnus wrap macro can resolve the class name.
-pub(crate) fn init(ruby: &Ruby, kobako: RModule) -> Result<(), MagnusError> {
-    let snapshot = kobako.define_class("Snapshot", ruby.class_object())?;
-    snapshot.define_method("return_bytes", method!(Snapshot::return_bytes, 0))?;
-    snapshot.define_method("stdout_bytes", method!(Snapshot::stdout_bytes, 0))?;
-    snapshot.define_method("stdout_truncated", method!(Snapshot::stdout_truncated, 0))?;
-    snapshot.define_method("stderr_bytes", method!(Snapshot::stderr_bytes, 0))?;
-    snapshot.define_method("stderr_truncated", method!(Snapshot::stderr_truncated, 0))?;
-    Ok(())
-}

data/lib/kobako/snapshot.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "capture"
-
-module Kobako
-  # Kobako::Snapshot — per-invocation observable bundle returned from
-  # +Kobako::Runtime#eval+ and +#run+.
-  #
-  # The magnus class (see ext/kobako/src/snapshot.rs) carries five raw
-  # readers: +return_bytes+, +stdout_bytes+, +stdout_truncated+,
-  # +stderr_bytes+, +stderr_truncated+. This file reopens the class to add
-  # the Ruby-side helpers that pack those raw fields into the user-facing
-  # value object +Kobako::Capture+ — the same shape +Kobako::Sandbox+
-  # exposes to the Host App. Usage is not on the Snapshot; +Sandbox#usage+
-  # reads it from +Kobako::Runtime#usage+, which also covers the trap path
-  # where no Snapshot is produced.
-  class Snapshot
-    # Wrap the stdout capture pair (+stdout_bytes+, +stdout_truncated+)
-    # as a +Kobako::Capture+ value object. The byte content never carries
-    # a truncation sentinel; +#truncated?+ is the only way to observe
-    # that the cap was hit.
-    def stdout
-      Capture.new(bytes: stdout_bytes, truncated: stdout_truncated)
-    end
-
-    # Wrap the stderr capture pair as a +Kobako::Capture+ value object.
-    # Mirror of +#stdout+.
-    def stderr
-      Capture.new(bytes: stderr_bytes, truncated: stderr_truncated)
-    end
-  end
-end

data/sig/kobako/snapshot.rbs

@@ -1,12 +0,0 @@
-module Kobako
-  class Snapshot
-    def return_bytes: () -> String
-    def stdout_bytes: () -> String
-    def stdout_truncated: () -> bool
-    def stderr_bytes: () -> String
-    def stderr_truncated: () -> bool
-
-    def stdout: () -> Kobako::Capture
-    def stderr: () -> Kobako::Capture
-  end
-end