cxgo

Traductor de C a Go

CxGo es una herramienta para traducir código fuente C a Go (también conocido como transpilador, compilador de fuente a fuente).

Utiliza cc v3 para preprocesar y analizar C (¡sin dependencias de clang/gcc!) y un verificador de tipos personalizado y una capa de traducción AST para obtener el mejor resultado posible.

El único requisito es: el código C debe compilarse con cxgo , incluidos los encabezados.

Dicho esto, cxgo utiliza algunos trucos para facilitar este proceso.

TL;DR para los objetivos del proyecto:

1. Implemente un traductor práctico de C to Go (sin C++ por ahora).
2. Mantenga correcto el código del programa de salida.
3. Haga que el código generado sea legible para humanos y lo más idiomático posible.
4. Facilite su uso y personalización.

Consulte las preguntas frecuentes para conocer más preguntas comunes sobre el proyecto.

Estado

¡El proyecto es experimental ! ¡No confíe en él en producción y otros entornos sensibles!

Aunque se probó con éxito en varios proyectos, podría cambiar el comportamiento del código debido a errores aún desconocidos.

Resultados de la prueba del compilador:

• CCT: 62/89 (70%)
• CCG: 783/1236 (63%)

Proyectos transpilados:

• Potrace (biblioteca de vectorización de imágenes)
• G722 (códec de audio)
• PortableGL (implementación de OpenGL 3.x)
• Physac (motor de física 2D)

Instalación

go install github.com/gotranspile/cxgo/cmd/cxgo@latest

o descargue la última versión de Github.

como usar

La forma más rápida de probarlo es:

cxgo file main.c

Para más detalles, consulta nuestra sección de ejemplos.

Lo guiará a través de patrones de uso básicos, así como también otros más avanzados (en proyectos del mundo real).

También puede consultar las preguntas frecuentes si tiene algún problema.

Advertencias

Actualmente, cxgo acepta las siguientes características de C, pero pueden implementarse parcialmente o no implementarse en absoluto:

• preservar comentarios del código C (#2)
• static (#4)
• auto (#5)
• campos de bits (#6)
• union con diseño de datos idéntico a C (#7)
• estructuras packed (#8)
• asm
• case en lugares extraños (#9)
• goto prohibido por Go (aunque hay una solución alternativa, consulte el n.° 10)
• variables de etiqueta (#11)
• almacenamiento local de subprocesos (#12)
• setjmp (se compilará, pero entra en pánico en tiempo de ejecución)
• Faltan algunas funciones y tipos de stdlib (¡buen primer número!)
• inferencia de tipos profunda (al convertir a cadenas/cortes Go)
• considerando múltiples rutas #ifdef para diferentes SO/entornos

Comunidad

¡Únete a nuestra comunidad! ¡Nos gustaría saber de usted!

Contribuyendo

Ver CONTRIBUIR.

Licencia

MIT