wasmtime 0.3.0-x64-mingw-ucrt → 0.4.0-x64-mingw-ucrt

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7462e60ae2338ea16576fc753d1e16de7635f3acf023bc3f435ffca1c498f7f
-  data.tar.gz: 99df7c74782a0d263b23a14c96c88bc37c0d563f42d50a26dc448f09cbbfc78b
+  metadata.gz: 951a4771403f4117b2d10df53a5814b0e8e25c2d2058f3dce0b61ec4a12178c8
+  data.tar.gz: a811d2d87de203af3ee8028e195d8acca7620ead96805d5ba62e2c82622ebdbb
 SHA512:
-  metadata.gz: 4b19ed52ab402ef99b95e9f60a389429c92921cbbb2d4bbabb2f7049a2a131eeac28fda121ffd3810ae29bc5bb140154880f9be42441d3e2dd7c74b8958f4826
-  data.tar.gz: 2e451eda2b0841ef9fab8330c4265c65e88663a1267dacb76619ced8e50530c866b364bf07999039aec43b3b0608f2ad124347d4c17726235e423008185e1bac
+  metadata.gz: 0f6f8865950ffecbbfa5d6d3d2b0862a182ca8fc1a5c553db68bd9274dc0cb5bda0bc4f078eb903cd151e0151bb5e8e6824475c85fff27b80c6818dd8b855b94
+  data.tar.gz: 0af5cb536829504ca0afe926153da576a393cfee957a8fec45bdfbf663424320aeb00f19f379f982499d010ccbdc9e0e067c7ee2b07574f1ff12d36806eeac72

data/README.md

@@ -15,22 +15,39 @@
   </p>
 </div>
 
-## Status
+## Goal
 
