sui-coverage

Sui Coverage to umiejętność do analizy pokrycia testami projektów Sui Move. Uruchamiasz testy ze śledzeniem pokrycia, a narzędzie automatycznie identyfikuje funkcje, które nigdy nie zostały wywołane, ścieżki asercji, które nie zostały przetestowane, oraz gałęzie warunkowe, które nie zostały pokryte. Na podstawie raportu możesz szybko napisać brakujące testy. Skill zawiera narzędzia Pythona do parsowania wyników pokrycia i generowania raportów w formacie Markdown.

1. Zainstaluj Sui CLI, uruchamiając brew install sui na macOS lub postępując zgodnie z oficjalną dokumentacją dla innych systemów. Sprawdź instalację poleceniem sui --version.

2. Przejdź do katalogu swojego projektu Move i uruchom testy ze śledzeniem pokrycia: sui move test --coverage --trace. Polecenie wygeneruje dane pokrycia dla Twojego kodu.

3. Uruchom skrypt analizy, wskazując moduł i plik wyjściowy: python3 $SKILL_DIR/analyze_source.py -m nazwa_modułu -o coverage.md. Zastąp $SKILL_DIR ścieżką do katalogu umiejętności.

4. Otwórz wygenerowany plik coverage.md i przejrzyj raport. Identyfikuje on funkcje, które nigdy nie zostały wywołane, ścieżki asercji, które nie zostały przetestowane, oraz gałęzie warunkowe bez pokrycia.

5. Dla każdej niezakrytej funkcji napisz test, który ją wywołuje. Dla ścieżek błędu asercji użyj atrybutu #[expected_failure] z odpowiednim kodem błędu, aby upewnić się, że testy sprawdzają zarówno przypadki sukcesu, jak i błędu.

6. Ponownie uruchom sui move test --coverage --trace i analyze_source.py, aby potwierdzić, że pokrycie się poprawiło i wszystkie wcześniej niezakryte ścieżki są teraz testowane.