Усе, що вона робить, усе, що можна налаштувати

Коли тести написав ШІ

Покриття проти згенерованого набору тестів

Огляд викладає загальний аргумент. Ось той самий аргумент, прикладений до самого переліку можливостей: згенерований набір тестів хибить у характерний спосіб — кожен рядок зачеплено, половину рішень так і не взято, а кілька функцій названо в заголовках тестів, але жодного разу не викликано, — і п'ять пунктів нижче саме цю форму й роблять видимою.

• Покриття гілок і MC/DC разом із підказкою по кожній вітці та кожному рішенню відділяють рядок виконався від рішення було перевірене. Набір тестів, що йде щасливим шляхом, показує майже 100% за рядками і близько 50% за гілками — і саме цей розрив і є знахідкою. Зелений прогін тестів не показує з нього нічого.
• Складений бал — це гармонійне середнє, тож сильна метрика не може прикрити слабку; саме така арифметика й потрібна згенерованому набору тестів. Усереднення числа за рядками з числом за гілками поховало б єдине число, на яке варто дивитися.
• Попередження про мертвий код заводять запис у панель Problems для будь-якої функції, що має вимірювані рядки й нульове покриття. Набір тестів, який називає функцію в заголовку тесту й ніколи до неї не доходить, більше ніде не впаде.
• Diff-покриття відносно базового git-рефа звужує все вищесказане до рядків, які щойно змінилися, — до коду, який ви прийняли сьогодні по обіді, а не до середнього за весь час життя репозиторію, з яким великий наявний набір тестів залюбки й далі виглядатиме здоровим.
• Copy Uncovered Lines видає рівно те, що не виконалося, у форматі Markdown — тобто те, що можна вставити просто назад тому асистентові, який цей набір тестів і написав.

Ніщо з цього не читає тест і не судить його, і нічого тут не слід розуміти як таку заяву: тест узагалі без жодних перевірок усе одно покриває кожен рядок, якого торкається. Ці метрики вимірюють ту частину, яку рецензент не втримає в голові, — який код ніколи не виконувався.

Унікально для цього розширення

Ваше покриття рядків показує 100%. 312 байтів вашого двійкового файлу так і не виконалися.

Кожна інша метрика тут вимірюється з коду: інструментуйте код, запустіть інструментовану збірку, порахуйте, що спрацювало. Покриття об'єктного коду вимірює те, до чого не дістанеться жоден засіб на рівні джерела — скільки зібраного двійкового файлу справді виконалося, у байтах інструкцій, спостерігаючи за потоком інструкцій. Компілятор породжує код, якого немає в жодному вашому рядку: перевірки меж масивів, таблиці переходів switch, вивантаження регістрів, допоміжні підпрограми рантайму для ділення чи плаваючої коми. Нічого з цього не з'являється у вашому джерелі, тож жоден засіб на рівні джерела — включно з цим розширенням, для будь-якої іншої зчитуваної ним метрики — не скаже, чи це виконалося. Це також єдина тут метрика, що відповідає на питання чи покриває це асемблер?, оскільки рукописний асемблер ніколи не інструментується.

DO-178C прямо називає це: на рівні A воно вимагається на додачу до MC/DC. Жодне інше розширення VS Code його не читає. Як отримати це з вбудованого пристрою →

Можливості

Основа

