beni 0.20.0 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5f307db03f9e91e2762e738582b499dd615c38865dfc94c413c2746c9e62b54
-  data.tar.gz: 709bf294599df8f0efcf5d62800af532bc81c1b1837fac49e895aa328b9f915c
+  metadata.gz: 22da977d8a39249cf73b87da65bfde3959f562f0a37beee297451ed103b09fbd
+  data.tar.gz: cda2600ad728abf6711fec340839f6757705ca8ffc922746ff9aaabf0d4fa223
 SHA512:
-  metadata.gz: d84d4a6be69bab3950dcdbb0a64c5009178c9b90ec955f942c3565174743b051c0dde0de7db579e9356c717a6ce39a9e951dbe33bae9a01e9cc6d76697880cb7
-  data.tar.gz: 82b3100cf8746ed778b70e0021bfa04eb039a66d5605ce7233bd040c77aeaba740bf040b75c9b607d67c7e5d514ab10d220de185b5cf28bbb27e8faba9be6438
+  metadata.gz: a506c88524974e5262e285f636b3524b01d6baf325aecd7f784770893b89ac576fe99a1cabcd98043647ce42c35bd3051d2a7375f2b5965c82b03b196d28b937
+  data.tar.gz: dcadaa075e700e749b62e9b7cc633c01651bfcc09b1ca9abe828bd436f16d22a03788e7a09c66d795cb35ca979cc60addf62077e19b71b19b565f3503e826d23

data/CHANGELOG.md

@@ -1,5 +1,71 @@
 # Changelog
 
