wasmtime 0.2.0-x86_64-linux → 0.4.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44ec05581887e298d02a58e3d13d262da3e655dc50f5f1b4a5486bdced0a0af1
-  data.tar.gz: d2078f7320a1c76eb9531cf5f2ade8bc3e05d5b116b8c9c232d56e8417faa68e
+  metadata.gz: 9d4bbd6fe60e446c784f194aee2d1aa36473000237a06c1d87e7a06656ef591c
+  data.tar.gz: 472059120cc3f6959caebc4bca061fcd766c61ccfda4fcfbb1aa315818770b38
 SHA512:
-  metadata.gz: 3e91df734e78123c034475d066de2e0d366dd141ebe31f35f7ea5827dcd6aa7eefa392efe1053e257640ef123dcae191f8dd7fd5eb9be2f8466c215be8b2a7d9
-  data.tar.gz: b7ca4635c48d30042f907f8e1ea4a326ce63d3ea9198288425d0bd12e39461ede97e7f3742384b3265e44169acb20d225cadb74932c8bd6ee5da9ad971f0d84d
+  metadata.gz: 5e781487208571c1c5fcb490db087953b597c20194abfa8a7653e7a108c0d1407971db1940ec5162a81ec29b24cb2d7fdd0da1eb48ae8ef55aee5613e7e82172
+  data.tar.gz: d8e07914fc9c09f2532a292406819bced2e356e7cb66893f028dde87536211fd92d9e97d344db24ea2282de4b14ab59076d984ada1faf4e5056018b49f740a2d

data/LICENSE

@@ -1,10 +1,11 @@
+
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
 
-    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 
-    1. Definitions.
+   1. Definitions.
 
       "License" shall mean the terms and conditions for use, reproduction,
       and distribution as defined by Sections 1 through 9 of this document.
@@ -63,14 +64,14 @@
       on behalf of whom a Contribution has been received by Licensor and
       subsequently incorporated within the Work.
 
-    2. Grant of Copyright License. Subject to the terms and conditions of
+   2. Grant of Copyright License. Subject to the terms and conditions of
       this License, each Contributor hereby grants to You a perpetual,
       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
       copyright license to reproduce, prepare Derivative Works of,
       publicly display, publicly perform, sublicense, and distribute the
       Work and such Derivative Works in Source or Object form.
 
-    3. Grant of Patent License. Subject to the terms and conditions of
+   3. Grant of Patent License. Subject to the terms and conditions of
       this License, each Contributor hereby grants to You a perpetual,
       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
       (except as stated in this section) patent license to make, have made,
@@ -86,7 +87,7 @@
       granted to You under this License for that Work shall terminate
       as of the date such litigation is filed.
 
-    4. Redistribution. You may reproduce and distribute copies of the
+   4. Redistribution. You may reproduce and distribute copies of the
       Work or Derivative Works thereof in any medium, with or without
       modifications, and in Source or Object form, provided that You
       meet the following conditions:
@@ -127,7 +128,7 @@
       reproduction, and distribution of the Work otherwise complies with
       the conditions stated in this License.
 
-    5. Submission of Contributions. Unless You explicitly state otherwise,
+   5. Submission of Contributions. Unless You explicitly state otherwise,
       any Contribution intentionally submitted for inclusion in the Work
       by You to the Licensor shall be under the terms and conditions of
       this License, without any additional terms or conditions.
@@ -135,12 +136,12 @@
       the terms of any separate license agreement you may have executed
       with Licensor regarding such Contributions.
 
-    6. Trademarks. This License does not grant permission to use the trade
+   6. Trademarks. This License does not grant permission to use the trade
       names, trademarks, service marks, or product names of the Licensor,
       except as required for reasonable and customary use in describing the
       origin of the Work and reproducing the content of the NOTICE file.
 
-    7. Disclaimer of Warranty. Unless required by applicable law or
+   7. Disclaimer of Warranty. Unless required by applicable law or
       agreed to in writing, Licensor provides the Work (and each
       Contributor provides its Contributions) on an "AS IS" BASIS,
       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
@@ -150,7 +151,7 @@
       appropriateness of using or redistributing the Work and assume any
       risks associated with Your exercise of permissions under this License.
 
