Repository navigation
feat(diagnostics): report skipped meshes and print diagnostics in --report - #243
Conversation
…eport Add a MeshParser overload that counts skipped geometry records, turn that count into the NwcDocument meshes-skipped diagnostic, and merge it with the container trailing-gap diagnostic. Print NwcDocument/NwcAssembly diagnostics in the single-file, folder and .nwf --report paths. Add parser, document and CLI regression tests.
Код-ревью — feat(diagnostics): report skipped meshes and print diagnostics in --report (стек на #232)Вердикт: approve-with-comments Резюме ревьюеров
Подтверждённые замечания (4)1. [СРЕДНЯЯ] Новые тесты счёта пропусков проходят только за счёт эвристического fallback и не проверяют TOC-путь — PR заявляет, что счёт ведут и TOC-путь, и эвристический путь. В обоих новых тестах ( Уточнение проверяющего: Замечание верно по сути, но это пробел в тестовом покрытии, а не дефект поведения. Оба новых теста проходят за счёт эвристического fallback, а счётчики TOC-пути (MeshParser.cs:168, 173) ничем не проверены. Сценарий «TOC нашёл валидный mesh и пропустил другую запись» (fallback не запускается) не покрыт. Не покрыты и CLI-вывод Сценарий: Удалить оба Исправление: Добавить тест в стиле Независимо нашли также: correctness 2. [СРЕДНЯЯ] Parse_OutOfRangeVertexCount_ReportsSkippedRecord не проверяет подсчёт в TOC-пути — В тесте нет ни одного валидного меша, поэтому после TOC-прохода meshes.Count == 0, счётчик обнуляется (MeshParser.cs:46) и итог 1 даёт эвристический скан: на i=8 он видит Уточнение проверяющего: Описание в целом точное. Уточнение: проблема только в тестовом покрытии, ошибки в продуктовом коде нет. Тесты не покрывают счёт пропусков в ParseViaToc (MeshParser.cs:168 и 173), потому что эвристический откат при meshes.Count == 0 даёт тот же результат 1. Часть перечисленных граничных случаев (NaN/Inf, усечённая запись, vCount > 200000) является расширением просьбы, а не дефектом самого теста. Основной пробел — отсутствие кейса «валидный меш + пропущенная запись», где ожидается meshes.Count == 1 и skipped == 1. Сценарий: Удаляем оба Исправление: Добавить кейс: первая запись валидна (как в Parse_LastTocRecordWithOverlongLength...), вторая с p1/p2 вне диапазона, Assert: meshes.Count == 1 и skipped == 1; в Open-тесте проверять число в сообщении и Severity; добавить тест «корректный файл -> Assert.Empty(Diagnostics)». 3. [НИЗКАЯ] Сброс счётчика перед fallback теряет TOC-пропуски; усечённая запись не даёт диагностики — Если TOC-путь не нашёл ни одного меша, skippedRecords обнуляется и заменяется счётчиком эвристического сканера. Эвристика не считает запись, чей заявленный vCount не помещается в поток (ветка Уточнение проверяющего: Утверждение верно: при нуле мешей из TOC счётчик пропусков заменяется счётом эвристики. Эвристика не считает запись, чей vCount в допустимом диапазоне, но не помещается в поток. Поэтому одиночная усечённая запись (например, вход (100, 0, 1224)) даёт 0 мешей без диагностики Сценарий: Берём вход существующего теста Open_MalformedTocRecord_SkipsMesh(100, 0, 1224): chunk = int32[0,94,0,60,100,0,0,0], toc = [1,1,32,1224]. ParseViaToc: rLen = min(1224, 32) = 32, p1 = 100 не влезает в (32-24)/12 = 0, vCount = -1, skippedRecords = 1. Мешей 0, поэтому счётчик обнуляется. Эвристика на i = 8 видит tag = 60, vCount = 100 (в диапазоне), но 8+16+1200 > 32 и делает continue без счёта. Итог: NwcDocument.Open возвращает 0 мешей и в Diagnostics нет meshes-skipped, хотя геометрическая запись отброшена как malformed. Исправление: Не затирать TOC-счёт: либо считать в эвристике и записи, не влезающие в поток, и не сбрасывать счётчик, либо оставить max(TOC-счёт, эвристический счёт) и покрыть тестом случай (100, 0, 1224). 4. [НИЗКАЯ] Сброс skippedRecords при откате на эвристику теряет TOC-счёт: усечённые записи по-прежнему пропадают без диагностики — Если TOC не дал ни одного mesh, счётчик обнуляется и считает только эвристический скан. В эвристике ветка Уточнение проверяющего: Утверждение подтверждается для усечённых записей: при откате на эвристику счёт TOC-пути (в том числе усечённые записи, vCount = -1) отбрасывается, а эвристика усечённые кандидаты (стр. 212-215) не считает. В результате Сценарий: Берём уже существующую тестовую запись Исправление: Не сбрасывать счёт молча: считать пропуски TOC-пути отдельно и брать максимум с эвристическим, либо считать в эвристике и усечённые кандидаты (ветку |
Re-apply meshes-skipped on top of MaxMeshVertices and transform-link parsing: the skipped count no longer drops TOC-path skips or ignores truncated records, the diagnostic names the configured cap, ContainerTrailingGap stays as on main, and the --report diagnostics print does not repeat NWF reference warnings. Add TOC-path, truncation, clean-file and CLI folder/manifest tests.
Completes the CLI and mesh-skip parts of #95. Stacked on #232 (
fix/parse-diagnostics).What changed
MeshParser.Parsenow has an overload that returns the number of skipped geometry records. Both the TOC and heuristic paths count out-of-range/malformed records; the fallback scan resets the counter so the same record is not counted twice.NwcDocument.Openturns that count into themeshes-skippeddiagnostic and merges it withContainerTrailingGapintoNwcDocument.Diagnostics.nwcio --reportprintsDiagnostics: Nplus[Severity] Code: messagefor:NwcIO Execution Report),NwcIO Assembly Report),.nwfassemblies (NwcIO NWF Assembly Report).Parse_OutOfRangeVertexCount_ReportsSkippedRecord;Open_OutOfRangeVertexCount_ReportsMeshesSkippedDiagnostic;Report_PrintsDocumentDiagnostics(appends an unknown tail and checksContainerTrailingGapon stderr).NwcDiagnosticand the diagnostics indocs/public-api.mdandCHANGELOG.md.Files
src/NwcIO/Internal/Parsing/MeshParser.cssrc/NwcIO/NwcDocument.cssrc/NwcIO.Cli/Program.cstests/NwcIO.Tests/MeshParserTests.cstests/NwcIO.Tests/CliArgumentValidationTests.csdocs/public-api.mdCHANGELOG.mdTests
dotnet build NwcIO.slnx -c Release— success, 0 warnings, 0 errors.dotnet test NwcIO.slnx -c Release --no-build— full suite passes (exit 0).--report).Remaining limitations
NwcReaderOptions.Strict(throw on error-level diagnostics) is not implemented.ModelGraphReader) are not included; onlyMeshParser.