Sve što radi, sve što možete podesiti

Kada je testove napisala UI

Pokrivenost naspram generiranog skupa testova

Pregled iznosi opći argument. Evo ga primijenjenog na sam popis mogućnosti, jer generirani skup testova zakazuje na prepoznatljiv način — svaki redak dotaknut, polovica odluka nikad donesena i pokoja funkcija imenovana u naslovima testova, ali nikad pozvana — a pet stavki u nastavku upravo taj oblik čini vidljivim.

• Pokrivenost grana i MC/DC, uz opis pri prelasku mišem po svakoj grani i svakoj odluci, razdvaja redak se izvršio od odluka je iskušana. Skup testova koji ide samo sretnim putem pokazuje blizu 100% na recima i blizu 50% na granama, a upravo je taj raskorak nalaz. Zeleno izvođenje testova od toga ne pokazuje ništa.
• Složena ocjena je harmonijska sredina, pa jaka metrika ne može prikriti slabu — a to je točno ona aritmetika koja generiranom skupu testova treba. Prosjek broja za retke i broja za grane zakopao bi jedini broj koji vrijedi pogledati.
• Upozorenja o mrtvom kodu podižu stavku u ploči Problems za svaku funkciju s mjerljivim recima i nultom pokrivenošću. Skup testova koji funkciju imenuje u naslovu testa, a nikad do nje ne dođe, nigdje drugdje neće pasti.
• Diff pokrivenost u odnosu na git bazni ref sve navedeno sužava na retke koji su se upravo promijenili — na kod koji ste prihvatili danas poslijepodne, a ne na prosjek cijelog života repozitorija, s kojim će velik postojeći skup testova i dalje veselo izgledati zdravo.
• Copy Uncovered Lines ispisuje točno ono što se nikad nije izvršilo, u Markdownu — dakle nešto što se lijepi ravno natrag onom asistentu koji je taj skup testova uopće i napisao.

Ništa od ovoga ne čita test i ne prosuđuje ga, i ništa se ovdje ne smije shvatiti kao takva tvrdnja: test bez ijedne provjere ispravnosti i dalje pokriva svaki redak kojega dotakne. Ovo mjeri onaj dio koji recenzent ne može držati u glavi — koji se kod nikad nije izvršio.

Jedinstveno za ovo proširenje

Vaša pokrivenost redaka kaže 100%. 312 bajtova vaše binarne datoteke nikad nije izvršeno.

Svaka druga mjera ovdje mjeri se iz izvora: instrumentirajte kod, pokrenite instrumentiranu verziju, izbrojite što se okinulo. Pokrivenost objektnog koda mjeri nešto do čega nijedan alat na razini izvora ne može doprijeti — koliko se izgrađene binarne datoteke doista izvršilo, u bajtovima instrukcija, promatranjem toka instrukcija. Prevoditelj proizvodi kod za koji ne stoji nijedan redak vašeg izvora: provjere granica polja, tablice skokova za switch, spremanje registara, pomoćne rutine za dijeljenje ili pomični zarez. Ništa od toga ne pojavljuje se u vašem izvoru, pa nijedan alat na razini izvora — uključujući ovo proširenje, za svaku drugu mjeru koju čita — ne može reći je li se izvršilo. To je ujedno jedina mjera ovdje koja odgovara na pitanje pokriva li ovo assembler?, jer se ručno pisani assembler nikad ne instrumentira.

DO-178C to izričito imenuje: na razini A zahtijeva se uz MC/DC. Nijedno drugo proširenje za VS Code to ne čita. Kako to dobiti s ugrađenog uređaja →

Mogućnosti

Osnovno