-    8. Limitation of Liability. In no event and under no legal theory,
+   8. Limitation of Liability. In no event and under no legal theory,
       whether in tort (including negligence), contract, or otherwise,
       unless required by applicable law (such as deliberate and grossly
       negligent acts) or agreed to in writing, shall any Contributor be
@@ -162,7 +163,7 @@
       other commercial damages or losses), even if such Contributor
       has been advised of the possibility of such damages.
 
-    9. Accepting Warranty or Additional Liability. While redistributing
+   9. Accepting Warranty or Additional Liability. While redistributing
       the Work or Derivative Works thereof, You may choose to offer,
       and charge a fee for, acceptance of support, warranty, indemnity,
       or other liability obligations and/or rights consistent with this
@@ -173,9 +174,9 @@
       incurred by, or claims asserted against, such Contributor by reason
       of your accepting any such warranty or additional liability.
 
-    END OF TERMS AND CONDITIONS
+   END OF TERMS AND CONDITIONS
 
-    APPENDIX: How to apply the Apache License to your work.
+   APPENDIX: How to apply the Apache License to your work.
 
       To apply the Apache License to your work, attach the following
       boilerplate notice, with the fields enclosed by brackets "[]"
@@ -186,19 +187,19 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-    Copyright [yyyy] [name of copyright owner]
+   Copyright [yyyy] [name of copyright owner]
 
-    Licensed under the Apache License, Version 2.0 (the "License");
-    you may not use this file except in compliance with the License.
-    You may obtain a copy of the License at
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
 
        http://www.apache.org/licenses/LICENSE-2.0
 
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
 
 
 --- LLVM Exceptions to the Apache 2.0 License ----
@@ -216,3 +217,4 @@ conflicts with the conditions of the GPLv2, you may retroactively and
 prospectively choose to deem waived or otherwise exclude such Section(s) of
 the License, but only in their entirety and only with respect to the Combined
 Software.
+

data/README.md

@@ -1,147 +1,94 @@
 <div align="center">
-  <h1>wasmtime-ruby</h1>
+  <h1><code>wasmtime-rb</code></h1>
+
   <p>
-    <strong>
-      Ruby bindings for <a href="https://github.com/bytecodealliance/wasmtime">Wasmtime</a>, a WebAssembly runtime
-    </strong>
+    <strong>Ruby embedding of
+    <a href="https://github.com/bytecodealliance/wasmtime">Wasmtime</a></strong>
   </p>
+
+  <strong>A <a href="https://bytecodealliance.org/">Bytecode Alliance</a> project</strong>
+
   <p>
-    <a href="https://rubygems.org/gems/wasmtime">
-      <img src="https://img.shields.io/gem/v/wasmtime" alt="RubyGems version badge" />
-    </a>
-    <a href="https://github.com/dtcristo/wasmtime-ruby/actions?query=workflow%3ACI">
-      <img src="https://img.shields.io/github/workflow/status/dtcristo/wasmtime-ruby/CI" alt="CI status badge" />
+    <a href="https://github.com/bytecodealliance/wasmtime-rb/actions?query=workflow%3ACI">
+      <img src="https://github.com/bytecodealliance/wasmtime-rb/workflows/CI/badge.svg" alt="CI status"/>
     </a>
   </p>
 </div>
 
-## Introduction
+## Goal
 
