クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

WIT インターフェースとコンポーネント

このレッスンのあとで: WIT のワールドを読み、コンポーネントが何をインポートしエクスポートするかを言える。

65分のレッスンコマンド3件WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

言語ではなく型で約束する

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; }worldmath を差し出すコンポーネント
world doubler { import math; ... }worldmath が要り、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になる訳

コード: python
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] を足しましょう。いくつに戻るでしょうか。

このラボとソースについて: WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。