Ошибка отложенной работы приводит к сбою всей команды
Принято 8 ноября 2026 г. · 6.0.0 · В работе
Проблема
Основное выполнение может закончиться прежде, чем отложенная работа получит ошибку выполнения или хоста. Код, который проверяет лишь итоговый статус, тоже должен узнать об этой ошибке.
Решение
Ошибка выполнения или хоста в отложенной работе завершает всю команду неудачей. test-ok не выдаётся.
Рассмотренные варианты
Считать итогом успешное завершение основной работы. Успешный статус скрыл бы последующую ошибку.
Причина
Инструмент, проверяющий результат команды, увидит ошибку отложенной работы.
Проверки в тестах вычисляют аргументы один раз и точно сравнивают эталон
Принято 7 ноября 2026 г. · 6.0.0 · Проверяется
Проблема
Вычисление аргумента может иметь побочный эффект, а в эталоне важен даже последний перевод строки. Нужно определить поведение после сбоя проверки и при расхождении файла.
Решение
Аргументы вычисляются один раз слева направо. Используются обычные сравнения и извлечение внешнего конструктора.
Ошибка проверки TPZ4007 останавливает текущий тест во время выполнения.
Существующий эталонный файл UTF-8 сравнивается точно. Файл не создаётся и не обновляется.
Примеры
Equality returns unit and execution continues
run · runtime · Проверка · Не выполнялось
assert-eq.tpzEquality returns unit and execution continuesОткрыть песочницу →
import std.io
import std.test
let result: () = test.assertEq([1, 2], [1, 2])
io.writeLine("{result}")
Ожидаемый выводКод завершения 0
()
$ topaz run assert-eq.tpz --language-version 6.0
Ожидаемый результат
Ожидаемый результат
Выполнение завершается. Код завершения 0.
Нет вывода ошибок.
Ожидаемый стандартный вывод
()
Этот пример ещё не выполнялся.
Match exact line endings and an empty golden file
run · running · Проверка · Не выполнялось
main.tpzMatch exact line endings and an empty golden file
import std.test
import std.io
test.assertGolden("expected.txt", "alpha\r\nβ\n")
test.assertGolden("empty.txt", "")
io.writeLine("golden text matched")
Ожидаемый выводКод завершения 0
golden text matched
$ topaz run main.tpz --language-version 6.0
expected.txtMatch exact line endings and an empty golden file
alpha
β
empty.txtMatch exact line endings and an empty golden file
Ожидаемый результат
Ожидаемый результат
Выполнение завершается. Код завершения 0.
Нет вывода ошибок.
Ожидаемый стандартный вывод
golden text matched
Этот пример ещё не выполнялся.
Fail when the final newline is missing from actual text
run · running · Проверка · Не выполнялось
main.tpzFail when the final newline is missing from actual text
import std.test
import std.io
io.writeLine("before")
test.assertGolden("expected.txt", "line")
io.writeLine("after")
Ожидаемый выводНенулевой код завершения
before
$ topaz run main.tpz --language-version 6.0
expected.txtFail when the final newline is missing from actual text
В диагностике JSON стабильны код и смысл основной позиции
Принято 7 ноября 2026 г. · 6.0.0 · Проверяется
Проблема
Инструмент читает код и позицию, чтобы перейти к ошибочному выражению. Текст сообщения можно улучшать, сохраняя место подсветки.
Решение
Контракт --format json задаёт структурированную идентичность, обязательные поля и типы, единицы координат, серьёзность и причину, указанную основной позицией.
Текст сообщения и метки можно менять. Для изменения идентичности или обещанной позиции нужны версия контракта и инструкция переноса. Удалённые идентификаторы не используются повторно.
Рассмотренные варианты
Исключить смысл позиции из стабильного контракта. Смена подсвечиваемой причины могла бы остаться незаметной.
Сделать стабильными также текст сообщений и порядок дополнительных пояснений. Контракт должен ловить неверные причины и позиции, не мешая улучшать формулировки.
Причина
Инструменты читают поля, пока формулировки диагностики улучшаются.