ПОЧАТОК РОБОТИ

Від звіту до рядків, які ніхто не тестує

Шість кроків, однакові в обох редакторах. Coverage Studio не запускає власних тестів: він читає звіт, який ваші інструменти вже пишуть, і кладе його на код — у VS Code і у Visual Studio 2022 та 2026, у Community, Professional і Enterprise однаково. Кожен крок є і сторінкою в самому редакторі, з кнопкою для нього: покроковий посібник у VS Code, Tools → Coverage Studio → Getting Started у Visual Studio.

Ще не встановлено? Завантажте збірку для свого редактора — Community або Pro для VS Code, чи редакцію для Visual Studio — і повертайтеся сюди; у посібнику користувача є кроки встановлення для обох. Хочете спробувати, перш ніж підключати власний проєкт? У демопроєкті звіт уже готовий.

1Відкрийте проєкт, у якого є звіт покриття

Підійде будь-який із 25 форматів — LCOV, Cobertura, llvm-cov, OpenCover, coverage.py, Istanbul та решта. Якщо під рукою немає жодного, демопроєкт має звіти для C, C++ (clang і MSVC), C#, Visual Basic, TypeScript, JavaScript і Python.

У VS Code

File → Open Folder або файл робочого простору. Значок Coverage з'являється на панелі активності, щойно розширення активне.

У Visual Studio

Рішення або тека (File → Open → Folder — так відкривають проєкт CMake). Розширення завантажується разом із ним; View → Other Windows → Coverage — його вікно.

2Завантажте звіт

Звіт у звичному місці — coverage/lcov.info, coverage.xml, coverage-final.json та інші добре відомі назви, або там, куди вказують налаштування — знаходиться й завантажується сам. Якщо ваш деінде, виберіть його один раз, і він запам'ятається.

У VS Code

Палітра команд → Fucini Coverage: Load Coverage, або Pick Coverage File, щоб вибрати. Run Tests with Coverage розпізнає vitest, jest, pytest, go, cargo, dotnet, maven, gradle, phpunit і ctest, запускає їх з увімкненим покриттям і завантажує те, що вони пишуть.

У Visual Studio

Tools → Coverage Studio → Load Coverage File…, один раз. Панель Fucini Coverage вікна Output каже, які файли шукалися й знайшлися. Запускайте тести як звично; Watch Coverage File перезавантажує, коли звіт змінюється.

3Побачте його в редакторі

Відкрийте вихідний файл. Червоне — рядок, що ніколи не виконувався, бурштинове — рішення, ухвалене лише в один бік. Із коробки позначаються лише такі знахідки; теплова карта фарбує кожен рядок за тим, як часто він виконувався, а вбудовані лічильники пишуть число після нього.

У VS Code

Toggle Coverage Painting вмикає й вимикає позначки; fuciniCoverage.editorGutter.mode вибирає uncovered або heatmap, hitCounts.inline — лічильники. Запуск є і у вікні Coverage, і у власній панелі Test Coverage VS Code.

У Visual Studio

Tools → Coverage Studio → Show Coverage in Editor, а далі Gutter: Heatmap чи Show Inline Hit Counts на ваш смак. Діють ті самі налаштування — редакція для Visual Studio читає ваш .vscode/settings.json.

4Пройдіться прогалинами

Стрибайте з одного непротестованого місця на наступне замість того, щоб прокручувати в пошуках червоного. Рядок над кожною функцією каже, яка її частина виконалася — а також її складність, оцінку CRAP і MC/DC, де звіт їх містить. Наведення на позначений рядок словами каже, яка гілка не була пройдена.

У VS Code

Next Uncovered — це Alt+N, попередній — Alt+P; Next Partly-Tested Decision переходить до наступного рішення, лише частина гілок якого була пройдена.

У Visual Studio

Двоклавішні акорди після Ctrl+Shift+U: N і P — наступний і попередній непокритий рядок, B — наступне частково протестоване рішення; не Alt+N, бо у Visual Studio Alt з літерою відкриває меню. Змініть їх у Tools → Options → Keyboard.

5Прочитайте числа

Кожен файл зі своїми метриками — рядки, гілки, функції, MC/DC — і один бал над усіма: зважене гармонічне середнє, яке не купиш самим лише покриттям рядків. Рядок стану показує цей бал для запуску і для файлу, в якому ви перебуваєте; наведіть вказівник, щоб побачити повну картку.

У VS Code

Вікно Coverage на панелі активності: сортуйте, згортайте, ховайте стовпці, клацніть файл, щоб відкрити його. Show Worst-Covered Files і …Functions перелічують, з чого почати.

У Visual Studio

View → Other Windows → Coverage — те саме дерево, з балом у заголовку; клацніть рядок правою кнопкою, щоб відкрити його або скопіювати шлях. Show Coverage Card відкриває картку рядка стану без вказівника.

6Задайте свої пороги

Скажіть, чого достатньо: мінімум на кожну метрику або профіль безпеки, який вимагає 100 % усього. Картка тоді каже COMPLIANT або NON-COMPLIANT відносно них, і ті самі пороги діють в обох редакторах, бо це ті самі налаштування.

У VS Code

Configure Coverage Compliance відкриває налаштування; Check Coverage Thresholds дає вердикт як команду — для pre-commit hook або конвеєра.

У Visual Studio

Шестірня на панелі інструментів вікна Coverage відкриває вікно налаштувань, яке записує користувацькі налаштування цієї редакції або .vscode/settings.json теки, як каже його перемикач Write changes to.

Далі: посібник користувача для всього іншого — формати, злиття, перепризначення шляхів, бал, HTML-звіт — і FAQ для планів та ліцензій. Редакція для Visual Studio входить у кожен платний план; машині, де активовано VS Code, нічого більше не потрібно, а Tools → Coverage Studio → Licence… приймає код передплати там, де його ще немає.