-This project provides Ruby bindings for [Wasmtime](https://github.com/bytecodealliance/wasmtime),
-a [WebAssembly](https://webassembly.org/) runtime. This allows you to execute
-WASM modules from within Ruby executing at near-native speeds in a safe
-sandboxed environment.
+`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.
 
-This is pretty experimental and not production ready right now. There are quite
-a few things that aren't built yet, see [TODO](#todo) section below.
+## Installation
 
-**Note:** [WebAssembly Interface Types](https://github.com/WebAssembly/interface-types/blob/master/proposals/interface-types/Explainer.md)
-support has been [temporarily removed](https://github.com/bytecodealliance/wasmtime/pull/1292)
-from Wasmtime. Only 32 and 64-bit integers and floats are currently supported.
+Add the `wasmtime` gem to your Gemfile and run `bundle install`:
 
-## Usage
+```ruby
+gem "wasmtime"
+```
 
-Install the `wasmtime` gem. Pre-compiled binaries are available for
-`x86_64-linux` and `x86_64-darwin-19`. Compiling the native extension requires
-[Rust with rustup](https://rustup.rs/).
+Alternatively, you can install the gem manually:
 
 ```sh
 gem install wasmtime
 ```
 
-WASM has two formats `.wasm` (binary) and `.wat` (human-readable text). Both
-formats are supported. With the following `fibonacci.wat` file in your current
-directory.
-
-```wat
-;; fibonacci.wat
-(module
-  (export "fib" (func $fib))
-  (func $fib (param $n i32) (result i32)
-    (if (i32.lt_s (get_local $n) (i32.const 2))
-      (return (i32.const 1))
-    )
-    (return
-      (i32.add
-        (call $fib (i32.sub (get_local $n) (i32.const 2)))
-        (call $fib (i32.sub (get_local $n) (i32.const 1)))
-      )
-    )
-  )
-)
-```
-
-In a ruby file, `require 'wasmtime/require'` to activate the Wasmtime require
-patch, allowing you to require any `.wasm` or `.wat` module as if it were a
-Ruby file. Doing so will internally create a `Wasmtime::Instance` and define a
-Ruby module with functions for each export.
-
-Finally, invoke the `fib` export like so.
-
-```rb
-require 'wasmtime/require'
-require_relative 'fibonacci'
-
-puts Fibonacci.fib(11) #=> 89
-```
-
-If you don't like all the magic in the example above, you can do the same
-without the require patch. If your project is going to be a dependency of others
-use this approach too.
-
-```rb
-require 'wasmtime'
-
-instance = Wasmtime::Instance.new('fibonacci.wat')
-puts instance.exports['fib'].call(11) #=> 89
-```
-
-## Benchmarks
-
-None yet. But they will be impressive.
-
-## Examples
+### Precompiled gems
 
-More usage examples are provided in `examples/`. To run some of these, you first
-need to compile the test WASM modules.
+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.
 
-Install some Rust tools.
+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.
 
-- [rustup](https://rustup.rs/) - Rust toolchain manager
-- [wasm-pack](https://rustwasm.github.io/wasm-pack/installer/) - WASM module bundler
-
-Install Ruby dependencies.
+To do this, lock your Bundle to the required platforms you will need from the list of supported platforms below:
 
 ```sh
-bundle install
+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)
 ```
 
-Build the WASM modules.
+## Usage
 
-```sh
-bundle exec rake wasm
-```
+Example usage:
 
-Run an example.
+```ruby
+require "wasmtime"
 
-```sh
-ruby examples/fibonacci.rb
-```
+# Create an engine. Generally, you only need a single engine and can
+# re-use it throughout your program.
+engine = Wasmtime::Engine.new
 
-## Development
-
-Compile Rust native extension.
+# 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
+    (func $hello (import "" "hello"))
+    (func (export "run") (call $hello))
+  )
+WAT
 
-```sh
-bundle exec rake compile
-```
+# Create a store. Store can keep state to be re-used in Funcs.
+store = Wasmtime::Store.new(engine, {count: 0})
 
-Run test suite.
+# Define a Wasm function from Ruby code.
+func = Wasmtime::Func.new(store, [], []) do |caller|
+  puts "Hello from Func!"
+  caller.store_data[:count] += 1
+  puts "Ran #{caller.store_data[:count]} time(s)"
+end
 
-```sh
-bundle exec rake spec
-```
+# Build the Wasm instance by providing its imports.
+instance = Wasmtime::Instance.new(store, mod, [func])
 
-Format source code.
+# Run the `run` export.
+instance.invoke("run")
 
-```sh
-bundle exec rake format
+# Or: get the `run` export and call it.
+instance.export("run").to_func.call
 ```
 
