Moim zdaniem same przypadki testów jednostkowych służą jako dokumentacja kodu. Moja firma chce, żebym napisał szczegółowe komentarze w dokumentacji Java na górnej części przypadków testów jednostkowych. Czy to konieczne? Czy piszesz takie komentarze?
unit-testing
documentation
Vinoth Kumar CM
źródło
źródło
Odpowiedzi:
To, co robię, to komentarz JAVADOC:
klasa wskazująca, która klasa jest testowana jednostkowo (nawet jeśli powinno to być oczywiste, ponieważ najlepsza praktyka na ten temat sugeruje, że nazwą przypadku testowego powinna być nazwa klasy + „Test” lub + „TestCase”). Odbywa się to za pomocą komentarza JAVADOC {@link XXXClass}
metody wskazujące, która metoda jest testowana ({@link XXXClass # method1}). Czasami muszę mieć wiele metod testowych dla jednej metody klasy, aby poprawnie przetestować wszystkie ścieżki. Kiedy to się dzieje, piszę jedną dodatkową linię, podając ścieżkę, którą testuję w środku (ale nigdy nie zbaczam z mojej konwencji jednowierszowej)
Poza tym nie ma innego komentarza. Aby zwrócić ich uwagę gdzie indziej, możesz użyć czegoś takiego jak Cobertura, aby wygenerować ładną grafikę pokrycia kodu i uszczęśliwić ich w ten sposób :-)
Uwaga dodatkowa: mam na myśli przypadki testów jednostkowych, jeśli mówimy o przypadkach testów integracyjnych, to jeden lub dwa kolejne wiersze wyjaśniające, co się dzieje, mogą być rzeczywiście konieczne ...
źródło
Wymagania dotyczące dokumentacji dla dowolnego kodu są dość całkowicie uwzględnione w odpowiedziach na to pytanie: Mój szef chce opowiadanego po angielsku wyjaśnienia naszego kodu po angielsku
Jako podsumowanie odpowiedzi zobaczysz tam: „To zależy od twojej sytuacji”. Są przypadki, w których jest to uzasadnione (i zachęcane), a inne są stratą czasu.
źródło
Komentarze Javadoc można wyodrębnić i sformatować w osobnym dokumencie referencyjnym, testy jednostkowe nie. Pamiętaj również, że to, co piszesz słowami, może różnić się od rzeczywistego kodu i zazwyczaj opisujesz słowami rzeczywiste oczekiwane zachowanie. Jednym ze sposobów znajdowania błędów jest porównanie dokumentacji z rzeczywistym kodem, jeśli się nie zgadzają - jest to błąd (w jednym z nich, a czasem - w obu).
Test jednostkowy służy do testowania, a nie do dokumentacji. Używanie testu jednostkowego, ponieważ dokumentacja jest błędna i nie powinna być wykonywana.
źródło