• Подання Coverage з кожним виміряним файлом, оглядова лінійка та Annotated Source; у власному полі редактора типово лише те, що варте позначки — смужки MC/DC, трикутники «з попереднього прогону», крапки відредагованих рядків, — а смужки лише на непокритих рядках або теплова карта влучань за одне налаштування звідси.
• Порядкове покриття операторів, гілок, функцій, регіонів, MC/DC і інстанціацій C++ — залежно від того, що надає файл трасування.
• Прийом кількох форматів і детермінований злиття кількох запусків із записаним походженням даних.
• Переприв'язка шляхів — шляхи CI build-машини → ваш локальний робочий простір.
• Diff-покриття — позначає лише рядки, змінені відносно базового посилання git.
• Значки в Провіднику та елемент рядка стану для всього запуску, з кольоровим кодуванням за композитним показником.
• Режим спостереження — автоматичне перезавантаження при зміні файлу трасування.
• Run Tests with Coverage — розпізнає тестовий рушій із кореня робочого простору й запускає його з увімкненим покриттям, завантажуючи записане.
• Віддалені файли трасування — запис coverageFile.paths може бути URL-адресою https://: артефакт CI отримується умовно (ETag / Last-Modified), із заголовками, які ви налаштували в remote.headers, завантажується як локальний файл і повторно отримується за таймером через remote.refreshMinutes; коли отримання не вдається, натомість завантажується остання завантажена копія.
• Змінні в шляхах — ${workspaceFolder}, ${workspaceFolderBasename}, ${userHome}, ${env:NAME}, ${command:id} і ${config:section.key} у кожному налаштуванні шляху; невідома змінна залишається як записано, тож помилка друку з'являється в журналі пошуку, а не зникає.
• Багатокореневі робочі області — кожна тека шукається за власними налаштуваннями (її .vscode/settings.json або її запис у .code-workspace), її файли трасування зливаються в один прогін, подання Coverage групує файли за теками, а додана чи вилучена тека сама перезавантажує покриття.
• Ще два тригери перезавантаження — абсолютний запис coverageFile.paths поза робочою областю опитується, тож файл, що там з'явився, завантажується; а watch.reloadAfterTasks називає завдання (npm: test), завершення яких перезавантажує покриття, незалежно від того, чи ввімкнено режим спостереження.
• Поступ, який можна скасувати — завантаження десяти чи більше файлів трасування, або 8 МБ чи більше їх, і кожен Generate Full HTML Report виконуються під сповіщенням про поступ із кнопкою Cancel; скасування залишає попередній прогін завантаженим.
• Власне подання Test Coverage VS Code — кожне завантаження також публікується через API Test Coverage редактора (testCoverage.publish), тож панель покриття в Test Explorer, пофайлові відсотки в Провіднику та власний перемикач редактора Show Inline Coverage показують ті самі числа; Show in Test Coverage View публікує на вимогу й відкриває панель. Коли тести мають назви (TN: у lcov), подання фільтрує покриття файлу за тестом.
• Запропоноване правило переприв'язки — коли після завантаження лишаються незіставлені файли (шляхи контейнера чи CI проти локальної робочої копії), розширення виводить правило pathRemap, яке пояснює найбільше з них, пропонує Apply Suggested Remap у результаті завантаження та Suggest Path Remap Rule у палітрі; без клацання нічого не записується.
• Глоби ігнорування — fuciniCoverage.ignore (vendor/**, **/*.generated.ts) відкидає цілі файли з прогону під час завантаження, тож кожне подання, кожен запобіжник і кожен експорт рахують без них; результат завантаження каже, скільки їх, а вивід називає кожен.
• Невиміряне проти непокритого — файл, якого не завантажив жоден тест, не оцінюється як 0% за вашою спиною; рядок стану каже про нього не виміряно, а unmeasured.mode може перелічити такі файли в поданні Coverage або зарахувати кожен як непокритий файл, із threshold.unmeasuredFiles, щоб контролювати, скільки їх.
• Видно, що зробило злиття — коли завантажено кілька файлів трасування, кожен рядок файлу називає звіт, з якого взято його числа, значок обведено там, де ці числа переважили старіший звіт, кожен рядок файлу трасування рахує, скільки його файлів переважено або переважили інші, а клацання рядка файлу трасування підсвічує його файли в дереві (coverageView.mergedMarks).

Композитний показник і відповідність

Єдине зважене гармонійне середнє для рядків, гілок, функцій, регіонів, MC/DC та інстанціацій. Оскільки це гармонійне середнє, слабку метрику не можна замаскувати ідеальною. Ваги за замовчуванням відповідають рівням IEC 61508 / ISO 26262 / DO-178C, а вердикт COMPLIANT / NON-COMPLIANT визначається пороговими значеннями для кожної метрики та налаштовуваним режимом.

