Uruchamianie i filtrowanie testów

Aby uruchomić testy w pliku, należy wywołać kompilator w trybie testowym. Polecenie zig test kompiluje i wykonuje każdy znaleziony blok testu.

Do zig test należy przekazać główny plik źródłowy. Polecenie pobiera testy z tego pliku oraz z każdego pliku osiągniętego przez @import.

Po zakończeniu uruchamiania Zig wyświetla liczbę pomyślnie zakończonych testów. Wiersz taki jak „All 7 tests passed” oznacza, że każdy blok test zakończył się bez błędu.

W razie niepowodzenia Zig wyświetla nazwę testu, asercję, która zawiodła, oraz ślad stosu. Wybrana przez Pana/Panią name ułatwia odczytanie tych informacji.

Za pomocą --test-filter można uruchomić tylko interesujące testy. Wykonywane są wyłącznie testy, których nazwa zawiera podany tekst.

Podczas naprawiania jednej funkcji można ponownie uruchamiać tylko jej testy, dzięki czemu informacja zwrotna jest szybka. Flaga --test-filter dopasowuje fragment nazwy testu.

Aby oznaczyć test jako pominięty zamiast zakończonego niepowodzeniem, należy zwrócić z niego specjalny error.SkipZigTest. Przydaje się to w przypadku funkcji, które nie są jeszcze gotowe.

Podsumowanie zlicza pominięte testy oddzielnie od pomyślnych i nieudanych, więc skip nigdy nie ukrywa rzeczywistego problemu w zestawie testów.

W prawdziwym projekcie testy zwykle uruchamia się za pośrednictwem systemu kompilacji. Skonfigurowany krok zig build test kompiluje je i uruchamia.

Plik zawierający wyłącznie bloki test i niezawierający funkcji main nadal działa z zig test. Moduł uruchamiający testy zapewnia punkt wejścia.

Ponieważ uruchomienie testów wymaga jednego polecenia, można wykonywać je po każdej zmianie. Szybka informacja zwrotna pomaga utrzymać wiarygodność bazy kodu Zig.

Uruchamiał(a) Pan/Pani testy za pomocą zig test, odczytywał(a) podsumowanie, filtrował(a) je według nazwy, pomijał(a) za pomocą error.SkipZigTest i poznał(a) polecenie zig build test. ✅