Instalación

Compilá Forja desde el código fuente. Solo necesitás Rust instalado en tu sistema.

💡 Requisito único: rustup.rs — Instalá Rust con rustup-init.exe en Windows, o con el script oficial en Linux/Mac.
  1. Clonar el repositorio — Descargá el código fuente de Forja
  2. Compilar — Usá Cargo para build en modo debug o release
  3. Verificar — Comprobá que el binario funciona
  4. Ejecutar los tests — Corré la suite de ~50 tests
  5. Probar con un ejemplo — Ejecutá tu primer programa

1. Clonar el repositorio

📥 Terminal
git clone https://github.com/lococoi/forja.git
cd forja

2. Compilar

🔨 Modo debug
cargo build
🚀 Modo release (recomendado para benchmarks)
cargo build --release

3. Verificar

✅ Probar el binario
.\target\release\forja.exe --help

Deberías ver la ayuda completa del comando Forja con todas las opciones disponibles.

🔧 Pro tip: Agregá la carpeta del binario a tu PATH para usar forja desde cualquier directorio:
$env:Path += ";C:\Users\tu.usuario\forja\target\release\" (PowerShell)

4. Ejecutar los tests

🧪 Suite de 90+ tests
# Todos los tests
cargo test

# Tests por módulo
cargo test -- lexer
cargo test -- parser
cargo test -- semantics
cargo test -- transpiler
cargo test -- bytecode
cargo test -- vm

5. Probar con un ejemplo

🎯 Primer programa
cargo run --release --bin forja -- run examples/01_hola.fa
// → ¡Hola, mundo desde Forja!

Si ves el mensaje, ¡todo funciona! Ahora estás listo para usar Forja.