Wprowadzenie

Doctest to prosta, ale użyteczna metoda testowania programów w języku Python. W porównaniu z testem jednostkowym doctest nie wymaga niezależnego skryptu do pisania przypadków testowych. Przypadki testowe można po prostu zapisać w informacjach doc (zawartość w potrójnych pojedynczych / podwójnych cudzysłowach) funkcji Pythona. Następnie te przypadki mogą przetestować funkcję za pomocą doctestmodułu.

Do doctestwyszukiwania Kabiny fragmenty tekstu, które wyglądają jak interaktywnych sesji Python, a następnie wykonuje te sesje, aby upewnić się, że działają one dokładnie tak jak pokazano. ( dokument w języku Python )

Prosty przykład

Użyjmy doctest do złej abs()funkcji:

Wynik jest następujący:

Jak pokazano na powyższym przykładzie, doctest jest naprawdę wygodnym i prostym sposobem na przetestowanie funkcji.

Krótko mówiąc, są tylko 3 kroki:

• doctestmoduł importu
• zapisz przypadki testowe w potrójnych apostrofach / cudzysłowach używając
• użyj doctest.testmod()do uruchomienia doctest

Jeśli wszystkie przypadki testowe zostaną zaliczone, doctestnic nie wydrukuje.

Więcej wskazówek Doctest

1. Aby wydrukować więcej informacji

W programie doctest.testmodistnieje ważny parametr o nazwie verbose.

Jest ustawiona Falsedomyślnie, co oznacza, że ​​podczas uruchamiania testu tylko przypadki zakończone niepowodzeniem będą wyświetlać szczegółowe informacje. Jeśli chcesz uzyskać pełne informacje o wszystkich sprawach, po prostu ustaw True.

if __name__ == '__main__':
    doctest.testmod(verbose=True)

Właściwie nie musimy pisać if __name__ == '__main__':bloku. Doctest możemy uruchomić bezpośrednio w terminalu:

$ python -m doctest wrong_abs.py

$ python -m doctest -v wrong_abs.py

Czasami może być trochę bałaganu, jeśli umieścimy zarówno komentarze, jak i przypadki testowe pod funkcją. Bez obaw, możemy umieścić wszystkie przypadki testowe w niezależnym pliku i nadal doskonale działać doctest.

Na przykład, stwórzmy plik o nazwie test_cases.txti umieśćmy w nim przypadki testowe „w stylu doctest”:

Następnie uruchom doctest za pomocą tego polecenia:

python -m doctest test_cases.txt

Wniosek

Doctest to łatwa w użyciu metoda testowania programów w języku Python. Dobre wykorzystanie tej techniki może pomóc w uzyskaniu kodu wolnego od błędów.

Dziękuje za przeczytanie.

Powiązane posty:

Sześć technik debugowania dla programistów Pythona

Więcej samouczków Python:

Ostateczny samouczek Pythona (aktualizuj)