Screenshot pending — add assets/img/statusbar.png (see SCREENSHOTS.md).

Аналіз безпосередньо в редакторі

• Function CodeLens — відсоток покриття для кожної функції, клацніть, щоб перейти до першого непокритого рядка.
• Наведення на гілки та MC/DC — кількість пройдених/непройдених гілок для кожної гілки та розбивка умов/векторів для кожного рішення; необов'язкова кольорова смуга MC/DC на полях.
• Попередження про мертвий код — попередження на панелі Problems для функцій із вимірюваними рядками та нульовим покриттям.
• Навігація Next/Previous Uncovered (наступний/попередній непокритий рядок).
• Попередження про невідповідність, коли вміст файлу більше не відповідає прогону — оновлюється при збереженні чи зміні файлів на диску, з точною різницею при наведенні.
• З попереднього прогону — червоний трикутник на кожному рядку, виконаному в попередньому прогоні й не виконаному в цьому, зелений для зворотного випадку, з оглядовою лінійкою та кількістю влучань при наведенні.
• Змінені буфери — кожна позначка, підказка та CodeLens рухаються разом із текстом під час редагування і зникають із переписаного рядка, де сіра крапка пояснює чому.
• Режими поля редактора — editorGutter.mode залишає в полі лише знахідки (off), ставить смужку на кожен рядок, який жодного разу не виконався, і бурштинову там, де якусь вітку гілки жодного разу не взято (uncovered), або додає теплий відтінок на кожен виконаний рядок — тим гарячіший, чим частіше він виконувався (heatmap); Choose Editor Gutter Mode... перемикає з палітри або з меню рядка стану.
• Вбудовані лічильники влучань — hitCounts.inline дописує ×12 після кожного рядка, з якого починається інструкція, включно з ×0; Toggle Inline Hit Counts перемикає їх.
• Порядкові записи в Problems — problems.perLine ставить діагностику рівня Information на кожен блок рядків, які жодного разу не виконалися, у відкритому документі (мертва функція — це один запис, а не сорок) і, за бажанням, на кожен рядок, у якому якусь вітку гілки жодного разу не взято; записи йдуть за своїми рядками під час редагування.
• Підфарбовування рядків і карта на смузі прокручування — lineHighlight кладе напівпрозоре тло за самі рядки замість позначки в полі (або на додачу до неї), а overviewRuler самостійно вирішує щодо смужки на смузі прокручування: із вимкненим полем це карта прогалин файлу вздовж смуги прокручування і нічого поруч із кодом.
• Який трасувальний файл покрив цей рядок — коли об’єднано кілька звітів, підказка з кількістю влучень називає кожен, що покрив рядок (разом із назвою набору тестів із TN: у lcov), а клацання на рядку трасувального файлу в поданні Coverage підсвічує внесені ним рядки.

• Червоний, бурштиновий і зелений — режим coverage для editorGutter.mode і lineHighlight фарбує кожен виміряний рядок кольорами колірної шкали; кнопка режиму в рядку стану та Alt+G переходять від одного режиму до наступного.
• Ваші кольори, з попереднім переглядом — колірна шкала та відтінки теплової карти (heatmap.colors, heatmap.colorsDark) є налаштуваннями, а сторінка налаштувань показує їх на світлому й темному редакторі просто під час вибору.
• З якого звіту береться файл — коли два звіти вимірюють той самий код, правила coverageFile.sources або Choose Coverage Source for This File... вирішують, який із них показує кожен файл, замість того щоб перемагав найновіший.

Звітність та історія

