cxgo

C to Go переводчик

CxGo — это инструмент для перевода исходного кода C в Go (он же транспилятор, компилятор исходного кода).

Он использует cc v3 для предварительной обработки и синтаксического анализа C (без зависимостей clang/gcc!), а также специальную проверку типов и уровень трансляции AST, чтобы обеспечить наилучший результат.

Единственное требование: код C должен компилироваться с помощью cxgo , включая заголовки.

При этом cxgo использует несколько приемов, чтобы упростить этот процесс.

TL;DR для целей проекта:

1. Реализуйте практичный транслятор C в Go (пока без C++).
2. Следите за правильностью выходного программного кода.
3. Сделайте сгенерированный код удобочитаемым и максимально идиоматичным.
4. Сделайте его простым в использовании и настройке.

Ознакомьтесь с часто задаваемыми вопросами, чтобы найти более распространенные вопросы о проекте.

Статус

Проект экспериментальный ! Не полагайтесь на него в производственных и других чувствительных средах!

Хотя он был успешно протестирован на нескольких проектах, он может изменить поведение кода из-за еще неизвестных ошибок.

Результаты тестирования компилятора:

• ОТС: 62/89 (70%)
• ССАГПЗ: 783/1236 (63%)

Транспилированные проекты:

• Potrace (библиотека векторизации изображений)
• G722 (аудиокодек)
• PortableGL (реализация OpenGL 3.x)
• Physac (2D-физический движок)

Установка

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

или загрузите последнюю версию с Github.

Как использовать

Самый быстрый способ попробовать это:

cxgo file main.c

Для получения более подробной информации посетите наш раздел примеров.

Он проведет вас через основные шаблоны использования, а также через более сложные (в реальных проектах).

Вы также можете проверить FAQ, если у вас возникнут какие-либо проблемы.

Предостережения

Следующие функции C в настоящее время принимаются cxgo , но могут быть реализованы частично или не реализованы вообще:

• сохранение комментариев из кода C (#2)
• static (#4)
• auto (#5)
• битовые поля (#6)
• union с C-идентичным расположением данных (#7)
• packed структуры (#8)
• asm
• case в странных местах (#9)
• goto запрещен Go (однако есть обходной путь, см. №10)
• метки переменных (#11)
• локальное хранилище потока (#12)
• setjmp (скомпилируется, но паникует во время выполнения)
• некоторые функции и типы stdlib отсутствуют (хорошая первая проблема!)
• глубокий вывод типов (при преобразовании в строку/фрагменты Go)
• учитывая несколько путей #ifdef для разных ОС/окружений

Сообщество

Присоединяйтесь к нашему сообществу! Мы хотели бы услышать от вас ответ!

Содействие

См. ВКЛАД.

Лицензия

Массачусетский технологический институт