¿Qué hace grimoire?
Instala y opera Grimoire, crea archivos .spell con cobertura completa de sintaxis (incluyendo lógica de decisión asesora), y ejecuta compile/validate/simulate/cast de forma segura. Úsalo cuando los usuarios pidan crear, editar, depurar, validar, simular, ejecutar o explicar estrategias de Grimoire.
Instalación
- Asegúrate de tener Python 3.7+ instalado.
- Instala Grimoire usando pip:
pip install grimoire-tool
Uso básico
Crear un archivo .spell
grimoire create mi-hechizo.spell
Compilar un hechizo
grimoire compile mi-hechizo.spell
Validar un hechizo
grimoire validate mi-hechizo.spell
Simular un hechizo
grimoire simulate mi-hechizo.spell
Ejecutar (cast) un hechizo
grimoire cast mi-hechizo.spell
Sintaxis de archivos .spell
Un archivo .spell contiene una secuencia de comandos con la siguiente estructura:
# Ejemplo de un archivo .spell completa
nombre: Mi Hechizo
version: 1.0
autor: Usuario
descripcion: Un hechizo de ejemplo
comandos:
- paso: 1
comando: "echo Hola Mundo"
descripcion: Saludo inicial
- paso: 2
comando: "ls -la"
descripcion: Listar archivos
asesor: verificacion
Lógica de decisión asesora
Puedes incluir condicionales dinámicos:
comandos:
- paso: 3
comando: "python script.py"
descripcion: Ejecutar script
decision:
si_exitoso: paso_4
si_fallo: paso_5
Consejos de uso
- Siempre valida los archivos .spell antes de ejecutarlos para evitar errores.
- Usa la simulación para revisar el flujo de comandos sin efectos secundarios.
- La lógica asesora permite bifurcaciones inteligentes basadas en resultados.
Solución de problemas
Si encuentras errores de sintaxis, revisa la indentación y el formato YAML. Para problemas de instalación, verifica que pip esté actualizado:
pip install --upgrade pip