Wszystko, co robi, wszystko, co możesz dostosować

Gdy testy napisała SI

Pokrycie wobec wygenerowanego zestawu testów

Przegląd przedstawia argument ogólny. Tutaj jest on zestawiony z samą listą funkcji, bo wygenerowany zestaw testów zawodzi w charakterystyczny sposób — każda linia dotknięta, połowa decyzji nigdy niepodjęta i kilka funkcji wymienionych w tytułach testów, lecz nigdy niewywołanych — a pięć pozycji poniżej właśnie ten kształt czyni widocznym.

• Pokrycie gałęzi i MC/DC, wraz z podpowiedzią dla każdej gałęzi i każdej decyzji, oddziela linia się wykonała od decyzja została przećwiczona. Zestaw idący wyłącznie szczęśliwą ścieżką pokazuje blisko 100% na liniach i blisko 50% na gałęziach — i to właśnie ten rozstęp jest znaleziskiem. Zielony przebieg testów nie pokazuje z tego nic.
• Wynik złożony to średnia harmoniczna, więc mocna metryka nie przykryje słabej — dokładnie ta arytmetyka, której potrzebuje wygenerowany zestaw testów. Uśrednienie liczby dla linii z liczbą dla gałęzi pogrzebałoby jedyną liczbę wartą spojrzenia.
• Ostrzeżenia o martwym kodzie dodają wpis w panelu Problems dla każdej funkcji z mierzalnymi liniami i zerowym pokryciem. Zestaw, który wymienia funkcję w tytule testu i nigdy do niej nie dociera, nigdzie indziej nie zawiedzie.
• Pokrycie diffa względem bazowego refa gita zawęża wszystko powyższe do linii, które właśnie się zmieniły — do kodu przyjętego dziś po południu, a nie do średniej z całego życia repozytorium, przy której duży istniejący zestaw testów będzie sobie dalej spokojnie wyglądał zdrowo.
• Copy Uncovered Lines wypisuje dokładnie to, co nigdy się nie wykonało, w Markdownie — czyli coś, co wkleja się prosto z powrotem temu asystentowi, który ten zestaw testów w ogóle napisał.

Nic z tego nie czyta testu i go nie ocenia, i niczego tutaj nie należy tak rozumieć: test bez ani jednej asercji nadal pokrywa każdą linię, której dotknie. Mierzone jest to, czego recenzent nie utrzyma w głowie — który kod nigdy się nie wykonał.

Unikatowe dla tego rozszerzenia

Twoje pokrycie wierszy mówi 100%. 312 bajtów Twojego pliku binarnego nigdy się nie wykonało.

Każda inna miara tutaj mierzona jest ze źródła: instrumentuj kod, uruchom instrumentowaną kompilację, policz, co się wyzwoliło. Pokrycie kodu obiektowego mierzy coś, do czego żadne narzędzie działające na źródłach nie sięgnie — jaka część zbudowanego pliku binarnego faktycznie się wykonała, w bajtach instrukcji, przez obserwację strumienia instrukcji. Kompilator emituje kod, za którym nie stoi żaden wiersz Twojego źródła: kontrole zakresu tablic, tablice skoków switch, zrzuty rejestrów, procedury pomocnicze środowiska wykonawczego dla dzielenia lub liczb zmiennoprzecinkowych. Nic z tego nie pojawia się w Twoim źródle, więc żadne narzędzie działające na źródłach — łącznie z tym rozszerzeniem, dla każdej innej odczytywanej przez nie miary — nie powie, czy to się wykonało. To także jedyna tutaj miara odpowiadająca na pytanie czy to obejmuje asembler?, bo ręcznie pisany asembler nigdy nie jest instrumentowany.

DO-178C wprost to nazywa: na poziomie A wymagane jest oprócz MC/DC. Żadne inne rozszerzenie VS Code tego nie odczytuje. Jak to uzyskać z urządzenia wbudowanego →

Możliwości

Podstawowe

