wasmtime 0.1.0.alpha.2 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31e7ebaaa71bf16ca32bfbe4e5bb00c01c89da46871a546b59b317df42d6b945
-  data.tar.gz: 3e475f5ea5b96f2b05c7ddc57d201099d3e834f3122b1f1bcef91c68e0a9e779
+  metadata.gz: 278e090fef9ae4f35850cc892273ddbe94b2b838b0fc619ca835a17505129957
+  data.tar.gz: fbafd3a60ace1ec5f4806ac94d86e73264feb16e5b4f781c09ad9927c070758e
 SHA512:
-  metadata.gz: 495c7b203e4290403b2562014964ab37bea64d70ed4dba91119e9d37fd8d73b32de20724df1b65f57cddb8bde8a4abaf325443f19df9fca6ce8d10e701a8a86b
-  data.tar.gz: e830188f74778df480edb8bd37372ef9f3d5870060625897b2cb693ff954139db8ae594e3f558abc86843d5df4592d27bf85855c7506d56d6dd5f1f883ca90a8
+  metadata.gz: '016450946bf0d7ee92ffbc44bdc1be90a83602a14a209e3c24e7cc438883845b0b19aa173288169beb5248a080205c8b1d9abe46b373868b72e5caed3e5831bb'
+  data.tar.gz: 8dda113d2501e84a1222dd5ccbc1683cc84490d30628f98f489c681db4e2712d0aa24d65261ae0f223377602d74293472e56166d6aae55d9253bebc78ce1d17d

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# 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.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.1.0...HEAD
+[0.1.0]: https://github.com/dtcristo/wasmtime-ruby/releases/tag/v0.1.0

data/README.md

@@ -42,13 +42,32 @@ Install the `wasmtime` gem. Pre-compiled binaries are available for
 gem install wasmtime
 ```
 
-Given a you have WASM module in your current directory, such as the example
-`fibonacci.wasm` built from [here](https://github.com/dtcristo/wasmtime-ruby/tree/master/wasm/fibonacci).
+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)))
+      )
+    )
+  )
+)
+```
 
-First `require 'wasmtime/require'` to activate the Wasmtime require patch,
-allowing you to require any `*.wasm` 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.
+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.
 
@@ -66,14 +85,18 @@ use this approach too.
 ```rb
 require 'wasmtime'
 
-instance = Wasmtime::Instance.new('fibonacci.wasm')
+instance = Wasmtime::Instance.new('fibonacci.wat')
 puts instance.funcs[:fib].call(11) #=> 89
 ```
 
+## Benchmarks
+
+None yet. But they will be impressive.
+
 ## Examples
 
-More usage examples are provided in `examples/`. To run these, you first need to
-compiling the test WASM modules.
+More usage examples are provided in `examples/`. To run some of these, you first
+need to compile the test WASM modules.
 
 Install some Rust tools.
 

data/lib/wasmtime/require.rb

@@ -13,16 +13,24 @@ module Kernel
   def require(path)
     wasmtime_original_require(path)
   rescue LoadError => load_error
-    path = "#{path}.wasm" unless path.end_with?('.wasm')
+    try_load =
+      Proc.new do |path, extention|
+        path_with_extention =
+          path.end_with?(".#{extention}") ? path : "#{path}.#{extention}"
+
+        if path_with_extention.start_with?('.', '/', '~')
+          absolute_path = File.expand_path(path_with_extention)
+          return Wasmtime.load(absolute_path) if File.file?(absolute_path)
+        end
+        $LOAD_PATH.each do |load_dir|
+          absolute_path = File.expand_path(path_with_extention, load_dir)
+          return Wasmtime.load(absolute_path) if File.file?(absolute_path)
+        end
+      end
+
+    try_load.call(path, 'wasm')
+    try_load.call(path, 'wat')
 
-    if path.start_with?('.', '/', '~')
-      absolute_path = File.expand_path(path)
-      return Wasmtime.load(absolute_path) if File.file?(absolute_path)
-    end
-    $LOAD_PATH.each do |load_dir|
-      absolute_path = File.expand_path(path, load_dir)
-      return Wasmtime.load(absolute_path) if File.file?(absolute_path)
-    end
     raise load_error
   end
 
@@ -43,12 +51,17 @@ module Wasmtime
 
   def load(absolute_path)
     return false if $LOADED_FEATURES.include?(absolute_path)
-    const =
-      absolute_path.split(File::SEPARATOR).last.delete_suffix('.wasm').camelize
-    mod = Object.const_set(const, Module.new)
+    filename = absolute_path.split(File::SEPARATOR).last
+    module_name =
+      if filename.end_with?('.wasm')
+        filename.delete_suffix('.wasm')
+      else
+        filename.delete_suffix('.wat')
+      end
+    mod = Object.const_set(module_name.camelize, Module.new)
     instance = Wasmtime::Instance.new(absolute_path)
     instance.funcs.each do |name, func|
-      mod.define_singleton_method(name) { |args| func.call(args) }
+      mod.define_singleton_method(name) { |*args| func.call(*args) }
     end
     $LOADED_FEATURES << absolute_path
     true

data/lib/wasmtime/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Wasmtime
-  VERSION = '0.1.0.alpha.2'
+  VERSION = '0.1.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wasmtime
 version: !ruby/object:Gem::Version
-  version: 0.1.0.alpha.2
+  version: 0.1.0
 platform: ruby
 authors:
 - David Cristofaro
@@ -20,6 +20,7 @@ extensions:
 extra_rdoc_files: []
 files:
 - ".cargo/config"
+- CHANGELOG.md
 - Cargo.lock
 - Cargo.toml
 - LICENSE
@@ -42,6 +43,7 @@ licenses:
 - Apache-2.0 WITH LLVM-exception
 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: []
 require_paths:
@@ -53,9 +55,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.1.2
 signing_key: