Lua Academy · Lekcja

Pokrycie kodu i instrumentacja testów

Proszę mierzyć pokrycie testami za pomocą luacov i interpretować raporty pokrycia.

Pokrycie kodu i instrumentacja testów to bezpłatna lekcja Lua Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Lua Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Lua Academy zawiera 4 lekcji w sumie.

Czym jest pokrycie kodu?

Pokrycie kodu mierzy, które wiersze, gałęzie lub funkcje kodu są wykonywane przez testy. Wysokie pokrycie zwiększa pewność, że testy dobrze sprawdzają kod.

luacov: standardowe narzędzie

luacov to standardowe narzędzie do pomiaru pokrycia kodu Lua. Podłącza się do warstwy debug Lua i rejestruje wykonane wiersze.

-- Run with luacov:
luacov script.lua
-- Or require at the start of the test file:
require("luacov")

Używanie luacov z narzędziem uruchamiającym testy

W przypadku busted lub niestandardowego narzędzia uruchamiającego testy załaduj luacov na początku, a narzędzie automatycznie zacznie rejestrować pokrycie.

-- spec/all_spec.lua
require("luacov")
describe("my module", function()
  it("does something", function()
    local m = require("mymodule")
    assert.equals(m.add(1,2), 3)
  end)
end)

Generowanie raportu

Po zakończeniu testów luacov zapisuje plik luacov.stats.out. Uruchom luacov-reporter, aby wygenerować raport czytelny dla człowieka.

# After tests:
luacov-reporter
# Produces luacov.report.out with per-file line coverage

Odczytywanie raportu

Każdy wiersz pokazuje: liczbę trafień, liczbę pominięć i wiersz kodu źródłowego. Wiersze z 0 trafień to nieobjęty kod — potencjalnie martwy kod lub brakujące przypadki testowe.

Pokrycie gałęzi

luacov śledzi pokrycie wierszy, ale nie pokrycie gałęzi. Aby mierzyć pokrycie gałęzi, użyj bardziej zaawansowanego narzędzia lub ręcznie dodaj przypadki testowe dla każdej ścieżki if/else.

Niestandardowy hook pokrycia

Zbuduj minimalistyczny rejestrator pokrycia za pomocą debug.sethook dla zdarzeń dotyczących wierszy.

local covered = {}
debug.sethook(function(event, line)
  local info = debug.getinfo(2, "S")
  local src = info.short_src
  covered[src] = covered[src] or {}
  covered[src][line] = (covered[src][line] or 0) + 1
end, "l")
-- ... run tests ...
debug.sethook()

Progi pokrycia

Ustaw minimalny próg pokrycia w CI (np. 80%). Niepowodzeniem zakończ budowanie, jeśli pokrycie spadnie poniżej tego progu. Zapobiega to przypadkowemu narastaniu martwego kodu.

Wzorce instrumentacji testów

Oprócz pokrycia instrumentuj testy, mierząc: czas wykonania (wykrywanie wolnych testów), liczbę wywołań (sprawdzanie, czy funkcje są wywoływane oczekiwaną liczbę razy) oraz przechwytywane wartości (rejestrowanie argumentów przekazywanych do mockowanych funkcji).

Mockowanie na potrzeby izolacji testów

Zastępuj podczas testów prawdziwe moduły mockami, aby izolować jednostki. Zachowaj prawdziwą funkcję, zastąp ją stubem śledzącym, a po teście przywróć oryginał.

local realSend = http.send
local calls = {}
http.send = function(...) calls[#calls+1] = {...} end
-- run tests --
http.send = realSend  -- restore
print(#calls, "send calls")

Integracja z CI

Uruchamiaj luacov w potoku CI. Przesyłaj raporty pokrycia do Coveralls lub Codecov, aby śledzić trendy między kolejnymi commitami.

Pytanie o pokrycie kodu

Co oznacza w raporcie luacov wiersz z 0 wykonaniami?

Podsumowanie: pokrycie kodu i instrumentacja testów

Należy używać luacov do rejestrowania pokrycia linii i generowania raportów. Należy ustawić progi pokrycia w CI. W celu wyspecjalizowanego śledzenia można dodać własną instrumentację za pomocą debug.sethook. Należy używać mocków do izolowania testów jednostkowych i weryfikowania liczby wywołań.

Często zadawane pytania

Czy lekcja „Pokrycie kodu i instrumentacja testów” jest bezpłatna?

Tak — pełny tekst „Pokrycie kodu i instrumentacja testów” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Lua Academy, przejdź na CoddyKit PRO. Kurs Lua Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Pokrycie kodu i instrumentacja testów”?

Proszę mierzyć pokrycie testami za pomocą luacov i interpretować raporty pokrycia. Ćwiczysz Lua Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Lua Academy?

Nie wymagamy żadnego doświadczenia. Lua Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Pokrycie kodu i instrumentacja testów”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Lua Academy?

Tak. Każda lekcja Lua Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Lua Academy