+## [0.22.0](https://github.com/elct9620/beni/compare/v0.21.0...v0.22.0) (2026-10-08)
+
+
+### ⚠ BREAKING CHANGES
+
+* **beni:** `Mrb::class_new` is `Class::new(mrb, superclass)`; `RClass::new_instance`, `RClass::undef_default_alloc_func`, and `ExceptionClass::as_r_class` move onto the `Class` trait, in the prelude; `Module::name` becomes `Class::name`, so a module handle reads its path instead.
+
+### Features
+
+* **beni-sys:** publish the mruby release the bindings declare ([66c6abc](https://github.com/elct9620/beni/commit/66c6abc997d6c6770ccb7ab8ce320b2610482332))
+* **beni-sys:** read the keyword flag mruby 4.1 keeps in call info ([1c7244b](https://github.com/elct9620/beni/commit/1c7244b1eb93e69832a7afb673e42db4d670a6ee))
+* **beni-sys:** read whether a class's default allocator is undefined ([420bebe](https://github.com/elct9620/beni/commit/420bebe3893336c120c87c5165a2ba6289e0b7b4))
+* **beni:** allocate a class's instance without running initialize ([8f094bc](https://github.com/elct9620/beni/commit/8f094bc2b549b44c3b240f457d175a828234fd51))
+* **beni:** carry class-only operations on a Class trait ([2a3077e](https://github.com/elct9620/beni/commit/2a3077e15801c75562ebffb8dd4599f49c863e95))
+* **beni:** derive release cfgs from the published mruby release ([0333594](https://github.com/elct9620/beni/commit/033359457c6691f81e05b1c69248ae80896a6676))
+* **beni:** read a class's superclass ([104404d](https://github.com/elct9620/beni/commit/104404df0414496822452f5454b627e022e788f7))
+* **vendor:** stage Prism into the mruby source from a prism definition ([e7ccace](https://github.com/elct9620/beni/commit/e7ccace631a836d40d5a3fa2977d6cb57eb3cb42))
+
+
+### Bug Fixes
+
+* **beni:** end a hash walk whose visit changes the pair count ([90c5034](https://github.com/elct9620/beni/commit/90c5034053f41f6002a1e12cf71b98e17331ddf6))
+* **beni:** release a hash walk's visit values when the walk returns ([4742bcf](https://github.com/elct9620/beni/commit/4742bcff1576bbf09eb202a06772d4dbf9e3ced8))
+* **tasks:** rebuild the per-ABI mruby trees when the staged release changes ([cbb505d](https://github.com/elct9620/beni/commit/cbb505d84b361f014536a9afc9f2e79c0d4fcd3a))
+* **tasks:** stage the whole vendor tree before a per-ABI or documentation leg ([c00e1c1](https://github.com/elct9620/beni/commit/c00e1c19f08b6c1e379a65cca7ec15a52229e1c2))
+* **vendor:** name a missing built-in checksum without calling it a pin ([000a3a6](https://github.com/elct9620/beni/commit/000a3a60de2639f623349af11a0cfbb6307ffc3f))
+* **vendor:** tell a platform without a built-in checksum how to supply one ([73941cf](https://github.com/elct9620/beni/commit/73941cffb583661b4849a90f37797b69e8422e93))
+
+## [0.21.0](https://github.com/elct9620/beni/compare/v0.20.0...v0.21.0) (2026-10-07)
+
+
+### ⚠ BREAKING CHANGES
+
+* **beni:** Value::zeroed is removed; return () or
+* **beni:** Mrb::mark_carrier, Mrb::carrier, Mrb::mark_inline_carrier, and Mrb::inline_carrier are removed. A type's class is read through its own TypedData::class or InlineStruct::class; a hand-written implementation holds its class in a Lazy of its own.
+* **beni:** RHash::each is now RHash::foreach; its closure takes the pair as TryConvert types and returns Result<ForEach, Error>, and a closure panic surfaces as Err(Error::Panic) instead of resuming.
+* **beni:** Vec<T>, HashMap<K, V>, BTreeMap<K, V>, RArray::to_vec, RHash::to_hash_map, RHash::to_btree_map, and a scan_args splat Vec<T> require TryConvertOwned element types; read Values or handles through
+
+### Features
+
+* **beni:** convert into heap collections only what holds no Value ([569428f](https://github.com/elct9620/beni/commit/569428ff948f55ba795ce79c49a356c3bb200ebc))
+* **beni:** convert the unit value into nil ([a3e3e5f](https://github.com/elct9620/beni/commit/a3e3e5f45b84dd9c60fbcc41e11196efa3ec9752))
+* **beni:** drop Value::zeroed ([5c2abff](https://github.com/elct9620/beni/commit/5c2abff4c092c95bd70fb88b140f17c9376683bb))
+* **beni:** hand out the undefined value and read it back unsafely ([43757cd](https://github.com/elct9620/beni/commit/43757cd3535a16ce10ce96eb2b835cba3a603b02))
+* **beni:** hold carrier classes in per-interpreter Lazy statics ([a5964e2](https://github.com/elct9620/beni/commit/a5964e2813397fb864e841916396d9349171f954))
+* **beni:** hold each inline struct type's class for one-lookup naming ([ee3afcb](https://github.com/elct9620/beni/commit/ee3afcbc0d72077f5e70217f25d098980b567d40))
+* **beni:** install a payload into a data carrier holding none ([394b072](https://github.com/elct9620/beni/commit/394b07283918548d2aa61f4a47f4873c7aa729f5))
+* **beni:** name an accessor for each core exception class ([150ed72](https://github.com/elct9620/beni/commit/150ed72cd1bdc88e9f7311a6f0b323c7d9cc747c))
+* **beni:** read the name a method's call reached it by ([df1bde3](https://github.com/elct9620/beni/commit/df1bde3e71a043fcd954d059aadc6fb36851b164))
+* **beni:** walk a hash's pairs through magnus's foreach ([34b856f](https://github.com/elct9620/beni/commit/34b856ffb626b851887eb2be533ac48cece72e9a))
+
+
+### Bug Fixes
+
+* **beni-tests:** count each lazy test's drops apart and keep the README diagram out of doctests ([32f7649](https://github.com/elct9620/beni/commit/32f76490c1b35740b9bb87619d154e44924d9810))
+* **beni-tests:** force an uncounted lazy value in the one-global test ([e85cf2d](https://github.com/elct9620/beni/commit/e85cf2d2624dce182c091617917b65e114e924a2))
+* **beni:** name the classes of beni's own exceptions as mruby's raises do ([228e201](https://github.com/elct9620/beni/commit/228e201592651e50ea7e449d7184213d36f9de02))
+
+
+### Performance Improvements
+
+* **beni:** read a fixed-arity call of exactly its arity without a format parse ([754d0af](https://github.com/elct9620/beni/commit/754d0af4c0bb241e081245f7c260a4dc67688bf1))
+* **beni:** read an optional-arity call within its range without a format parse ([118b3fd](https://github.com/elct9620/beni/commit/118b3fd12219fb3cbae02601c6847a563a8645ed))
+* **beni:** read scan_args parts without allocating on the heap ([28517a8](https://github.com/elct9620/beni/commit/28517a81c8ae5f326a1ff50aa174f38cd487d211))
+* **beni:** refuse a wrap's class from its flags instead of a protect frame ([5e343ab](https://github.com/elct9620/beni/commit/5e343abedba3085c34644f6f506901d35dbf9251))
+
 ## [0.20.0](https://github.com/elct9620/beni/compare/v0.19.0...v0.20.0) (2026-10-05)
 
 

data/README.md

@@ -6,6 +6,10 @@ the archive it builds. Extracted from the
 [kobako](https://github.com/elct9620/kobako) project; APIs follow 0.x semver
 semantics and may still evolve between minor versions.
 
+```
+beni gem ──rake beni:build──▶ archive + sidecar ──▶ beni-sys ──▶ beni crate
+```
+
 > [!WARNING]
 > The `beni` crate does not yet cover the full mruby C API. Anything missing
 > stays reachable through the unsafe `beni::sys` escape hatch — issue reports
@@ -38,7 +42,7 @@ Beni::Tasks.new
 rake beni:build
 ```
 
-This downloads the pinned mruby release, builds it with mruby's untouched
+This downloads the default mruby release, builds it with mruby's untouched
 upstream default config, and stages `vendor/mruby/build/host/lib/` with the
 archive and its `libmruby.flags.mak` compile-flags sidecar — everything the
 crates need. The archive's own file name follows the toolchain that built it
@@ -137,15 +141,38 @@ WASI_SDK_PATH=$PWD/vendor/wasi-sdk \
 cargo build --target wasm32-wasip1
 ```
 
+### Prism Source
+
+An mruby release whose compiler gem parses with Prism keeps Prism in a
+git submodule, which the release tarball leaves out. Declare the
+`prism` toolchain with that submodule's commit; the definition alone
+selects it, and `beni:vendor:setup` stages it into the mruby tree:
+
+```ruby
+Beni::Tasks.new do
+  version "<mruby release>"
+
+  toolchain "prism" do
+    version "<ruby/prism commit>"
+    sha256 "…"
+  end
+end
+```
+
+The commit is the one the release records for
+`mrbgems/mruby-compiler/lib/prism`.
+
 ## Toolchain
 
 beni targets plain mruby and is not bound to WebAssembly. `rust-toolchain.toml`
 keeps `wasm32-wasip1` only as a build-verification target for downstream wasi
-consumers (kobako). For that target the Rust channel and the wasi-sdk version
-move in lockstep (the wasm32-wasip1 `crt1-command.o` references
-`__wasi_init_tp` from Rust 1.96 onward; wasi-sdk 33's `libc.a` supplies that
-symbol) — bump the pair together, in both this repo and kobako. Host builds
-are unaffected by the pairing.
+consumers (kobako). For that target two versions move in lockstep, in both this
+repo and kobako; host builds are unaffected.
+
+| Version | Lockstep reason |
+|---|---|
+| Rust channel | `crt1-command.o` references `__wasi_init_tp` from 1.96 on |
+| wasi-sdk 33 | its `libc.a` supplies `__wasi_init_tp` |
 
 ## Development
 

data/lib/beni/dsl/context.rb

@@ -85,12 +85,14 @@ module Beni
         @targets.keys
       end
 
-      # References plus their transitive dependencies; +mruby+ is always
-      # selected and leads the set so it stages first.
+      # References plus their transitive dependencies, and the toolchains
+      # whose definition selects them; +mruby+ is always selected and
+      # leads the set so it stages first.
       def selected_names
         references = @targets.values.flat_map(&:references)
         dependencies = references.flat_map { |name| Vendor::DEPENDENCIES.fetch(name, []) }
-        (%w[mruby] + references + dependencies).uniq
+        defined = @definitions.keys & Vendor::SELECTED_BY_DEFINITION
+        (%w[mruby] + references + dependencies + defined).uniq
       end
 
       def selected_toolchain(name)

data/lib/beni/dsl/target_context.rb

@@ -27,7 +27,7 @@ module Beni
                 "`toolchain #{key.inspect}` inside a target block must not carry a block — " \
                 "definitions live at the top level"
         end
-        DSL.assert_known_toolchain!(key)
+        DSL.assert_referenceable_toolchain!(key)
 
         @references << key unless @references.include?(key)
       end

data/lib/beni/dsl.rb

@@ -17,6 +17,15 @@ module Beni
 
       raise Error, "unknown toolchain #{name.inspect} (known: #{Vendor::TOOLCHAIN_FACTORIES.keys.join(", ")})"
     end
+
+    # A reference may name any known toolchain except one only a
+    # top-level definition selects.
+    def assert_referenceable_toolchain!(name)
+      assert_known_toolchain!(name)
+      return unless Vendor::SELECTED_BY_DEFINITION.include?(name)
+
+      raise Error, "`toolchain #{name.inspect}` is selected by its top-level definition, never by a reference"
+    end
   end
 end
 

data/lib/beni/tasks.rb

@@ -26,7 +26,8 @@ module Beni
   # The block is the declarative DSL from SPEC.md, run on +DSL::Context+:
   # scalar settings (+version+ / +build_config+ / +vendor_dir+), target
   # declarations carrying toolchain references, and top-level toolchain
-  # definitions overriding a built-in pair. Every malformed declaration
+  # definitions overriding a built-in pair — or, for +prism+, selecting
+  # the toolchain with the only pair it has. Every malformed declaration
   # raises here — no task defined, nothing downloaded.
   #
   # Defined tasks:
@@ -118,12 +119,21 @@ module Beni
 
       namespace :setup do
         desc "Download and unpack #{toolchain.name} #{toolchain.version_label} into #{toolchain.final_dir}"
-        task toolchain.task_name => toolchain.tarball_path do
+        task toolchain.task_name => [*enclosing_setup_tasks(toolchain), toolchain.tarball_path] do
           toolchain.install
         end
       end
     end
 
+    # A toolchain staged inside another's tree unpacks only once that
+    # tree is in place: unpacking the enclosing one replaces everything
+    # beneath it.
+    def enclosing_setup_tasks(toolchain)
+      vendor_toolchains
+        .select { |other| toolchain.final_dir.start_with?("#{other.final_dir}/") }
+        .map { |other| other.task_name.to_s }
+    end
+
     def define_build_task
       desc "Build vendored mruby for #{configuration.targets.join(" + ")} " \
            "(stages the archive and its compile-flags sidecar in #{builder.staged_paths.join(", ")})"

data/lib/beni/vendor/tarball.rb

@@ -11,7 +11,7 @@ module Beni
     # not supported and not needed by +Beni::Tasks+.
     #
     # A version mismatch (toolchain bump) forces a clean re-extract, so the
-    # unpacked tree never lags the pinned version. Public contract is the
+    # unpacked tree never lags the selected version. Public contract is the
     # single +#prepare+ entry point; the staging-directory step is internal.
     class Tarball
       # Marker stamped inside +final_dir+ after a successful unpack; a matching

data/lib/beni/vendor/toolchain.rb

@@ -8,14 +8,14 @@ module Beni
     # +#verify+, +#install+) that +Beni::Tasks+ wires into +file+ /
     # +task+ declarations.
     #
-    # Adding a new tarball-based vendor artifact is a single factory
-    # method in +Beni::Vendor+; the rake DSL loop in +Beni::Tasks+
+    # A new tarball-based toolchain is a factory method in +Beni::Vendor+
+    # registered in +TOOLCHAIN_FACTORIES+, with a built-in pair or a place
+    # in +SELECTED_BY_DEFINITION+; the rake DSL loop in +Beni::Tasks+
     # picks it up automatically.
     #
     # Fields:
     #
-    #   * +name+          — display name; also the basename of the unpacked
-    #                       tree under +vendor_dir+ and the base for the
+    #   * +name+          — display name; also the base for the
     #                       +setup:<name>+ task identifier.
     #   * +version_label+ — version string; printed in the download log and
     #                       stamped into +final_dir+ as the idempotency key
@@ -30,12 +30,21 @@ module Beni
     #                       +Tarball#prepare+ under the same name.
     #   * +vendor_dir+    — root of the vendor tree; anchors +final_dir+
     #                       and +tarball_path+.
+    #   * +staged_dir+    — where the unpacked tree lands, relative to
+    #                       +vendor_dir+; defaults to +name+. A toolchain
+    #                       completing another's tree names a path inside
+    #                       it.
     #   * +expected_sha256+ — the toolchain's selected checksum (resolved
     #                       by +Beni::Vendor+ from the built-in pair or a
     #                       consumer override); +nil+ falls to TOFU
     #                       sidecar pinning in +Checksum#verify_or_pin+.
     class Toolchain <
-      Data.define(:name, :version_label, :base_url, :tarball_name, :top_level_dir, :vendor_dir, :expected_sha256)
+      Data.define(:name, :version_label, :base_url, :tarball_name, :top_level_dir, :vendor_dir, :staged_dir,
+                  :expected_sha256)
+      def initialize(name:, staged_dir: name, **fields)
+        super
+      end
+
       # Symbol used to identify the +setup:<task_name>+ rake task. Dashes
       # in +name+ are not valid in rake task identifiers, so we map them
       # to underscores at this single seam.
@@ -52,7 +61,7 @@ module Beni
 
       # Destination under +vendor_dir+ where the unpacked tree is moved.
       def final_dir
-        File.join(vendor_dir, name)
+        File.join(vendor_dir, staged_dir)
       end
 
       # Local cache path for the downloaded tarball. Lives under

data/lib/beni/vendor.rb

@@ -6,7 +6,7 @@ require_relative "vendor/tarball"
 require_relative "vendor/toolchain"
 
 module Beni
-  # Vendor toolchain façade. Owns the release-vendored toolchain pins and
+  # Vendor toolchain façade. Owns each toolchain's built-in pair and
   # the factory methods that build declarative +Toolchain+ values anchored
   # on a caller-supplied +vendor_dir+; +Beni::Tasks+ calls the factories
   # with each selected toolchain's resolved +(version, sha256)+ to wire
@@ -50,6 +50,10 @@ module Beni
     # task-definition time: referencing wasi-sdk implies mruby.
     DEPENDENCIES = { "wasi-sdk" => %w[mruby] }.freeze
 
+    # Toolchains only a top-level definition selects. Each completes the
+    # mruby source rather than serving a target, and has no built-in pair.
+    SELECTED_BY_DEFINITION = %w[prism].freeze
+
     # +RUBY_PLATFORM+ spells the same architecture and operating system
     # differently across hosts; toolchains key their per-platform tarballs
     # by one spelling each.
@@ -83,7 +87,8 @@ module Beni
     # domain the DSL validates against and +Beni::Tasks+ dispatches on.
     TOOLCHAIN_FACTORIES = {
       "mruby" => :mruby,
-      "wasi-sdk" => :wasi_sdk
+      "wasi-sdk" => :wasi_sdk,
+      "prism" => :prism
     }.freeze
 
     module_function
@@ -116,6 +121,23 @@ module Beni
       )
     end
 
+    # The Prism source mruby's compiler gem carries as a git submodule,
+    # which a release's source tarball leaves out. +version+ is a
+    # +ruby/prism+ commit. It stages where the compiler gem reads the
+    # submodule from, so mruby's build does not fetch it.
+    def prism(vendor_dir:, version:, sha256:)
+      Toolchain.new(
+        name: "prism",
+        version_label: version,
+        base_url: "https://github.com/ruby/prism/archive",
+        tarball_name: "#{version}.tar.gz",
+        top_level_dir: "prism-#{version}",
+        vendor_dir: vendor_dir,
+        staged_dir: File.join("mruby", "mrbgems", "mruby-compiler", "lib", "prism"),
+        expected_sha256: sha256
+      )
+    end
+
     # When BENI_VENDOR_BASE_URL is set, all tarballs are fetched from that
     # base URL (test fixture). The base URL must serve files named exactly
     # +tarball_name+ for each toolchain.
@@ -141,8 +163,8 @@ module Beni
 
       checksum.fetch(platform) do
         raise Error, "[beni] #{name} #{version} vendors no tarball for build platform " \
-                     "#{platform}; declare the toolchain with its own version and sha256 " \
-                     "to name one beni does not pin here"
+                     "#{platform}; declare the toolchain with a version and sha256 " \
+                     "for this platform"
       end
     end
 

data/lib/beni/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Beni
-  VERSION = "0.20.0"
+  VERSION = "0.22.0"
 end

data/scripts/cloud_setup.sh

@@ -17,7 +17,7 @@ bundle check >/dev/null 2>&1 || bundle install
 
 # The coverage measure reads its inventory from the vendored mruby headers,
 # and the session's egress serves the git protocol but not source archives —
-# so the source arrives by clone here, at the version the gem pins.
+# so the source arrives by clone here, at the gem's default version.
 if [ ! -d vendor/mruby ]; then
   version="$(ruby -Ilib -rbeni/vendor -e 'print Beni::Vendor::BUILT_IN_PAIRS.fetch("mruby").fetch(:version)')"
   GIT_LFS_SKIP_SMUDGE=1 git -c advice.detachedHead=false clone --quiet --depth 1 \

data/sig/beni/dsl.rbs

@@ -1,5 +1,7 @@
 module Beni
   module DSL
     def self?.assert_known_toolchain!: (String name) -> void
+
+    def self?.assert_referenceable_toolchain!: (String name) -> void
   end
 end

data/sig/beni/tasks.rbs

@@ -25,6 +25,8 @@ module Beni
 
     def define_toolchain_tasks: (Vendor::Toolchain toolchain) -> void
 
+    def enclosing_setup_tasks: (Vendor::Toolchain toolchain) -> Array[String]
+
     def define_build_task: () -> void
 
     def define_clean_task: () -> void

data/sig/beni/vendor/toolchain.rbs

@@ -7,9 +7,10 @@ module Beni
       attr_reader tarball_name: String
       attr_reader top_level_dir: String
       attr_reader vendor_dir: String
+      attr_reader staged_dir: String
       attr_reader expected_sha256: String?
 
-      def initialize: (name: String, version_label: String, base_url: String, tarball_name: String, top_level_dir: String, vendor_dir: String, expected_sha256: String?) -> void
+      def initialize: (name: String, version_label: String, base_url: String, tarball_name: String, top_level_dir: String, vendor_dir: String, ?staged_dir: String, expected_sha256: String?) -> void
 
       def task_name: () -> Symbol
 

data/sig/beni/vendor.rbs

@@ -8,6 +8,7 @@ module Beni
     OS_ALIASES: Hash[Regexp, String]
     BUILD_PLATFORM: String
     TOOLCHAIN_FACTORIES: Hash[String, Symbol]
+    SELECTED_BY_DEFINITION: Array[String]
 
     def self.build_platform: (?String platform) -> String
 
@@ -19,6 +20,8 @@ module Beni
 
     def self?.mruby: (vendor_dir: String, ?version: String?, ?sha256: String?) -> Toolchain
 
+    def self?.prism: (vendor_dir: String, version: String, sha256: String) -> Toolchain
+
     def self?.base_url_for: (String default) -> String
 
     def self?.built_in_sha256: (String name, String version, ?String platform) -> String?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: beni
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.22.0
 platform: ruby
 authors:
 - Aotokitsuruya
@@ -23,8 +23,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-description: Vendors a pinned mruby and builds libmruby.a through a Rake task library,
-  with generated build configs for customization. Aims to grow into a full mruby dependency
+description: Vendors mruby and builds libmruby.a through a Rake task library, with
+  generated build configs for customization. Aims to grow into a full mruby dependency
   manager.
 email:
 - contact@aotoki.me