• Widok Coverage każdego zmierzonego pliku, linijka przeglądu i Annotated Source; na własnym marginesie edytora domyślnie tylko to, co warte oznaczenia — paski MC/DC, trójkąty „od ostatniego przebiegu”, kropki edytowanych wierszy — a paski tylko na niepokrytych wierszach albo mapa cieplna liczby trafień o jedno ustawienie dalej.
• Pokrycie wiersz po wierszu dla instrukcji, gałęzi, funkcji, regionów, MC/DC i instancjacji C++, w zależności od tego, co dostarcza plik śledzenia.
• Wczytywanie wielu formatów i deterministyczne łączenie kilku przebiegów z zapisanym pochodzeniem.
• Przemapowanie ścieżek — ścieżki maszyny budującej CI → Twoje lokalne środowisko robocze.
• Pokrycie różnicowe — dekoruje tylko linie zmienione względem bazowej referencji git.
• Odznaki Explorer oraz element paska stanu na poziomie całego przebiegu, kolorowany według wyniku złożonego.
• Tryb obserwacji — automatyczne ponowne wczytywanie po zmianie pliku śledzenia.
• Run Tests with Coverage — rozpoznaje program uruchamiający testy po korzeniu obszaru roboczego i uruchamia go z włączonym pokryciem, wczytując to, co zapisze.
• Zdalne pliki śledzenia — wpis coverageFile.paths może być adresem URL https://: artefakt CI jest pobierany warunkowo (ETag / Last-Modified), z nagłówkami skonfigurowanymi w remote.headers, wczytywany jak plik lokalny i pobierany ponownie według zegara z remote.refreshMinutes; gdy pobranie się nie powiedzie, wczytywana jest ostatnia pobrana kopia.
• Zmienne w ścieżkach — ${workspaceFolder}, ${workspaceFolderBasename}, ${userHome}, ${env:NAME}, ${command:id} i ${config:section.key} w każdym ustawieniu ścieżki; nieznana zmienna zostaje tak, jak ją zapisano, więc literówka pojawia się w dzienniku wykrywania, zamiast zniknąć.
• Obszary robocze wielokorzeniowe — każdy folder jest wykrywany z własnych ustawień (jego .vscode/settings.json lub wpisu w .code-workspace), jego pliki śledzenia scalają się w jeden przebieg, widok Coverage grupuje pliki według folderu, a folder dodany lub usunięty sam przeładowuje pokrycie.
• Dwa kolejne wyzwalacze przeładowania — bezwzględny wpis coverageFile.paths poza obszarem roboczym jest odpytywany, więc plik, który się tam pojawi, zostaje wczytany; a watch.reloadAfterTasks wymienia zadania (npm: test), których zakończenie przeładowuje pokrycie, niezależnie od tego, czy tryb obserwacji jest włączony.
• Postęp, który można anulować — wczytanie dziesięciu lub więcej plików śledzenia, albo 8 MB lub więcej takich plików, oraz każdy Generate Full HTML Report działają pod powiadomieniem o postępie z przyciskiem Anuluj; anulowanie zostawia poprzedni przebieg wczytany.
• Własny widok Test Coverage VS Code — każde wczytanie jest też publikowane przez API Test Coverage edytora (testCoverage.publish), więc panel pokrycia w Test Explorer, procenty per plik w Eksploratorze i własny przełącznik edytora Show Inline Coverage pokazują te same liczby; Show in Test Coverage View publikuje na żądanie i otwiera panel. Przy nazwanych testach (TN: w lcov) widok filtruje pokrycie pliku według testu.
• Proponowana reguła przemapowania — gdy po wczytaniu zostają niedopasowane pliki (ścieżki z kontenera lub CI wobec lokalnego checkoutu), rozszerzenie wywodzi regułę pathRemap, która wyjaśnia ich najwięcej, oferuje Apply Suggested Remap w wyniku wczytania i Suggest Path Remap Rule w palecie; bez kliknięcia nic nie jest zapisywane.
• Wzorce ignorowania — fuciniCoverage.ignore (vendor/**, **/*.generated.ts) usuwa całe pliki z przebiegu przy wczytaniu, więc każdy widok, bramka i eksport liczy bez nich; wynik wczytania mówi ile, a wyjście wymienia każdy z nich.
• Niezmierzone a niepokryte — plik, którego żaden test nie wczytał, nie jest za Twoimi plecami oceniany jako 0%; pasek stanu mówi o nim not measured, a unmeasured.mode może wymienić takie pliki w widoku Coverage albo policzyć każdy jako niepokryty plik, z threshold.unmeasuredFiles do bramkowania ich liczby.
• Widać, co zrobiło scalanie — przy kilku wczytanych plikach śledzenia każdy wiersz pliku podaje raport, z którego pochodzą jego liczby, plakietka ma obrys tam, gdzie te liczby zastąpiły starszy raport, każdy wiersz pliku śledzenia liczy, ile jego plików zostało zastąpionych lub zastąpiło inne, a kliknięcie wiersza pliku śledzenia podświetla jego pliki w drzewie (coverageView.mergedMarks).

