Masintõlge, mida emakeelne kõneleja pole üle vaadanud. Võrdlusallikaks on ingliskeelne versioon.

Valideerimine ja tõendidMuuda GitHubisAllikas: docs/COVERAGE.md

Ridade katvus — ametlik mõõtmine

README märgil, README CI (pidev integreerimine) tabelis, crates.io ja PyPI (Python Package Index) esilehtedel, kshana.dev ridade katvuse lehel ja tehnilises aruandes esitatud „~95 % ridade katvus“ on just see mõõtmine, ümardatud lähima täisprotsendini. tests/coverage_figure_doc_sync.rs kukub läbi, kui mõni neist kuuest kohast esitab allpool registreeritust erineva arvu, nii et järgmine uusmõõtmine liigutab neid kõiki koos või mitte ühtki.


Mõõdetud	95.35 % — 55 970 reast 58 697
Commit	`db796dd` (mootor 0.29.0, silt `v0.29.0`)
Käivita	GitHub Actions, `ci.yml` töö `coverage`, käivitus 36809850252, 2026-10-01
Tööriist	`cargo tarpaulin --engine llvm` (LLVM-i lähtekoodipõhine instrumenteerimine)
Ulatus	`src/`, välja arvatud genereeritud andmetabelid `src/*_data.rs` ja õhuke CLI (käsurea liidese) sisenemispunkt `src/main.rs`; `tests/` ja `web/` ei ole mõõdetud
Artefakt	`coverage-lcov` (`lcov.info`, 290 lähtekoodifaili), lisatud sellele käivitusele
Põrand	sama töö kukub läbi alla 85 % (`--fail-under 85`) — põrandat jõustatakse igal push-il; ülaltoodud arv on arhiivikanne, mitte värav

Käsk sõna-sõnalt failist .github/workflows/ci.yml:

cargo tarpaulin --engine llvm --out Lcov --output-dir coverage \
  --exclude-files 'src/*_data.rs' --exclude-files 'src/main.rs' \
  --exclude-files 'tests/*' --exclude-files 'web/*' \
  --timeout 3600 --fail-under 85

Re-measuring#

Iga push harusse main käivitab töö uuesti ja lisab värske faili lcov.info. Avaldatud arvu liigutamiseks laadige artefakt alla rohelisest käivitusest ja summeerige see:

gh run download <run-id> -n coverage-lcov -D /tmp/cov
awk -F: '/^LF:/{f+=$2} /^LH:/{h+=$2} END{printf "%.2f%% (%d/%d)\n", 100*h/f, h, f}' /tmp/cov/lcov.info

seejärel uuendage ülaltoodud tabelit ja need kuus kohta samas commit-is; dokumentide sünkroonitesti nimetab kõik, mille te vahele jätsite.

Ajalugu#

Arvu on uuesti mõõdetud, mitte uuesti sisse trükitud: 95,63 % commit-il b1d350d (mootor 0.27.2 + avaldamata, käivitus 35934579709, 2026-09-24, 37 697 reast 39 419, avaldatud kui ~96 %), korrigeeriti väärtusele 95,35 % versioonis 0.29.0 (ülal), mis ümardub väärtuseni ~95 %: kood kasvas 19 278 mõõdetud rea võrra ja uued read on kaetud veidi vähem kui vanad; 95,85 % versioonis v0.17.0 (commit 1daa012, 2026-06-14, avaldatud kui ~96 %) ja ~97 % kahes varasemas väljalaskemärkuses (CHANGELOG.md, jäetud ajaloona). paper/kshana-technical-report.md ütles „near 97 %“, kuni see viidi selle kirjega kooskõlla; nüüd on see kuues koht, mida test fikseerib.