Ajoute un guide sur les tests backend

[Arnaud-D]

Ajoute un guide sur les tests backend. Le guide ne traite volontairement que de l'utilisation basique des tests existants. Cela permet de couvrir les cas d'utilisation basiques, comme par exemple vérifier en local qu'une petite modification ne casse pas tout.

Je pense que des conseils plus orientés sur l'écriture de tests pour ZdS auront plus leur place dans un autre guide.

Contrôle qualité

• Générer la doc
• Vérifier que le rendu et les liens sont corrects
• Jeter un œil à l'orthographe.

[coveralls]

Coverage remained the same at 86.621% when pulling bebdec9 on Arnaud-D:guide_backend_tests into ecd07ca on zestedesavoir:dev.

[Situphen]

Je pense que tu as oublié quelques petites choses dans les commandes à lancer. Voici ce qu'il y a dans le Makefile actuellement :

test-back: clean-back zmd-start ## Run backend unit tests
	python manage.py test --settings zds.settings.test --exclude-tag=front
	make zmd-stop

test-back-selenium: ## Run backend Selenium tests
	xvfb-run --server-args="-screen 0 1280x720x8" python manage.py test --settings zds.settings.test --tag=front

Il faut donc préciser la nécessité de lancer zmarkdown avant de lancer les tests. Il manque le --settings zds.settings.test pour que certains tests fonctionnent correctement. Je ne sais pas si on doit parler de --exclude-tag=front.

[Arnaud-D]

Merci pour ton retour.

J'ai :

• ajouté une instruction pour lancer zmd,
• ajouté l'argument pour les settings,
• décidé de ne pas mentionner le exclude-tags.

Pour le exlude-tags, je préfère me passer de cette subtilité dans un guide qui vise essentiellement à apprendre en deux minutes comment se dépatouiller avec les tests en local. D'ailleurs, on s'en sert très peu dans le code (deux fois si j'ai bien compté).

[philippemilink]

Quelques suggestion d'améliorations. Je rajouterais en plus:

• suggérer le TDD ?
• dire qu'une PR qui touche au code Python nécessite un test back (ça peut aussi permettre d'éclaircir le terme backend)

Ces points auraient sans doute leur place dans l'introduction du guide.

[Arnaud-D]

suggérer le TDD ?

Non, car l'objet de ce guide est simplement d'apprendre à lancer les tests quand on dév, pas d'en rajouter ou de les modifier, ça c'est l'autre guide. On s'adresse à des gens qui savent à peine se débrouiller avec Django ou la doc d'outils en général, tout ce que je dis là est en vérité dans la doc officielle !

dire qu'une PR qui touche au code Python nécessite un test back (ça peut aussi permettre d'éclaircir le terme backend)

Idem, c'est plus pour l'autre guide et le modèle de PR le rappelle aussi.