• Prikaz Coverage sa svakom izmjerenom datotekom, pregledno ravnalo i Annotated Source; u vlastitom rubu uređivača, prema zadanome, samo ono što vrijedi označiti — MC/DC trake, trokuti od zadnjeg izvođenja, točke uređenih redaka — a trake samo na nepokrivenim retcima ili toplinska karta broja pogodaka jednu su postavku daleko.
• Pokrivenost po retku za naredbe, grane, funkcije, regije, MC/DC i C++ instanciranja, ovisno o tome što pruža datoteka traga.
• Učitavanje više formata i deterministično spajanje više izvođenja sa zabilježenim podrijetlom.
• Premapiranje putanja — putanje CI build stroja → vaš lokalni radni prostor.
• Diferencijalna pokrivenost — dekorira samo retke promijenjene u odnosu na osnovnu git granu.
• Explorer značke i stavka statusne trake na razini cijelog izvođenja, obojena prema kompozitnom rezultatu.
• Način rada watch — automatsko ponovno učitavanje kada se datoteka traga promijeni.
• Run Tests with Coverage — prepoznaje pokretač testova iz korijena radnog prostora i pokreće ga s uključenom pokrivenošću, učitavajući što zapiše.
• Udaljene datoteke traga — unos u coverageFile.paths može biti https:// URL: CI artefakt dohvaća se uvjetno (ETag / Last-Modified), sa zaglavljima koja podesite u remote.headers, učitava kao lokalna datoteka i ponovno dohvaća po mjeraču vremena s remote.refreshMinutes; kad dohvat ne uspije, umjesto toga se učitava zadnja preuzeta kopija.
• Varijable u putanjama — ${workspaceFolder}, ${workspaceFolderBasename}, ${userHome}, ${env:NAME}, ${command:id} i ${config:section.key} u svakoj postavci putanje; nepoznata varijabla ostavlja se kako je napisana, pa se tipfeler pojavljuje u dnevniku otkrivanja umjesto da nestane.
• Radni prostori s više korijena — svaka se mapa otkriva iz vlastitih postavki (njezin .vscode/settings.json ili njezin unos u .code-workspace), njezine datoteke traga spajaju se u jedno izvođenje, prikaz Coverage grupira datoteke po mapi, a dodana ili uklonjena mapa sama ponovno učitava pokrivenost.
• Dva okidača ponovnog učitavanja više — apsolutni unos u coverageFile.paths izvan radnog prostora se ispituje, pa se datoteka koja se ondje pojavi učitava; a watch.reloadAfterTasks imenuje zadatke (npm: test) čiji završetak ponovno učitava pokrivenost, bio način rada watch uključen ili ne.
• Napredak koji možete prekinuti — učitavanje deset ili više datoteka traga, ili 8 MB ili više njih, i svaki Generate Full HTML Report izvode se pod obaviješću o napretku s gumbom Cancel; prekid ostavlja prethodno izvođenje učitanim.
• Vlastiti prikaz Test Coverage VS Codea — svako učitavanje objavljuje se i kroz Test Coverage API uređivača (testCoverage.publish), pa ploča pokrivenosti Test Explorera, postoci po datoteci u Exploreru i vlastiti prekidač uređivača Show Inline Coverage prikazuju iste brojeve; Show in Test Coverage View objavljuje na zahtjev i otvara ploču. S imenovanim testovima (TN: u lcovu) prikaz filtrira pokrivenost datoteke po testu.
• Predloženo pravilo premapiranja — kad učitavanje ostavi datoteke nepodudarene (putanje kontejnera ili CI-ja naspram lokalnog checkouta), proširenje izvodi pravilo pathRemap koje objašnjava najviše njih, nudi Apply Suggested Remap na rezultatu učitavanja i Suggest Path Remap Rule u paleti; bez klika ništa se ne zapisuje.
• Glob uzorci za zanemarivanje — fuciniCoverage.ignore (vendor/**, **/*.generated.ts) izbacuje cijele datoteke iz izvođenja pri učitavanju, pa svaki prikaz, vrata i izvoz broje bez njih; rezultat učitavanja kaže koliko, a izlaz imenuje svaku.
• Neizmjereno naspram nepokrivenog — datoteka koju nijedan test nije učitao ne ocjenjuje se kao 0% iza vaših leđa; statusna traka za nju kaže nije izmjereno, a unmeasured.mode može takve datoteke popisati u prikazu Coverage ili svaku brojati kao nepokrivenu datoteku, uz threshold.unmeasuredFiles za vrata prema tome koliko ih ima.
• Vidljivo što je spajanje učinilo — s više učitanih tracefileova svaki redak datoteke imenuje izvještaj iz kojeg potječu njegovi brojevi, oznaka je obrubljena gdje su ti brojevi nadjačali stariji izvještaj, svaki redak tracefilea broji koliko je njegovih datoteka nadjačano ili je nadjačalo druge, a klik na redak tracefilea ističe njegove datoteke u stablu (coverageView.mergedMarks).

