Deux pièces, un programme, tous les langages
Composer des composants WebAssembly, c’est brancher l’export d’un composant sur l’import d’un autre, pour n’en faire qu’un seul. Les pièces peuvent être écrites dans des langages différents, car elles ne se rencontrent que par une interface WIT.
Aujourd’hui, vous voyez un import échouer, puis vous composez deux composants et lancez le résultat.
À la fin de cette leçon
Remarque
Je peux expliquer comment deux composants se composent en reliant un import à un export.
Mots-clés
| Mot | Ce que ça veut dire | Exemple |
|---|---|---|
| Composition | assembler des composants pour que l’un fournisse l’import d’un autre | |
| Instancier | créer une copie en marche d’un composant | |
| Éditeur de liens | la partie du runtime qui fournit les imports | linker |
| Satisfaire | fournir un import avec un export qui correspond | |
| Bindings | du code généré à partir de WIT pour un langage |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Un import que personne ne fournit bloque tout
doubler.wat est dans le monde doubler. Il importe demo:calc/[email protected] et se sert de son add pour doubler un nombre.
Lancé seul, il est refusé par Wasmtime avant que le moindre code tourne. L’éditeur de liens a cherché cette interface, n’a rien trouvé et a nommé l’import manquant. Un hôte vérifie chaque import d’abord : voilà pourquoi un composant n’atteint rien qu’on ne lui ait donné.
Lancer doubler sans rien à brancher
docker exec wasm wasmtime run --invoke 'double(21)' doubler.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
La composition branche un export sur un import
app.wat contient les deux composants. Il crée d’abord calc, puis crée doubler en branchant le demo:calc/[email protected] de calc sur l’import du même nom. Il exporte double.
Le résultat n’importe plus rien, donc Wasmtime peut le lancer seul. Des outils comme wac font le même travail avec deux fichiers .wasm et écrivent un nouveau composant.
Lire les lignes qui les composent
docker exec tools tail -4 app.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Lancer le composant composé
docker exec wasm wasmtime run --invoke 'double(21)' app.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Exemple travaillé : besoins et fournitures
| Composant | Imports | Exports | Tourne seul ? |
|---|---|---|---|
| calc.wat | rien | demo:calc/[email protected] | Oui |
| doubler.wat | demo:calc/[email protected] | double | Non, l’import manque |
| app.wat | rien | double | Oui, il a affiché 42 |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Comment les autres langages font des composants
Un vrai projet écrit chaque pièce dans son langage. wit-bindgen transforme un fichier WIT en bindings pour Rust, C et d’autres, et cargo-component construit un composant à partir de Rust. componentize-py fait de même pour Python, et jco pour JavaScript.
Aucune de ces chaînes d’outils n’est dans le labo, qui ne télécharge rien. Les composants y sont donc écrits à la main, et les octets produits sont de la même sorte.
Erreur fréquente
Attention
On croit souvent que composer revient à fusionner le code source et à le recompiler. On assemble des composants déjà construits. Chacun garde sa mémoire, et les valeurs ne passent que par l’interface : une pièce Python ne peut pas fouiller dans les données d’une pièce Rust.
À vous : relier les imports par nom
# Ce que fournit chaque composant, par nom d’interface.
exports = {
"demo:calc/[email protected]": "calc",
}
# Ce dont doubler a besoin avant de pouvoir démarrer.
besoins = ["demo:calc/[email protected]", "wasi:cli/[email protected]"]
for nom in besoins:
if nom in exports:
print("brancher", nom, "depuis", exports[nom])
else:
print("manquant", nom, ": personne ne le fournit")
# Ajoutez "wasi:cli/[email protected]": "hote" aux exports et relancez.