cxgo

Tradutor C to Go

CxGo é uma ferramenta para traduzir código-fonte C para Go (também conhecido como transpiler, compilador de origem para origem).

Ele usa cc v3 para pré-processamento e análise de C (sem dependências clang/gcc!) E um verificador de tipo personalizado e uma camada de tradução AST para obter o melhor resultado possível.

O único requisito é: o código C deve ser compilado com cxgo , incluindo cabeçalhos.

Dito isto, cxgo usa alguns truques para facilitar esse processo.

TL;DR para os objetivos do projeto:

1. Implemente um tradutor C to Go prático (sem C++ por enquanto).
2. Mantenha o código do programa de saída correto.
3. Torne o código gerado legível e o mais idiomático possível.
4. Torne-o fácil de usar e personalizar.

Verifique o FAQ para perguntas mais comuns sobre o projeto.

Status

O projeto é experimental ! Não confie nele na produção e em outros ambientes sensíveis!

Embora tenha sido testado com sucesso em vários projetos, pode alterar o comportamento do código devido a bugs ainda desconhecidos.

Resultados do teste do compilador:

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

Projetos transpilados:

• Potrace (biblioteca de vetorização de imagens)
• G722 (codec de áudio)
• PortableGL (implementação OpenGL 3.x)
• Physac (mecanismo de física 2D)

Instalação

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

ou baixe a versão mais recente do Github.

Como usar

A maneira mais rápida de experimentar é:

cxgo file main.c

Para mais detalhes, verifique nossa seção de exemplos.

Ele irá guiá-lo através de padrões de uso básicos e também mais avançados (em projetos do mundo real).

Você também pode verificar as Perguntas frequentes se tiver algum problema.

Advertências

Os seguintes recursos C são atualmente aceitos por cxgo , mas podem ser implementados parcialmente ou nem mesmo implementados:

• preservando comentários do código C (#2)
• static (#4)
• auto (#5)
• campos de bits (# 6)
• union com layout de dados C-idêntico (#7)
• estruturas packed (#8)
• asm
• case em lugares estranhos (#9)
• goto proibido por Go (no entanto, há uma solução alternativa, consulte o item 10)
• variáveis ​​​​de rótulo (# 11)
• armazenamento local de thread (#12)
• setjmp (compilará, mas entrará em pânico em tempo de execução)
• algumas funções e tipos stdlib estão faltando (bom primeiro problema!)
• inferência profunda de tipo (ao converter para string/fatias Go)
• considerando vários caminhos #ifdef para diferentes sistemas operacionais/ambientes

Comunidade

Junte-se à nossa comunidade! Gostaríamos de receber uma resposta sua!

Contribuindo

Consulte CONTRIBUINDO.

Licença

MIT