Kompozitni rezultat i sukladnost

Jedinstvena ponderirana harmonijska sredina preko redaka, grana, funkcija, regija, MC/DC-a i instanciranja. Budući da je riječ o harmonijskoj sredini, slab pokazatelj ne može biti prikriven savršenim. Ponderi su prema zadanim postavkama usklađeni s razinama IEC 61508 / ISO 26262 / DO-178C, a presuda COMPLIANT / NON-COMPLIANT određena je pragovima po pokazatelju te podesivim načinom rada.

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

Analiza u uređivaču

• CodeLens funkcije — % pokrivenosti po funkciji, klik za skok na prvi nepokriveni redak.
• Lebdenje nad granama i MC/DC — broj uzetih/neuzetih grana po grani i raščlambe uvjeta/vektora po odluci; neobavezna obojena rubna oznaka MC/DC.
• Upozorenja o mrtvom kodu — upozorenje u ploči Problems za funkcije s mjerljivim retcima i nultom pokrivenošću.
• Navigacija Next/Previous Uncovered.
• Upozorenje o nepodudaranju kad sadržaj datoteke više ne odgovara njezinu izvođenju — ažurirano pri spremanju ili promjeni na disku, s točnom razlikom pri prelasku mišem.
• Od zadnjeg izvođenja — crveni trokut na svakom retku izvršenom u prethodnom izvođenju, a ne u ovom, zeleni za obrnuto, s preglednim ravnalom i brojem pogodaka pri prelasku mišem.
• Uređeni međuspremnici — svaka oznaka, opis i CodeLens pomiču se s tekstom dok uređujete i povlače se s prepisanog retka, gdje siva točka kaže zašto.
• Načini rada ruba uređivača — editorGutter.mode zadržava rub na nalazima (off), stavlja traku na svaki redak koji se nikad nije izvršio i jantarnu ondje gdje grana nikad nije uzeta (uncovered), ili dodaje topli ton na svaki izvršeni redak, to topliji što se češće izvršio (heatmap); Choose Editor Gutter Mode... prebacuje iz palete ili izbornika statusne trake.
• Brojevi pogodaka u retku — hitCounts.inline ispisuje ×12 iza svakog retka na kojem počinje naredba, uključujući ×0; Toggle Inline Hit Counts ga uključuje i isključuje.
• Stavke u ploči Problems po retku — problems.perLine stavlja dijagnostiku razine Information na svaki blok redaka koji se nikad nisu izvršili u otvorenom dokumentu (mrtva funkcija jedan je unos, a ne četrdeset) i po želji na svaki redak s granom koja nikad nije uzeta; unosi prate svoje retke dok uređujete.
• Bojenje redaka i karta u kliznoj traci — lineHighlight stavlja prozirnu boju iza samih redaka umjesto (ili uz) oznaku u margini, a overviewRuler sam odlučuje o crti u kliznoj traci: s isključenom marginom to je karta praznina datoteke i ništa pokraj koda.
• Koja je datoteka traga pokrila ovaj redak — kad je objedinjeno više izvještaja, opis s brojem izvođenja imenuje svaki koji je pokrio redak (uključujući naziv skupa iz lcov-ova TN:), a klik na redak datoteke traga u prikazu Coverage osvjetljava retke koje je ona doprinijela.

• Crvena, jantarna i zelena — način coverage postavki editorGutter.mode i lineHighlight boji svaki izmjereni redak bojama ljestvice boja; gumb načina u statusnoj traci i Alt+G prelaze s jednog načina na sljedeći.
• Vaše boje, s pregledom — ljestvica boja i nijanse toplinske karte (heatmap.colors, heatmap.colorsDark) su postavke, a stranica postavki prikazuje ih na svijetlom i tamnom uređivaču dok ih birate.
• Iz kojeg izvještaja dolazi datoteka — kad dva izvještaja mjere isti kod, pravila coverageFile.sources ili Choose Coverage Source for This File... odlučuju koji od njih prikazuje svaka datoteka, umjesto da pobijedi najnoviji.

