Интеграция — граница сборки и продукта, а не второй язык внутри Топаза.
Храните прикладную логику в проверяемых модулях .tpz, выбирайте продукт под
среду поставки и отдельно проверяйте окружающий код платформы.
Выберите границу
| Потребность | Выбор | Что пересекает границу |
|---|---|---|
| Один исполняемый файл для ОС и архитектуры машины сборки | Бэкенд Rust | Управляемый платформенный продукт, собранный через Cargo |
| Продукт для среды с Python 3.11 или новее | Бэкенд Python | Созданный program.py с поставляемой средой выполнения |
| Продукт для браузера или Worker | WASM и Playground | Управляемый браузерный артефакт с объявленным ABI |
| Собственная обёртка на Rust, Python или в сервисе | Интеграция со средой | Созданный продукт и отдельно сопровождаемый код платформы |
| Подтверждение работы Lispex через Топаз | Интеграция LIT | Ограниченная внутренняя и интеграционная проверка |
| Преобразование исходного кода с Lena Code | Интеграция с Lena Code | Отдельно сопровождаемый процесс преобразования |
LIT не является поставляемой целью Топаза. Lena Code не добавляет новый синтаксис Топаза. Они остаются доступными в документации, поскольку запускают или преобразуют код на явной границе.
Что остаётся частью Топаза
Модули, импорты, выражения, типы, шаблоны и основные диагностические сообщения
остаются частью Топаза. Нет import rust, встроенных выражений Rust, Python или
JavaScript, неявного ABI, автоматического преобразования владения или
исключений платформы. Созданный исходный код — артефакт, а не разрешение
помещать его конструкции в файл .tpz.
Проверяйте только общие наблюдаемые результаты
Сначала проверьте и запустите пакет Топаза. Соберите выбранную цель и запустите управляемый продукт с теми же объявленными входными данными. Сравнивайте то, что важно приложению: стандартный вывод, код завершения, поле артефакта или результат работы с файлом, а не внутреннее устройство объектов или форму созданного кода.
Считайте результат свидетельством только для этой программы, входных данных, среды и заявленного наблюдаемого результата. При смене компилятора или цели поставки снова проверяйте созданный продукт и интеграцию со средой.
Ответственность кода платформы
Обёртка над созданным продуктом — внешний код со своей проверкой зависимостей, владения, ошибок, возможностей и безопасности. Импорт модуля Топаза или стандартной библиотеки не даёт доступ к файловой системе, сети, процессам, окружению, часам или базе данных. Если цель не может сохранить поведение, она должна явно отказаться от сборки, а не менять программу молча.
Продолжите с бэкенда Rust, бэкенда Python или интеграции LIT.