Comment gérez-vous les fichiers de test de l'unité dans des projets? les ajoutes-tu en git?

SETUP

Je n'utilise pas PHP actuellement, mais je travaille avec Python Test de l'unité et Documentation Sphinx en git. Nous ajoutons nos tests à GIT et avons même certaines exigences sur le test qui passe pour pousser à la télécommande Devel maître branches ( maître plus difficile que Devel ). Cela assure un peu de qualité de code (la couverture de test doit également être évaluée, mais elle n'est pas encore mise en œuvre :)).

Nous avons le Tester des fichiers dans un répertoire séparé en regard du répertoire source de niveau supérieur dans le répertoires où ils appartiennent, préfixés avec test _ , de sorte que le cadre de test de l'unité les trouve automatiquement.

Pour la documentation Son similaire, nous venons de mettre les dossiers Documents Sphinx dans leur propre sous-répertoire (Docs), qui est dans notre cas une sous-module GIT indépendante, qui pourrait être modifiée à l'avenir.

Justification

• Nous voulons pouvoir suivre les changements dans les tests, car ils devraient être rares. Les modifications fréquentes indiquent le code immature.

• Les autres membres de l'équipe ont besoin d'un accès aux tests, sinon ils sont inutiles. S'ils changent de code dans certains endroits, ils doivent pouvoir vérifier cela ne cassent rien.

• La documentation appartient au code. En cas de python, le code contient directement la documentation. Nous devons donc la conserver à la fois ensemble, car les documents sont générés à partir du code.

• Avoir les tests et les documents du référentiel permet de tester automatisé et de la construction doc sur le serveur distant, ce qui nous donne une documentation mise à jour instantanée et des commentaires de test. De plus, la mise en œuvre de restrictions de "qualité de code" basées sur les résultats des tests fonctionne de cette façon (c'est en fait plus un rappel pour les personnes à exécuter des tests, car la qualité du code ne peut pas être vérifiée avec des tests sans regarder la couverture des tests). Les réfs sont rejetés par le serveur GIT si des tests ne passent pas.

  Nous n'exigeons par exemple que sur maître , tous les tests doivent passer ou être ignorés (malheureusement, nous avons besoin d'ignorer, car certains tests nécessitent OpenGL, qui n'est pas disponible sur l'inditoire), tandis que sur < Code> Devel C'est bon si les tests sont simplement "se comporter comme prévu" (c.-à-d. Passer, sauter ou défaillance attendue, aucun succès inattendu, erreur ou échec).