• Generate Full HTML Report — самостійно відрендерений багатосторінковий звіт по кожному каталогу; Open Annotated Source для окремого файлу.
• Необов'язкова локальна історія запусків із трендом покриття (▲/▼), а також команди Compare Two History Runs і Compare with Last Run.
• Show Worst-Covered Files / Functions та Copy Uncovered Lines (у форматі Markdown).
• Export Fucini JSON — повна нормалізована модель.
• Export Coverage Report... — той самий запуск як CSV (за файлами або за функціями), зведення у Markdown, файл трасування LCOV, XML Cobertura, SARIF або автономний значок SVG. Із двадцятьма п'ятьма читачами й цими записами розширення конвертує між форматами: завантажте JaCoCo чи llvm-cov JSON і видайте LCOV, який читають Codecov, Coveralls і SonarQube, або XML Cobertura, який зчитують Jenkins, GitLab та Azure DevOps.
• Generate Coverage Badge — SVG у стилі shields, записаний просто в робочу область (badge.outputPath, типово coverage-badge.svg), щоб README вбудував його через ![coverage](coverage-badge.svg) без жодного хостингового сервісу; badge.metric вибирає рядки, гілки, MC/DC або композитний показник, колір іде за рівнями colorScale.*, а badge.autoUpdate переписує його після кожного завантаження.

Screenshot pending — add assets/img/report.png (see SCREENSHOTS.md).

Screenshot pending — add assets/img/annotated-source.png (see SCREENSHOTS.md).

Community і Pro, функція за функцією

Два лістинги, одна кодова база. Community — назавжди безкоштовний рівень, і саме на нього переходить лістинг Pro після 14-денного пробного періоду; Pro і пробний період — це все, без обмежень. Межу проведено так, щоб безкоштовний рівень завжди бачив кожну знахідку й платив лише за зручність, доказ і масштаб — у VS Code команда Fucini Coverage: What Community Includes показує той самий список із сьогоднішніми лічильниками за кожним лімітом.

Тиждень триває сім днів від першого використання, яке його відкрило, і ніщо з того, що лише читає покриття, не рахується. Не готові до підписки? 7-денна перепустка — це все з правого стовпця на один тиждень, оплачене один раз, без жодних скасувань.

VS Code і Visual Studio пліч-о-пліч

Один продукт, два редактори, один читач: той самий звіт дає ті самі числа, до цифри, в обох. Coverage Studio для Visual Studio працює у Visual Studio 2022 і 2026 — Community, Professional та Enterprise і не використовує власного покриття коду Visual Studio, яке у 2022 є лише в Enterprise; він входить у кожен платний план, а пристрій з обома редакторами — це одне місце. Усе над рискою є в обох; під нею — те, чому у Visual Studio немає відповідника, і те, що там ще попереду.

Довідник налаштувань

Налаштовується в інтерфейсі Settings (пошук за Fucini Coverage) або у файлі settings.json.

Download the complete settings reference — a commented settings.json holding every fuciniCoverage.* setting at the same default the packaged extension uses, ready to copy into your workspace or user settings. Regenerated from the extension on every release, so it cannot drift from what the VSIX ships.

Рядок, що закінчується на Для кожної теки., у багатокореневій робочій області приймає значення рівня теки: кожна тека шукається з власним .vscode/settings.json або записом у .code-workspace, і ${workspaceFolder} у ньому означає саме цю теку.

Локалізація

Пошук і завантаження

Колірна шкала та значки

Композитний показник (зважене гармонійне середнє)

Порогові значення та відповідність

Diff, переприв'язка шляхів і звіти

Відображення та аналіз

Історія

Швидкі дії рядка стану

Усі за замовчуванням мають значення false, крім двох останніх; увімкніть, щоб додати відповідну дію до швидкого меню: quickActions.compareWithLastRun, openAnnotatedSource, openAnnotatedSourceToSide, toggleAnnotatedSource, toggleWatch, worstCoveredFiles, worstCoveredFolders, worstCoveredFunctions, nextUncovered, previousUncovered, checkThresholds, copyUncoveredLines, compareHistoryRuns, exportJson, exportReport, generateBadge, showTestCoverage, chooseGutterMode, toggleInlineHitCounts.

Телеметрія

Оновлення

Ліцензування