Интеграция

Интеграция с Lena Code

Найдите поддерживаемое преобразование, проверьте полученный код Топаза и сравните поведение с оригиналом.

Используйте Lena Code для преобразования кода в Топаз или из него, если нужная пара языков есть в списке поддержки. Сначала проверьте список, затем сравните поведение полученной программы с оригиналом.

Lena Code распространяется отдельно и преобразует исходный код. Установите Топаз для проверки и запуска полученных файлов .tpz. Для нативной сборки также нужны инструменты сборки Rust.

Выберите поддерживаемое преобразование

На сайте Lena Code найдите исходный язык, целевой язык и форму программы в текущем списке поддержки. Учитывайте направление преобразования. Запишите версию Lena Code, сохраните исходник и ожидаемые результаты. Для входа вне списка выберите другой способ преобразования.

Проверьте полученный код Топаза

Сохраните преобразованный код как converted.tpz. Перед запуском просмотрите содержимое и изменения. Выполните следующие команды по порядку из папки с этим файлом. При ошибке остановитесь.

BASH
topaz parse converted.tpz
topaz check converted.tpz
topaz run converted.tpz
topaz build converted.tpz --out-dir converted-build --run
КомандаЧто проверить
parseКод завершения 0 означает успешный синтаксический анализ
checkКод завершения 0 означает успешную проверку имён и типов
runСравните вывод и код завершения программы с оригиналом
build --runПроверьте результат сборки в converted-build и поведение собранной программы

Если анализ или проверка завершается ошибкой, исправьте указанное место в converted.tpz согласно текущему синтаксису. Если выполнение даёт другой результат, подайте обеим программам одинаковые данные и изучите изменённую логику.

Сравните важные для приложения результаты, ошибки, изменения данных, вызовы API и обработку сбоев. Успешная проверка исходника не проверяет эти результаты. Изучите файловые и сетевые операции, прежде чем разрешить доступ к реальным данным.

Преобразуйте Топаз в другой язык

Lena Code задаёт правила переноса конструкций Топаза в целевой язык и среду выполнения. Проверьте полученные API, представление данных, внешние действия и обработку ошибок. Выполните тесты средствами целевого языка и сравните результаты с сохранёнными.

Подключите результат

Продукты обмениваются исходными файлами. Отдельно настройте пакеты, среду выполнения и файлы развёртывания целевого языка. При соединении скомпилированных компонентов проверьте ABI, правила передачи аргументов и результатов.

Помечайте примеры на других языках названием языка. Файлы .tpz используют синтаксис Топаза, а topaz check отклоняет неподдерживаемые формы.

Связанная документация