【 python】 Internal Guide for Unit Test Practice

Pour les tests unitaires,Notre principe général est：

Les tests unitaires doivent être écrits,Parce que c'est ainsi que la qualité du programme est garantie et que les bonnes habitudes sont développées,Mais ne complique pas trop les tests unitaires,Consacrer trop d'énergie à ça,Alors c'est l'inverse.

pytestUtilisation simple de

Sélection de l'outil d'essai de l'unit épytest（Cet outil etgo testUn peu comme）,Utilisation simple：

# Documentation: example.py
def func(i: int) -> int:
return i * 2
# Documentation: example_test.py
from .example import func
def test_func():
assert func(10) == 20
assert func(20) == 30

Exécuter la commande dans le même répertoirepytest,Cette commande trouve automatiquement*_test.pyDocuments（Attention!：Le répertoire actuel nécessite des fichiers__init__.py）Exécuter le cas d'essai.Apparemment, ce test d'Unit é a échoué,Les informations d'erreur sont les suivantes:：

 def test_func():
assert func(10) == 20
> assert func(20) == 30
E assert 40 == 30
E + where 40 = func(20)
doctest_example_test.py:7: AssertionError

pytest Les fichiers de test peuvent être trouvés automatiquement Récursivement ,Pendant l'utilisation, L'exécution des cas d'utilisation spécifiés est également prise en charge ：

• Spécifier le chemin du fichier de test pytest /path/to/test/file.py
• Spécifier la classe d'essai pytest /path/to/test/file.py:TestCase
• Préciser la méthode d'essai pytest another.test::TestClass::test_method
• Spécifier la fonction de test pytest /path/to/test/file.py:test_function

Plusieurs spécifications relatives aux essais unitaires

À propos des tests unitaires , Nous définissons plusieurs spécifications d'utilisation ：

1. Nous écrivons des fonctions ou des classes, etc , Pour rester testable en tout temps （ Ou un état observable ）.
2. Le nom de fichier du cas d'essai doit correspondre à ,Par exemple, le nom du fichier estfilename.py, Le nom du fichier de cas d'essai correspondant est filename_test.py.
3. Le nom de la fonction d'essai doit correspondre à , Par exemple, la fonction d'affaires s'appelle func_name, La fonction d'essai correspondante est test_func_name.
4. Le nom de la classe de test doit correspondre à , Par exemple, le nom original de la classe est ClassName, Le nom de la classe d'essai correspondante est TestClassName.
5. Il est recommandé que les fichiers de cas d'essai et les fichiers fonctionnels soient placés dans le même répertoire ,Facile à trouver, En général, il n'est pas nécessaire d'avoir un répertoire de tests distinct .

Utiliser des tests paramétriques pour optimiser les cas d'essai

Dans la pratique, Nous devrions donner la priorité à l'utilisation de tests paramétriques ：
# Le cas d'essai précédent aurait dû être optimisé pour ：
import pytest
# La partie des données ici peut être définie comme une variable
# De cette façon, il n'est pas nécessaire d'écrire plusieurs fois assertLa déclaration est
@pytest.mark.parametrize("params, expected", [([10], 20), ([20], 30)])
def test_func2(params, expected):
assert func(*params) == expected
Encore une fois,Après exécution, Le test a aussi échoué ：

 @pytest.mark.parametrize("params, expected", [([10], 20), ([20], 30)])
def test_func2(params, expected):
> assert func(*params) == expected
E assert 40 == 30
E + where 40 = func(*[20])
doctest_example_test.py:18: AssertionError

Si vous prenez çaparametrize Si la fonction est encapsulée , Ça devrait être plus facile , Par exemple, un test à l'unit é décrit simplement l'entrée et la sortie ：

# Il suffit de se concentrer sur l'écriture des cas d'essai
test_data = [
(func, [10], {}, 20),
(func, [20], {}, 30)
]
@pytest.mark.parametrize("action, args, kwargs, expected", test_data)
def test_all_func(action, args, kwargs, expected):
assert action(*args, **kwargs) == expected
Voilà., Il suffit de se concentrer sur l'écriture des cas d'essai .

20210626