AI CodeOps

Service Python : les tests d'abord, avec un seuil de couverture en CI

Mis à jour le

Écrivez les tests pytest manquants avec Quality-Gated Change, enregistrez la couverture de pytest-cov dans le bac à sable et faites refuser par la CI toute fusion sous un seuil de 80%.

Utiliser ce template

Le code de tarification non testé, c'est de là que viennent les remboursements. Ce template demande aux agents d'écrire d'abord les tests manquants, les exécute sur le code réellement écrit et donne à votre CI un seuil de couverture à faire respecter.

Quels agents interviennent

Quality-Gated Change est le workflow de code le plus court, sans étape de planification :

  1. Build, par le Builder : le fichier de test et tout correctif que les cas exigent.
  2. Test, par le Tester : des cas nommés pour le cas nominal, les cas limites et les modes de défaillance, vérifiés par rapport aux tests écrits et à leur résultat enregistré.
  3. Review, par le Reviewer : si les tests vérifient un comportement réel ou se contentent d'exécuter des lignes.

La passe de code écrit le changement juste après Build. L'étape verify (vérification) le reconstruit dans un bac à sable, installe les dépendances, coupe le réseau et exécute votre commande de test. Test et Review s'exécutent ensuite, sur le changement écrit. Le résumé de pytest est converti en décomptes de tests réussis, en échec et ignorés, et la ligne de couverture TOTAL de pytest-cov est enregistrée comme chiffre de couverture global.

Définir la commande de test

Dans le projet, définissez :

Champ du projetExemple de valeur
Test commandpytest -q --cov=app --cov-report=term

Sans commande, AI CodeOps détecte pytest à partir de pyproject.toml, setup.cfg, pytest.ini ou tox.ini, mais exécute pytest -q sans couverture. L'exécution ne signale alors aucune couverture, et un seuil de couverture en CI refuse le changement, car il ne peut pas être vérifié. Définissez donc la commande. Chaque commande est limitée à deux minutes.

Barrières qui s'appliquent

  • Les tests en échec bloquent la pull request, et seul un résultat pour la version actuelle du changement compte.
  • Les constats high ou critical ouverts bloquent tant qu'ils ne sont pas triés.
  • Une personne autre que celle qui a lancé la session approuve, lorsque l'espace de travail compte un autre approbateur.

Appliquer le seuil en CI

La couverture n'est soumise à une barrière que lorsque votre pipeline le demande. Transmettez l'URL de la pull request et un seuil :

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\",\"minCoveragePct\":80}" \
  | jq -e '.allowed == true'

La dernière exécution de tests ayant signalé une couverture doit atteindre 80, sinon la réponse est un refus avec un coverageShortfall, par exemple « Coverage 71% is below the required 80% ». Si aucune exécution de tests du changement n'a signalé de couverture, la réponse est également un refus : « Coverage wasn't reported, so the 80% floor can't be checked ». Le seuil s'applique à ce que mesure votre commande : --cov=app soumet donc à la barrière tout le paquet, pas seulement le fichier que vous avez modifié. Le détail des champs se trouve dans la référence de la vérification de livraison.

Pour le volet dépendances du même service, consultez le template SBOM et barrière de licences.

Questions fréquentes

La barrière qualité de chaque exécution vérifie-t-elle la couverture ?

Non. Les seuils de couverture sont une option de la CI. La barrière propre à l'exécution vérifie les tests, les constats et l'approbation ; minCoveragePct ne s'applique que lorsque votre CI le demande.

Et si le bac à sable ne peut pas installer pytest-cov ?

L'étape verify enregistre qu'elle a été ignorée, avec le motif, ce qui n'est ni un échec ni une réussite. Ajoutez pytest-cov aux dépendances que votre projet installe.