Wynik złożony i zgodność

Pojedyncza ważona średnia harmoniczna obejmująca wiersze, gałęzie, funkcje, regiony, MC/DC i instancjacje. Ponieważ jest to średnia harmoniczna, słaba metryka nie może zostać zamaskowana przez idealną. Wagi domyślnie odpowiadają poziomom IEC 61508 / ISO 26262 / DO-178C, a werdykt COMPLIANT / NON-COMPLIANT jest determinowany przez progi dla poszczególnych metryk oraz konfigurowalny tryb.

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

Analiza w edytorze

• CodeLens funkcji — % pokrycia na funkcję, kliknięcie przenosi do pierwszej niepokrytej linii.
• Podpowiedzi po najechaniu na gałąź i MC/DC — liczby wzięte/niewzięte na gałąź oraz podział warunek/wektor na decyzję; opcjonalny kolorowy wskaźnik marginesu MC/DC.
• Ostrzeżenia o martwym kodzie — ostrzeżenie w panelu Problems dla funkcji z mierzalnymi liniami i zerowym pokryciem.
• Nawigacja Next/Previous Uncovered.
• Ostrzeżenie o niezgodności, gdy zawartość pliku nie pasuje już do jego przebiegu — aktualizowane przy zapisie lub zmianie na dysku, z dokładną różnicą po najechaniu.
• Od ostatniego przebiegu — czerwony trójkąt na każdym wierszu wykonanym w poprzednim przebiegu, a nie w tym, zielony w odwrotnym przypadku, z linijką przeglądu i liczbą trafień po najechaniu.
• Edytowane bufory — każde oznaczenie, podpowiedź i CodeLens przesuwa się z tekstem podczas edycji i znika z przepisanego wiersza, gdzie szara kropka mówi dlaczego.
• Tryby marginesu edytora — editorGutter.mode ogranicza margines do ustaleń (off), stawia pasek na każdym wierszu, który nigdy się nie wykonał, i bursztynowy tam, gdzie gałęzi nigdy nie wzięto (uncovered), albo dodaje ciepły odcień na każdym wykonanym wierszu, tym gorętszy, im częściej się wykonał (heatmap); Choose Editor Gutter Mode... przełącza z palety lub z menu paska stanu.
• Liczniki trafień w wierszu — hitCounts.inline dopisuje ×12 za każdym wierszem, w którym zaczyna się instrukcja, łącznie z ×0; Toggle Inline Hit Counts to przełącza.
• Wpisy w Problems per wiersz — problems.perLine stawia diagnostykę Information na każdym bloku wierszy, które nigdy się nie wykonały, w otwartym dokumencie (martwa funkcja to jeden wpis, nie czterdzieści), a opcjonalnie na każdym wierszu z gałęzią, której nigdy nie wzięto; wpisy podążają za swoimi wierszami podczas edycji.
• Podbarwienie wiersza i mapa na pasku przewijania — lineHighlight umieszcza półprzezroczyste tło za samymi wierszami zamiast (lub obok) znaku na marginesie, a overviewRuler sam decyduje o pasku na pasku przewijania: przy wyłączonym marginesie to mapa luk pliku i nic obok kodu.
• Który plik śledzenia pokrył ten wiersz — przy kilku scalonych raportach dymek z liczbą wykonań wymienia każdy, który pokrył wiersz (łącznie z nazwą zestawu z TN: w lcov), a kliknięcie wiersza pliku śledzenia w widoku Coverage podświetla wiersze, które on wniósł.

• Czerwony, bursztynowy i zielony — tryb coverage ustawień editorGutter.mode i lineHighlight maluje każdy zmierzony wiersz kolorami skali kolorów; przycisk trybu na pasku stanu i Alt+G przechodzą od jednego trybu do następnego.
• Twoje kolory z podglądem — skala kolorów i odcienie mapy cieplnej (heatmap.colors, heatmap.colorsDark) to ustawienia, a strona ustawień pokazuje je na jasnym i ciemnym edytorze już w trakcie wybierania.
• Z którego raportu pochodzi plik — gdy dwa raporty mierzą ten sam kod, reguły coverageFile.sources lub Choose Coverage Source for This File... decydują, który z nich pokazuje każdy plik, zamiast aby wygrywał najnowszy.