Izvještavanje i povijest

• Generate Full HTML Report — samostalno generiran, višestranični izvještaj po direktoriju; Open Annotated Source za jednu datoteku.
• Neobavezna lokalna povijest izvođenja s trendom pokrivenosti (▲/▼), uz Compare Two History Runs i Compare with Last Run.
• Show Worst-Covered Files / Functions i Copy Uncovered Lines (Markdown).
• Export Fucini JSON — potpuni normalizirani model.
• Export Coverage Report... — isto izvođenje kao CSV (po datoteci ili po funkciji), Markdown sažetak, LCOV datoteka traga, Cobertura XML, SARIF, ili samostalan SVG bedž. S dvadeset pet čitača i ovim zapisivačima proširenje pretvara između formata: učitajte JaCoCo ili llvm-cov JSON i ispišite LCOV koji čitaju Codecov, Coveralls i SonarQube, ili Cobertura XML koji učitavaju Jenkins, GitLab i Azure DevOps.
• Generate Coverage Badge — SVG u stilu shieldsa zapisan ravno u radni prostor (badge.outputPath, zadano coverage-badge.svg) da ga README ugradi s ![coverage](coverage-badge.svg) i bez ikakvog udaljenog servisa; badge.metric bira retke, grane, MC/DC ili kompozitni rezultat, boja prati razine colorScale.*, a badge.autoUpdate ga iznova zapisuje nakon svakog učitavanja.

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

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

Community i Pro, značajku po značajku

Dva unosa, jedna baza koda. Community je trajno besplatna razina i ono na što Pro unos slijeće nakon 14-dnevne probe; Pro i proba su sve, bez ograničenja. Granica je povučena tako da besplatna razina uvijek vidi svaki nalaz i plaća samo udobnost, dokaz i opseg — u VS Codeu Fucini Coverage: What Community Includes prikazuje isti popis s današnjim brojačima za svako ograničenje.

Tjedan traje sedam dana od prve upotrebe koja ga je otvorila, a ništa što samo čita pokrivenost ne broji se. Niste spremni za pretplatu? 7-dnevna propusnica je sve iz desnog stupca na tjedan dana, plaćeno jednom, bez ičega što bi trebalo otkazati.

VS Code i Visual Studio usporedno

Jedan proizvod, dva uređivača, jedan čitač: isti izvještaj daje iste brojke, do znamenke, u oba. Coverage Studio za Visual Studio radi na Visual Studiju 2022 i 2026 — Community, Professional i Enterprise i ne koristi vlastitu pokrivenost koda Visual Studija, koja je u 2022 samo za Enterprise; uključen je u svaki plaćeni plan, a uređaj s oba uređivača jedno je mjesto. Sve iznad crte postoji u oba; ispod nje ono za što Visual Studio nema pandana i ono što ondje tek dolazi.

Referenca postavki

Konfigurirajte u sučelju postavki (pretražite Fucini Coverage) ili u 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.

Redak koji završava s Po mapi. prima vrijednost na razini mape u radnom prostoru s više korijena: svaka se mapa otkriva s vlastitim .vscode/settings.json ili unosom u .code-workspace, a ${workspaceFolder} u njemu znači tu mapu.

Lokalizacija

Otkrivanje i učitavanje

Ljestvica boja i oznake

Kompozitni rezultat (ponderirana harmonijska sredina)

Pragovi i sukladnost

Diff, premapiranje i izvještaji

Prikaz i analiza

Povijest

Brze radnje statusne trake

Sve zadano false osim zadnje dvije; omogućite za dodavanje odgovarajuće radnje u brzi izbornik: quickActions.compareWithLastRun, openAnnotatedSource, openAnnotatedSourceToSide, toggleAnnotatedSource, toggleWatch, worstCoveredFiles, worstCoveredFolders, worstCoveredFunctions, nextUncovered, previousUncovered, checkThresholds, copyUncoveredLines, compareHistoryRuns, exportJson, exportReport, generateBadge, showTestCoverage, chooseGutterMode, toggleInlineHitCounts.

Telemetrija

Ažuriranja

Licenciranje