Recetas en dos minutos

Qué es una receta, de qué se compone y por qué no hay rutas ni cadenas de texto a su alrededor.

Una receta es un bloque con nombre que agrupa acciones. Puede depender de otras recetas y usar sus resultados. Cada usuario escribe sus propias recetas; no existen “recetas del sistema” integradas. Lo que sí viene integrado es un conjunto de comandos y adaptadores de herramientas (compilación, git, archivos, dat), pero un comando no es una receta por sí mismo.

De qué se compone una receta

• Un nombre. De formato libre. Las demás recetas se refieren a ella por él.
• Dependencias. Qué recetas deben ejecutarse antes.
• Un cuerpo. Lo que hace la receta: toma datos, los transforma y deja el resultado en algún lugar.

Una receta trabaja con objetos, no con cadenas

En Anchor Code, server y client son objetos tipados. No son rutas de archivo ni un bloque de configuración en JSON. El proyecto seleccionado se proporciona automáticamente, por eso una receta nunca escribe project..

// BORRADOR. Muestra la idea, no se ejecuta.
recipe BuildLcoin {
    dependsOn(GenerateShops);

    GenerateShops.output
        .select(server.shops.lcoin.id)
        .replaceIn(client.dat.shopProducts);
}

Cómo leerlo: GenerateShops debe terminar primero. Luego, a partir de su resultado, se toma la tienda vinculada como L-Coin en el proyecto seleccionado y se escribe en la tabla correspondiente del cliente.

Borrador. La palabra clave recipe sin comillas, la forma dependsOn(...), la propiedad output, los métodos select y replaceIn y el nombre shopProducts no están aprobados. Es un esbozo del significado, no un contrato ni código ejecutable.

Qué está garantizado ya

• Visibilidad no es autorización. Una receta que puede leer datos no obtiene por ello el derecho a modificarlos.
• Primero la vista previa, después la acción. Nada cambia en silencio en el servidor, en el cliente, en Git ni en producción.
• Si el destino es ambiguo, el resultado es un error con explicación, no una suposición.

Siguiente: Tu primera receta.