Raportowanie i historia

• Generate Full HTML Report — samodzielnie generowany, wielostronicowy raport dla każdego katalogu; Open Annotated Source dla pojedynczego pliku.
• Opcjonalna lokalna historia przebiegów z trendem pokrycia (▲/▼) oraz Compare Two History Runs i Compare with Last Run.
• Show Worst-Covered Files / Functions i Copy Uncovered Lines (Markdown).
• Export Fucini JSON — pełny znormalizowany model.
• Export Coverage Report... — ten sam przebieg jako CSV (na plik lub na funkcję), podsumowanie Markdown, plik śledzenia LCOV, XML Cobertura, SARIF albo samodzielna odznaka SVG. Z dwudziestoma pięcioma czytnikami i tymi zapisami rozszerzenie konwertuje między formatami: wczytaj JaCoCo lub llvm-cov JSON i wypisz LCOV, który czytają Codecov, Coveralls i SonarQube, albo XML Cobertura, który wczytują Jenkins, GitLab i Azure DevOps.
• Generate Coverage Badge — SVG w stylu shields zapisywany prosto do obszaru roboczego (badge.outputPath, domyślnie coverage-badge.svg), aby README osadził go przez ![coverage](coverage-badge.svg) bez żadnej usługi hostowanej; badge.metric wybiera wiersze, gałęzie, MC/DC lub wynik złożony, kolor podąża za poziomami colorScale.*, a badge.autoUpdate przepisuje ją po każdym wczytaniu.

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

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

Community i Pro, funkcja po funkcji

Dwa wpisy, jedna baza kodu. Community to na stałe bezpłatna edycja i to, na czym ląduje wpis Pro po 14-dniowym okresie próbnym; Pro i okres próbny to wszystko, bez limitów. Granica jest wytyczona tak, by edycja bezpłatna zawsze widziała każdy wynik i płaciła tylko za wygodę, dowód i skalę — w VS Code Fucini Coverage: What Community Includes pokazuje tę samą listę z dzisiejszymi licznikami dla każdego limitu.

Tydzień trwa siedem dni od pierwszego użycia, które go otworzyło, a nic, co jedynie odczytuje pokrycie, nie jest liczone. Subskrypcja to jeszcze nie ten moment? Karnet 7-dniowy to wszystko z prawej kolumny na jeden tydzień, opłacone raz, bez niczego do anulowania.

VS Code i Visual Studio obok siebie

Jeden produkt, dwa edytory, jeden czytnik: ten sam raport daje te same liczby, co do cyfry, w obu. Coverage Studio dla Visual Studio działa w Visual Studio 2022 i 2026 — Community, Professional i Enterprise i nie korzysta z własnego pokrycia kodu Visual Studio, które w 2022 jest tylko w Enterprise; jest w cenie każdego płatnego planu, a urządzenie z oboma edytorami to jedno miejsce. Wszystko nad kreską jest w obu; pod nią to, czego Visual Studio nie ma odpowiednika, i to, co tam dopiero nadejdzie.

Referencja ustawień

Konfiguruj w interfejsie ustawień (wyszukaj Fucini Coverage) lub w 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.

Wiersz kończący się na Per folder. przyjmuje w obszarze roboczym wielokorzeniowym wartość na poziomie folderu: każdy folder jest wykrywany z własnym wpisem w .vscode/settings.json lub .code-workspace, a ${workspaceFolder} w nim oznacza ten folder.

Lokalizacja

Wykrywanie i wczytywanie

Skala kolorów i plakietki

Wynik złożony (ważona średnia harmoniczna)

Progi i zgodność

Diff, przemapowanie i raporty

Wyświetlanie i analiza

Historia

Szybkie akcje paska stanu

Wszystkie domyślnie false poza dwoma ostatnimi; włącz, aby dodać odpowiednią akcję do szybkiego menu: quickActions.compareWithLastRun, openAnnotatedSource, openAnnotatedSourceToSide, toggleAnnotatedSource, toggleWatch, worstCoveredFiles, worstCoveredFolders, worstCoveredFunctions, nextUncovered, previousUncovered, checkThresholds, copyUncoveredLines, compareHistoryRuns, exportJson, exportReport, generateBadge, showTestCoverage, chooseGutterMode, toggleInlineHitCounts.

Telemetria

Aktualizacje

Licencjonowanie