cxgo

Tradutor C to Go

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

Ele usa cc v3 para pré-processamento e análise de C (sem dependências de 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, bem como de padrões 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