言語ではなく型で約束する
WebAssembly のコンポーネントは、モジュールに型つきの説明を添えたものです。何をインポートし、何をエクスポートするかを、WIT (WebAssembly Interface Type) という言語で書きます。これがあれば、Rust で書いたコンポーネントが、Python で書いたものに文字列やリストを渡せます。
今日は WIT のファイルを読み、それを通してコンポーネントを呼びます。
このレッスンのゴール
メモ
WIT のワールドを読み、コンポーネントが何をインポートしエクスポートするかを言える。
キーワード
| ことば | いみ | れい |
|---|---|---|
| コンポーネント | モジュールに、型つきのインポートとエクスポートを加えたもの | |
| WIT | その型を書く言語 | calc.wit |
| インターフェース | 関数と型に名前をつけてまとめたもの | math |
| ワールド | 1つのコンポーネントのインポートとエクスポートのすべて | |
| パッケージ | インターフェースの集まりの名前とバージョン | demo:[email protected] |
| リフト (lift) | コアの関数を、型つきの関数に変えること |
学生が入力するセルは、このプレビューでは空白です。
コアモジュールは数でしか話せない
ふつうのモジュール、つまりコアモジュールが受け渡せる値は4種類です。i32、i64、f32、f64 です。文字列は、メモリーの位置と長さとして運ぶしかなく、どう運ぶかを両側で決めておく必要があります。
コンポーネントモデルは、その決まりを canonical ABI として一度だけ定めます。WIT に string、list、record と書けば、バイトはランタイムが運びます。2つのコンポーネントがメモリーを共有することはありません。
ラボの WIT ファイルを読む
docker exec tools cat calc.witここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
例: calc.wit の各部分
| 行 | 種類 | 意味 |
|---|---|---|
| package demo:[email protected]; | package | 名前空間 demo、名前 calc、バージョン 0.1.0 |
| interface math { ... } | interface | 関数 add が1つ |
| world calculator { export math; } | world | math を差し出すコンポーネント |
| world doubler { import math; ... } | world | math が要り、double を差し出す |
学生が入力するセルは、このプレビューでは空白です。
コンポーネントはモジュールと型
docker exec tools cat calc.wat で calc.wat を開くと、中にはふつうのコアモジュールがあります。その add は i32 を2つ受け取り、1つ返します。
canon lift の行が、それを WIT の約束どおりの add: func(a: u32, b: u32) -> u32 に変えます。コンポーネントはそれを、インスタンス demo:calc/[email protected] の中に公開します。Wasmtime は --invoke で名前を指定して呼べます。
コンポーネントの add を呼ぶ
docker exec wasm wasmtime run --invoke 'add(2, 3)' calc.watここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
大きすぎる2つの数を足す
docker exec wasm wasmtime run --invoke 'add(4000000000, 500000000)' calc.watここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
ワールドはホストとの契約
ワールドには、コンポーネントが必要とするものと差し出すものを並べます。ホストがインポートをすべて用意しないと、コンポーネントは始まりません。だから、ワールドがそのコンポーネントに触れられるものの全部です。
WASI も WIT のワールドで書かれています。コマンドラインのコンポーネントは、wasi:filesystem や wasi:cli/environment をインポートします。そして wasi:cli/run をエクスポートします。ホストは、動かす前にその一覧を読めます。
よくある間違い
注意
「WIT ファイルは実行されるコードだ」と考える人がいます。WIT は型と関数を書くだけで、契約のようなものです。コードはコンポーネントの中にあり、同じ WIT をどの言語で書いたコンポーネントでも満たせます。
試そう: 45億が205032704になる訳
MASK = 2 ** 32
def add_u32(a, b):
# コアの i32.add は、和の下の32ビットだけを残します。
return (a + b) % MASK
def as_signed(n):
# 同じ32ビットを、符号つきの数として読みます。
if n >= 2 ** 31:
return n - MASK
return n
for pair in [[2, 3], [4000000000, 500000000], [3000000000, 0]]:
total = add_u32(pair[0], pair[1])
print(pair[0], "+", pair[1], "=", total, "(u32)", as_signed(total), "(s32)")
# リストに [4294967295, 1] を足しましょう。いくつに戻るでしょうか。