-The Wasmtime Ruby bindings are still under development, [some features](https://github.com/bytecodealliance/wasmtime-rb/issues?q=is%3Aissue+is%3Aopen+label%3A%22missing+feature%22) are still missing.
+`wasmtime-rb`'s goal is to expose the full power of Wasmtime in Ruby with
+minimal overhead, serving as a foundation layer for other projects or gems.
 
 ## Installation
 
-Install from RubyGems
+Add the `wasmtime` gem to your Gemfile and run `bundle install`:
 
-```shell
+```ruby
+gem "wasmtime"
+```
+
+Alternatively, you can install the gem manually:
+
+```sh
 gem install wasmtime
 ```
 
-Or use in your Gemfile:
+### Precompiled gems
 
-```ruby
-gem "wasmtime", "~> 0.3.0"
+We recommend installing the `wasmtime` precompiled gems available for Linux, macOS, and Windows. Installing a precompiled gem avoids the need to compile from source code, which is generally slower and less reliable.
+
+When installing the `wasmtime` gem for the first time using `bundle install`, Bundler will automatically download the precompiled gem for your current platform. However, you will need to inform Bundler of any additional platforms you plan to use.
+
+To do this, lock your Bundle to the required platforms you will need from the list of supported platforms below:
+
+```sh
+bundle lock --add-platform x86_64-linux # Standard Linux (e.g. Heroku, GitHub Actions, etc.)
+bundle lock --add-platform x86_64-linux-musl # MUSL Linux deployments (i.e. Alpine Linux)
+bundle lock --add-platform aarch64-linux # ARM64 Linux deployments (i.e. AWS Graviton2)
+bundle lock --add-platform x86_64-darwin # Intel MacOS (i.e. pre-M1)
+bundle lock --add-platform arm64-darwin # Apple Silicon MacOS  (i.e. M1)
 ```
 
 ## Usage
@@ -41,10 +58,10 @@ Example usage:
 require "wasmtime"
 
 # Create an engine. Generally, you only need a single engine and can
-# re-use it a throughout your program
+# re-use it throughout your program.
 engine = Wasmtime::Engine.new
 
-# Compile a Wasm module from either Wasm or WAT.  The compiled module is
+# Compile a Wasm module from either Wasm or WAT. The compiled module is
 # specific to the Engine's configuration.
 mod = Wasmtime::Module.new(engine, <<~WAT)
   (module
@@ -57,19 +74,20 @@ WAT
 store = Wasmtime::Store.new(engine, {count: 0})
 
 # Define a Wasm function from Ruby code.
-func = Wasmtime::Func.new(store, Wasmtime::FuncType.new([], [])) do |caller|
+func = Wasmtime::Func.new(store, [], []) do |caller|
   puts "Hello from Func!"
-  puts "Ran #{caller[:count]} time(s)"
+  caller.store_data[:count] += 1
+  puts "Ran #{caller.store_data[:count]} time(s)"
 end
 
-# Build the Wasm instance by providing its imports
+# Build the Wasm instance by providing its imports.
 instance = Wasmtime::Instance.new(store, mod, [func])
 
 # Run the `run` export.
 instance.invoke("run")
 
-# Or: get the `run` export and call it
-instance.export("run").call
+# Or: get the `run` export and call it.
+instance.export("run").to_func.call
 ```
 
 For more, see [examples](https://github.com/bytecodealliance/wasmtime-rb/tree/main/examples)

data/ext/build.rs

@@ -0,0 +1,8 @@
+use std::error::Error;
+
+// Propogate linking from rb-sys for usage in the wasmtime-rb Rust crate
+fn main() -> Result<(), Box<dyn Error>> {
+    let _ = rb_sys_env::activate()?;
+
+    Ok(())
+}

data/lib/wasmtime/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Wasmtime
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/wasmtime.rb

@@ -5,18 +5,25 @@ require_relative "wasmtime/version"
 # Tries to require the extension for the given Ruby version first
 begin
   RUBY_VERSION =~ /(\d+\.\d+)/
-  require "wasmtime/#{Regexp.last_match(1)}/ext"
+  require "wasmtime/#{Regexp.last_match(1)}/wasmtime_rb"
 rescue LoadError
-  require "wasmtime/ext"
+  require "wasmtime/wasmtime_rb"
 end
 
 module Wasmtime
   class Error < StandardError; end
 
+  # Raised when failing to convert the return value of a Ruby-backed Func to
+  # Wasm types.
+  class ResultError < Error; end
+
+  # Raised when converting an {Extern} to its concrete type fails.
   class ConversionError < Error; end
 
+  # Raised on Wasm trap.
   class Trap < Error
     STACK_OVERFLOW = :stack_overflow
+    MEMORY_OUT_OF_BOUNDS = :memory_out_of_bounds
     HEAP_MISALIGNED = :heap_misaligned
     TABLE_OUT_OF_BOUNDS = :table_out_of_bounds
     INDIRECT_CALL_TO_NULL = :indirect_call_to_null
@@ -27,6 +34,22 @@ module Wasmtime
     UNREACHABLE_CODE_REACHED = :unreachable_code_reached
     INTERRUPT = :interrupt
     ALWAYS_TRAP_ADAPTER = :always_trap_adapter
+    OUT_OF_FUEL = :out_of_fuel
     UNKNOWN = :unknown
   end
+
+  # Raised when a WASI program terminates early by calling +exit+.
+  class WasiExit < Error
+    # @return [Integer] The system exit code.
+    attr_reader(:code)
+
+    def initialize(code)
+      @code = code
+    end
+
+    # @return [String]
+    def message
+      "WASI exit with code #{code}"
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: wasmtime
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: x64-mingw-ucrt
 authors:
 - The Wasmtime Project Developers
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-11-24 00:00:00.000000000 Z
+date: 2022-12-21 00:00:00.000000000 Z
 dependencies: []
 description: A Ruby binding for Wasmtime, a WebAssembly runtime.
 email:
@@ -19,8 +19,9 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- ext/build.rs
 - lib/wasmtime.rb
-- lib/wasmtime/3.1/ext.so
+- lib/wasmtime/3.1/wasmtime_rb.so
 - lib/wasmtime/version.rb
 homepage: https://github.com/BytecodeAlliance/wasmtime-rb
 licenses:
@@ -31,7 +32,9 @@ metadata:
   cargo_crate_name: ext
   changelog_uri: https://github.com/bytecodealliance/wasmtime-rb/blob/main/CHANGELOG.md
 post_install_message:
-rdoc_options: []
+rdoc_options:
+- "--exclude"
+- vendor
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement