wasmtime 0.1.0.alpha.1 → 0.1.0.alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +35 -13
- data/lib/wasmtime/version.rb +1 -1
- metadata +4 -4
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 31e7ebaaa71bf16ca32bfbe4e5bb00c01c89da46871a546b59b317df42d6b945
|
|
4
|
+
data.tar.gz: 3e475f5ea5b96f2b05c7ddc57d201099d3e834f3122b1f1bcef91c68e0a9e779
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 495c7b203e4290403b2562014964ab37bea64d70ed4dba91119e9d37fd8d73b32de20724df1b65f57cddb8bde8a4abaf325443f19df9fca6ce8d10e701a8a86b
|
|
7
|
+
data.tar.gz: e830188f74778df480edb8bd37372ef9f3d5870060625897b2cb693ff954139db8ae594e3f558abc86843d5df4592d27bf85855c7506d56d6dd5f1f883ca90a8
|
data/README.md
CHANGED
|
@@ -17,26 +17,26 @@
|
|
|
17
17
|
|
|
18
18
|
## Introduction
|
|
19
19
|
|
|
20
|
-
This
|
|
20
|
+
This gem allows you to use the [Wasmtime](https://wasmtime.dev/) WebAssembly
|
|
21
21
|
runtime from within your Ruby project.
|
|
22
22
|
|
|
23
23
|
Why would you want that? [WebAssembly](https://webassembly.org/) (or WASM) is a
|
|
24
24
|
technology that allows you to write programs that run at near-native speeds in a
|
|
25
|
-
safe sandboxed environment. Wasmtime is a runtime
|
|
26
|
-
|
|
27
|
-
execute a WASM program from Ruby.
|
|
25
|
+
safe sandboxed environment. Wasmtime is a runtime for WASM programs. This gem
|
|
26
|
+
embedds Wasmtime in a native extension so you can now run WASM from Ruby.
|
|
28
27
|
|
|
29
|
-
This
|
|
30
|
-
|
|
28
|
+
This is pretty experimental and not production ready right now. There are quite
|
|
29
|
+
a few things that aren't built yet, see [TODO](#todo) section below.
|
|
31
30
|
|
|
32
31
|
**Note:** [WebAssembly Interface Types](https://github.com/WebAssembly/interface-types/blob/master/proposals/interface-types/Explainer.md)
|
|
33
32
|
support has been [temporarily removed](https://github.com/bytecodealliance/wasmtime/pull/1292)
|
|
34
|
-
from Wasmtime.
|
|
35
|
-
supported.
|
|
33
|
+
from Wasmtime. Only 32 and 64-bit integers and floats are currently supported.
|
|
36
34
|
|
|
37
35
|
## Usage
|
|
38
36
|
|
|
39
|
-
Install the `wasmtime` gem.
|
|
37
|
+
Install the `wasmtime` gem. Pre-compiled binaries are available for
|
|
38
|
+
`x86_64-linux` and `x86_64-darwin-19`. Compiling the native extension requires
|
|
39
|
+
[Rust with rustup](https://rustup.rs/).
|
|
40
40
|
|
|
41
41
|
```sh
|
|
42
42
|
gem install wasmtime
|
|
@@ -70,7 +70,15 @@ instance = Wasmtime::Instance.new('fibonacci.wasm')
|
|
|
70
70
|
puts instance.funcs[:fib].call(11) #=> 89
|
|
71
71
|
```
|
|
72
72
|
|
|
73
|
-
##
|
|
73
|
+
## Examples
|
|
74
|
+
|
|
75
|
+
More usage examples are provided in `examples/`. To run these, you first need to
|
|
76
|
+
compiling the test WASM modules.
|
|
77
|
+
|
|
78
|
+
Install some Rust tools.
|
|
79
|
+
|
|
80
|
+
- [rustup](https://rustup.rs/) - Rust toolchain manager
|
|
81
|
+
- [wasm-pack](https://rustwasm.github.io/wasm-pack/installer/) - WASM module bundler
|
|
74
82
|
|
|
75
83
|
Install Ruby dependencies.
|
|
76
84
|
|
|
@@ -78,22 +86,36 @@ Install Ruby dependencies.
|
|
|
78
86
|
bundle install
|
|
79
87
|
```
|
|
80
88
|
|
|
89
|
+
Build the WASM modules.
|
|
90
|
+
|
|
91
|
+
```sh
|
|
92
|
+
bundle exec rake wasm
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Run an example.
|
|
96
|
+
|
|
97
|
+
```sh
|
|
98
|
+
ruby examples/fibonacci.rb
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## Development
|
|
102
|
+
|
|
81
103
|
Compile Rust native extension.
|
|
82
104
|
|
|
83
105
|
```sh
|
|
84
|
-
rake compile
|
|
106
|
+
bundle exec rake compile
|
|
85
107
|
```
|
|
86
108
|
|
|
87
109
|
Run test suite.
|
|
88
110
|
|
|
89
111
|
```sh
|
|
90
|
-
rake spec
|
|
112
|
+
bundle exec rake spec
|
|
91
113
|
```
|
|
92
114
|
|
|
93
115
|
Format source code.
|
|
94
116
|
|
|
95
117
|
```sh
|
|
96
|
-
rake format
|
|
118
|
+
bundle exec rake format
|
|
97
119
|
```
|
|
98
120
|
|
|
99
121
|
## TODO
|
data/lib/wasmtime/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: wasmtime
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.1.0.alpha.
|
|
4
|
+
version: 0.1.0.alpha.2
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- David Cristofaro
|
|
@@ -10,7 +10,8 @@ bindir: bin
|
|
|
10
10
|
cert_chain: []
|
|
11
11
|
date: 2020-05-07 00:00:00.000000000 Z
|
|
12
12
|
dependencies: []
|
|
13
|
-
description:
|
|
13
|
+
description: This gem allows you to use the Wasmtime WebAssembly runtime from within
|
|
14
|
+
your Ruby project.
|
|
14
15
|
email:
|
|
15
16
|
- david@dtcristo.com
|
|
16
17
|
executables: []
|
|
@@ -40,7 +41,6 @@ homepage: https://github.com/dtcristo/wasmtime-ruby
|
|
|
40
41
|
licenses:
|
|
41
42
|
- Apache-2.0 WITH LLVM-exception
|
|
42
43
|
metadata:
|
|
43
|
-
homepage_uri: https://github.com/dtcristo/wasmtime-ruby
|
|
44
44
|
source_code_uri: https://github.com/dtcristo/wasmtime-ruby
|
|
45
45
|
post_install_message:
|
|
46
46
|
rdoc_options: []
|
|
@@ -50,7 +50,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
|
50
50
|
requirements:
|
|
51
51
|
- - ">="
|
|
52
52
|
- !ruby/object:Gem::Version
|
|
53
|
-
version:
|
|
53
|
+
version: 2.5.0
|
|
54
54
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
|
55
55
|
requirements:
|
|
56
56
|
- - ">"
|