-## TODO
-
-- Add support for raw memory access and other types of exports
-- Add support for imports
-- Implement more of the Wasmtime API
-- Add benchmarks for WASM program against ones in pure Ruby and true native
-- Add support for WASM Interface Types when they are supported in Wasmtime
+For more, see [examples](https://github.com/bytecodealliance/wasmtime-rb/tree/main/examples)
+or the [API documentation](https://bytecodealliance.github.io/wasmtime-rb/latest/).

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.2.0'
+  VERSION = "0.4.0"
 end

data/lib/wasmtime.rb

@@ -1,7 +1,55 @@
 # frozen_string_literal: true
 
-module Wasmtime; end
+require_relative "wasmtime/version"
 
-require 'wasmtime/version'
-require 'wasmtime/refinements'
-require 'wasmtime/native'
+# Tries to require the extension for the given Ruby version first
+begin
+  RUBY_VERSION =~ /(\d+\.\d+)/
+  require "wasmtime/#{Regexp.last_match(1)}/wasmtime_rb"
+rescue LoadError
+  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
+    BAD_SIGNATURE = :bad_signature
+    INTEGER_OVERFLOW = :integer_overflow
+    INTEGER_DIVISION_BY_ZERO = :integer_division_by_zero
+    BAD_CONVERSION_TO_INTEGER = :bad_conversion_to_integer
+    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,67 +1,60 @@
 --- !ruby/object:Gem::Specification
 name: wasmtime
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: x86_64-linux
 authors:
-- David Cristofaro
-autorequire: 
-bindir: bin
+- The Wasmtime Project Developers
+autorequire:
+bindir: exe
 cert_chain: []
-date: 2020-05-19 00:00:00.000000000 Z
+date: 2022-12-21 00:00:00.000000000 Z
 dependencies: []
-description: 
+description: A Ruby binding for Wasmtime, a WebAssembly runtime.
 email:
-- david@dtcristo.com
+- hello@bytecodealliance.org
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".cargo/config"
-- CHANGELOG.md
-- Cargo.lock
-- Cargo.toml
 - LICENSE
 - README.md
-- ext/wasmtime/Makefile
-- ext/wasmtime/Rakefile
-- ext/wasmtime/extconf.rb
-- lib/tasks/compile.rake
+- ext/build.rs
 - lib/wasmtime.rb
-- lib/wasmtime/native.so
-- lib/wasmtime/refinements.rb
-- lib/wasmtime/require.rb
+- lib/wasmtime/2.7/wasmtime_rb.so
+- lib/wasmtime/3.0/wasmtime_rb.so
+- lib/wasmtime/3.1/wasmtime_rb.so
 - lib/wasmtime/version.rb
-- src/export.rs
-- src/func.rs
-- src/instance.rs
-- src/lib.rs
-- src/memory.rs
-- src/ruby_type.rs
-- src/vm.rs
-homepage: https://github.com/dtcristo/wasmtime-ruby
+homepage: https://github.com/BytecodeAlliance/wasmtime-rb
 licenses:
-- Apache-2.0 WITH LLVM-exception
+- Apache-2.0
 metadata:
-  source_code_uri: https://github.com/dtcristo/wasmtime-ruby
-  changelog_uri: https://github.com/dtcristo/wasmtime-ruby/blob/master/CHANGELOG.md
-post_install_message: 
-rdoc_options: []
+  homepage_uri: https://github.com/BytecodeAlliance/wasmtime-rb
+  source_code_uri: https://github.com/BytecodeAlliance/wasmtime-rb
+  cargo_crate_name: ext
+  changelog_uri: https://github.com/bytecodealliance/wasmtime-rb/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options:
+- "--exclude"
+- vendor
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: '2.7'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.2.dev
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.3.22
+signing_key:
 specification_version: 4
-summary: Ruby bindings for Wasmtime, a WebAssembly runtime
+summary: Wasmtime bindings for Ruby
 test_files: []

data/.cargo/config

@@ -1,4 +0,0 @@
-[target.x86_64-apple-darwin]
-rustflags = [
-  "-C", "link-args=-undefined dynamic_lookup"
-]

data/CHANGELOG.md

@@ -1,27 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [0.2.0] - 2020-05-19
-
-- Exported functions now live on `Wasmtime::Instance#exports` instead of `#funcs`.
-- Exports hash is now keyed by strings instead of symbols.
-- Added support for `Wasmtime::Memory` exports with `#data_size`, `#size` and `#grow` methods.
-
-## [0.1.0] - 2020-05-07
-
-### Added
-
-- Initial release.
-- Support for calling exported functions on a module.
-- Support for 32 and 64-bit integers and floats in arguments and as return values.
-- Require patch for defining a Ruby module with functions for each export.
-
-[unreleased]: https://github.com/dtcristo/wasmtime-ruby/compare/v0.2.0...HEAD
-[0.2.0]: https://github.com/dtcristo/wasmtime-ruby/releases/tag/v0.2.0
-[0.1.0]: https://github.com/dtcristo/wasmtime-ruby/releases/tag/v0.1.0