Compilador Nativo AOT x86-64 Direct Machine Code Licencia MIT

HarbourRust

Harbour 4 Flash Edition — Análisis Técnico del Proyecto

A diferencia de lo que suele malinterpretarse, no es un transpilador de Harbour a Rust ni utiliza una máquina virtual. Es un compilador nativo Ahead-Of-Time (AOT) escrito en Rust que toma código fuente .prg y emite código máquina x86-64 puro directamente, empaquetándolo mediante su propio escritor binario interno.

Windows: PE32+
Linux: ELF
macOS Intel: Mach-O
1

Arquitectura y Eliminación de Dependencias

Cero C, Cero MinGW y Cero Linker

El compilador (hbc.exe) prescinde de ensambladores o enlazadores externos (as/ld) y librerías de MinGW para binarios de consola. Genera el PE32+ con punto de entrada _start en 0x140000000 importando solo entre 8 y 11 funciones de kernel32.dll (ExitProcess, HeapAlloc, HeapFree, WriteFile, VirtualAlloc, etc.), sin CRT, SEH ni relocalizaciones.

Sin HVM, Pcode ni Garbage Collector

No interpreta pcode ni arrastra el runtime clásico de Harbour. La memoria se gestiona en tiempo de compilación mediante ownership determinista (eliminando pausas de GC) y conteo de referencias acotado para rutas persistentes. Por diseño, tampoco admite archivos .hrb.

Compilador Autocontenido

El código fuente del compilador (src/hbc.rs) depende exclusivamente de la librería estándar de Rust (sin crates externos de Cargo) y se distribuye precompilado en el repositorio como bin/hbc.exe bajo licencia MIT.

2

Rendimiento y Tamaño de Binarios (Microbenchmarks)

Al prescindir de la HVM, el recolector de basura y la RTL monolítica de Harbour, la huella en disco y los tiempos de ejecución se reducen drásticamente:
Métrica HarbourRust (AOT) Harbour (pcode) Harbour (-gc3)
Tamaño ejecutable (b3_call, Linux ELF) 9 KB (9,032 B) 1.43 MB (1,431,608 B) 1.43 MB (1,431,560 B)
Tiempo ejecución (b3_call) 33 ms 1,591 ms 972 ms
Tiempo ejecución (b2_str) 520 ms 865 ms 745 ms
⚡
Clases y Objetos: En pruebas de 2 millones de llamadas a métodos, accesos a DATA y ciclos de instanciación, se midieron aceleraciones de entre 14x y 34x frente a Harbour tradicional.
3

Estado Real de Compatibilidad y Límites Técnicos

Desarrollo activo: Los releases binarios antiguos (v0.1–v0.8) fueron retirados el 14 de noviembre, manteniendo un snapshot reciente en bin/hbc.exe con métricas transparentes sobre sus capacidades actuales.
Cobertura del Lenguaje Strict Fail-Fast
De los 268 tests oficiales bajo tests/ en Harbour (1,041 en el inventario total), compilan 32. En su batería de regresión de Windows 11 x64 pasaron 1,706 de 1,729 casos (23 omitidos por ser exclusivos de Linux). Rechaza explícitamente en compilación todo lo no soportado, evitando fallos silenciosos.
POO (CREATE CLASS) Solo Linux
Implementada con herencia simple, tablas planas de métodos virtuales y acceso a DATA escalar por offset fijo. Límite clave: por ahora solo funciona en Linux (--target=windows lo rechaza) y no soporta miembros de tipo array u objeto ni herencia múltiple.
Hilos y Mutex Solo Linux
Implementados directamente sobre clone(2) + futex en Linux (también rechazados actualmente en Windows).
Bases de Datos (DBF / NTX / CDX) Solo Lectura Nativa
Implementación nativa acotada de solo lectura (dBASE III, campos C/N/L/D, sin memos, sin bloqueo compartido y con índices de un solo tag/clave carácter directa). Para escritura real, memos o múltiples áreas, incluye el modo opcional --harbour-rdd en Windows que enlaza la VM y RDDs de Harbour 3.2 (requiere MinGW y licencia el binario resultante bajo GPL con excepción de Harbour).
Puente C Extend API Subconjunto Acotado
Incluye un bridge (hb_par* / hb_ret* / hb_eval*) para invocar funciones en C pasando escalares, arrays de solo lectura, referencias y codeblocks, pero carece de soporte para fechas, hashes o mutación de arrays desde C.

En Resumen para Uso Práctico

Es una pieza de ingeniería de compiladores notable: demuestra que es viable compilar un subconjunto estricto de xBase directamente a código máquina x86-64 sin VM ni CRT, produciendo ejecutables de apenas unos pocos kilobytes.

Sin embargo, hoy es una herramienta experimental orientada a módulos aislados, utilidades CLI o pruebas de concepto, y no reemplaza a Harbour 3.2/3.4 para aplicaciones de escritorio Win32/GUI (como FiveWin o HMG), dado que aún carece de clases en Windows, escritura DBF nativa, soporte de STATIC a nivel de archivo y compatibilidad ABI completa con librerías C existentes.