Repository navigation
refactor(cli): merge folder and NWF assembly pipelines - #246
Conversation
Use one ProcessAssembly(NwcAssembly, ...) implementation for both inputs. The folder path only loads NwcAssembly.LoadFromDirectory; the .nwf path only loads NwcAssembly.OpenNwf and computes its default output. Report headers, labels, default output paths and exports stay unchanged; add a regression test that runs both inputs with --report --bvh-stats.
Record that folder and .nwf inputs now use the same ProcessAssembly implementation.
Код-ревью — refactor(cli): merge folder and NWF assembly pipelines (стек на #234)Вердикт: approve-with-comments Резюме ревьюеров
Подтверждённые замечания (4)1. [НИЗКАЯ] Тест не проверяет заявленную неизменность путей вывода по умолчанию — В PR и в CHANGELOG заявлено, что пути вывода по умолчанию не изменились ( /_assembly.glb для папки и .glb для .nwf). Эта логика осталась в обёртках ProcessAssemblyDirectory (Program.cs:1040-1043) и ProcessNwfAssembly (Program.cs:1411-1414) и дальше передаётся в общий метод как outputPath!. Новый тест в обоих запусках передаёт явный второй аргумент (folder.json и nwf.json), поэтому ветка с путём по умолчанию не выполняется. Других тестов на неё тоже нет: git grep по tests/ на _assembly и ChangeExtension ничего не находит. Вторая слабость: для .nwf проверяется только подстрока Loaded Models:, а не число компонентных файлов, так что вспомогательный WriteNwfWithXRefs мог бы не разрешить ссылку на a.nwc и тест всё равно прошёл бы.Уточнение проверяющего: Тест FolderAndNwf_UseTheSameReportPipeline не покрывает пути вывода по умолчанию (оба запуска передают явный выходной файл) и для .nwf проверяет только наличие подстроки Сценарий: Если в ProcessNwfAssembly заменить Path.ChangeExtension(nwfPath, ".glb") на другое выражение или в ProcessAssemblyDirectory испортить имя _assembly.glb, все тесты останутся зелёными: запуск Исправление: Добавить в тест запуски без выходного аргумента для папки и .nwf и проверить существование _assembly.glb и fed.glb. Для .nwf проверить строку 2. [НИЗКАЯ] Заявленная метка итоговой строки (Assembly и NWF Assembly) не закреплена ни одним тестом — PR утверждает, что итоговая строка сохраняет различие Уточнение проверяющего: Для входа-папки без --report метка "Assembly" проверяется нестрого: Assert.Contains("Assembly '") проходит и на "NWF Assembly '". Для .nwf метка закреплена тестом CliStdoutJsonTests.cs:240. Пробел касается только папки, а не обеих меток. Сценарий: Исправление: Добавить в новый тест прогон без 3. [НИЗКАЯ] Тест проверяет только подписи на пустой модели, а не поведение слитого конвейера — Фикстура строится из NwcDocument.Create() без мешей и материалов, а все ассерты — Assert.Contains на текст подписи. Значения (Total Materials, BVH Nodes, число загруженных моделей) не проверяются. Тест не доказывает, что компонент .nwf реально разрешился. Против базы #234 тест проходит без изменений, так как подписи и блоки BVH/Total Materials там уже были в теле NWF-метода. Уточнение проверяющего: Тест является дымовым: он проверяет только наличие подписей отчёта на пустой модели. Он не ловит регрессии значений (Models.Count - 1, NodeCount, число материалов), не подтверждает, что xref в .nwf разрешился, и не доказывает слияние конвейеров, потому что проходит и против базы #234. Папочный и NWF-сценарии объединены в один [Fact]. Вывод о том, что BVH-статистика не исполняется при пустой модели, верен, но следствие у него умеренное. Сценарий: Пустой документ даёт AllMeshes.Count == 0, и NwcSpatialIndex (конструктор строит дерево только при _entries.Length > 0) печатает «BVH Nodes: 0 (0 leaves, max depth 0)», то есть статистика BVH не исполняется. Если в слитом методе подменить значения (например, напечатать LeafCount вместо NodeCount) или потерять Исправление: Взять модель хотя бы с одной мешью и материалом и проверять значения: «Loaded Models: 2 (component files: 1)», «Total Materials: 1», «BVH Nodes: 1 (1 leaves, …)», строку «Models: 1» для папки; убедиться, что в NWF-отчёте нет «Warning: unresolved reference». Разнести папку и NWF по двум тестам. 4. [НИЗКАЯ] Заявленные инварианты (путь вывода по умолчанию, строка-итог, xref-предупреждения) не покрыты тестами — PR заявляет «Default output paths are unchanged» и сохранение строки-итога «Assembly»/«NWF Assembly», но тестов на это нет. Ветка isNwf ? "NWF Assembly" : "Assembly" в строке-итоге для папки не отличима существующим тестом: подстрока «Assembly '» входит и в «NWF Assembly '». Новый тест гоняет только --report, где строка-итог не печатается. Путь по умолчанию ( Уточнение проверяющего: Рефакторинг объединил пайплайны папки и .nwf без новых регрессионных тестов на сохраняемые инварианты: пути вывода по умолчанию, различие "Assembly" и "NWF Assembly" в строке-итоге (существующий ассерт "Assembly '" не отличает их), предупреждения об xref и число материалов в итоге для .nwf. Это старый пробел покрытия, а не регрессия PR (предупреждения об xref в тестах CLI не покрыты и в базе #234). Серьёзность низкая. Сценарий: Если вызов из ProcessAssemblyDirectory потеряет Исправление: Добавить тесты: запуск папки и .nwf без выходного пути (проверить создание |
Fixes #102. Stacked on #234 (
fix/nwf-pipeline-report).What changed
ProcessAssembly(NwcAssembly, …)method that owns the assembly export, clash, TimeLiner, profiler, raycast and report steps.ProcessAssemblyDirectorynow only computes the folder default output, loadsNwcAssembly.LoadFromDirectory, and callsProcessAssembly(..., isNwf: false).ProcessNwfAssemblynow only computes the.nwfdefault output and callsProcessAssembly(..., isNwf: true); the shared method loadsNwcAssembly.OpenNwfwhen no assembly is preloaded.NwcIO Assembly ReportwithAssembly:/Models:for folders,NwcIO NWF Assembly ReportwithNWF File:/Loaded Models:for.nwf. The summary line keepsAssemblyvsNWF Assembly.<dir>/<dirname>_assembly.glband<nwf>.glb).AssemblyPipelineTests.FolderAndNwf_UseTheSameReportPipeline, which runs both inputs with--report --bvh-statsand checks the respective headings,Total Materials:andBVH Nodes:.Files
src/NwcIO.Cli/Program.cstests/NwcIO.Tests/AssemblyPipelineTests.csCHANGELOG.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).AssemblyPipelineTests: 1 passed.Remaining limitations