Programas que se ponen de acuerdo en tipos
Un componente de WebAssembly es un módulo envuelto con una descripción tipada de lo que importa y exporta. Esa descripción se escribe en WIT, el lenguaje de tipos de interfaz de WebAssembly. Gracias a ella, un componente escrito en Rust puede pasar un texto o una lista a otro escrito en Python.
Hoy lees un archivo WIT y llamas a un componente a través de él.
Al terminar esta lección
Nota
Puedo leer un mundo WIT y decir qué importa y qué exporta un componente.
Palabras clave
| Palabra | Qué significa | Ejemplo |
|---|---|---|
| Componente | un módulo más importaciones y exportaciones tipadas | |
| WIT | el lenguaje que describe esos tipos | calc.wit |
| Interfaz | un grupo con nombre de funciones y tipos | math |
| Mundo | todo lo que un componente importa y exporta | world calculator |
| Paquete | el nombre y la versión de un conjunto de interfaces | demo:[email protected] |
| Elevar | convertir una función del módulo base en una tipada | canon lift |
Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.
Un módulo base solo habla con números
Un módulo normal, un módulo base, pasa cuatro tipos de valor: i32, i64, f32 y f64. Un texto tiene que viajar como una posición en memoria y una longitud, y los dos lados tienen que acordar cómo.
El modelo de componentes fija ese acuerdo una sola vez, en la ABI canónica. WIT dice string, list o record, y el runtime mueve los bytes. Dos componentes nunca comparten memoria.
Lee el archivo WIT del laboratorio
docker exec tools cat calc.witSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Ejemplo: las partes de calc.wit
| Línea | Tipo | Qué dice |
|---|---|---|
| package demo:[email protected]; | paquete | Espacio de nombres demo, nombre calc, versión 0.1.0 |
| interface math { ... } | interfaz | Una función, add: func(a: u32, b: u32) -> u32 |
| world calculator { export math; } | mundo | Un componente que ofrece math |
| world doubler { import math; export double: ... } | mundo | Necesita math y ofrece double |
Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.
Un componente es un módulo más sus tipos
Abre calc.wat con docker exec tools cat calc.wat. Dentro hay un módulo base corriente cuyo add recibe dos i32 y devuelve uno.
Una línea canon lift lo convierte en add: func(a: u32, b: u32) -> u32, el tipo que prometía WIT. El componente lo exporta dentro de la instancia demo:calc/[email protected]. Wasmtime puede llamarlo por su nombre con --invoke.
Llama al add del componente
docker exec wasm wasmtime run --invoke 'add(2, 3)' calc.watSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Suma dos números demasiado grandes
docker exec wasm wasmtime run --invoke 'add(4000000000, 500000000)' calc.watSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Un mundo es un contrato con el anfitrión
Un mundo lista lo que un componente necesita y lo que ofrece. El anfitrión tiene que aportar cada importación antes de que el componente arranque, así que el mundo es todo lo que puede tocar.
WASI también se escribe como mundos WIT. Un componente de terminal importa interfaces como wasi:filesystem y wasi:cli/environment, y exporta wasi:cli/run. Un anfitrión puede leer esa lista antes de ejecutar nada.
Un error frecuente
Advertencia
Mucha gente cree que un archivo WIT es código que se ejecuta. WIT solo describe tipos y funciones, como un contrato. El código está en el componente, y el mismo WIT lo pueden cumplir componentes escritos en cualquier lenguaje.
Pruébalo: por qué 4500 millones dieron 205032704
MASK = 2 ** 32
def add_u32(a, b):
# Un i32.add del módulo base solo guarda los 32 bits bajos de la suma.
return (a + b) % MASK
def as_signed(n):
# Los mismos 32 bits, leídos como un número con signo.
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, "como u32 y", as_signed(total), "como s32")
# Añade [4294967295, 1] a la lista. ¿En qué se queda?