Python servisi: önce testler, CI'da kapsam alt sınırıyla
Son güncelleme
Eksik pytest testlerini Quality-Gated Change ile yazın, sandbox'ta pytest-cov ile kapsamı kaydedin ve CI'ın %80 kapsam alt sınırının altında merge'i reddetmesini sağlayın.
İadeler, test edilmemiş fiyatlandırma kodundan doğar. Bu şablon ajanlardan önce eksik testleri yazmalarını ister, bunları gerçekten yazılan koda karşı çalıştırır ve CI'ınıza uygulayacağı bir kapsam alt sınırı verir.
Hangi ajanlar çalışır
Quality-Gated Change, planlama adımı olmayan en kısa kod iş akışıdır:
- Build, Builder tarafından: test dosyası ve senaryoların gerektirdiği her düzeltme.
- Test, Tester tarafından: olağan akış, uç durumlar ve hata senaryoları için adlandırılmış senaryolar; yazılan testlere ve onların kaydedilen sonucuna göre kontrol edilir.
- Review, Reviewer tarafından: testlerin gerçek davranışı doğrulayıp doğrulamadığı, yoksa yalnızca satırları çalıştırıp çalıştırmadığı.
Kod geçişi değişikliği Build'den hemen sonra yazar. Verify adımı (doğrulama) onu bir sandbox içinde yeniden oluşturur, bağımlılıkları yükler, ağı keser ve test komutunuzu çalıştırır. Test ve Review bundan sonra, yazılan değişiklik üzerinde çalışır. pytest özeti geçen, başarısız ve atlanan sayılarına ayrıştırılır; pytest-cov'un kapsam TOTAL satırı ise toplam kapsam değeri olarak kaydedilir.
Test komutunu ayarlayın
Projede şunu ayarlayın:
| Proje alanı | Örnek değer |
|---|---|
| Test command | pytest -q --cov=app --cov-report=term |
Komut yoksa AI CodeOps pytest'i pyproject.toml, setup.cfg, pytest.ini veya tox.ini dosyasından algılar, ancak pytest -q komutunu kapsam olmadan çalıştırır. Bu durumda çalıştırma kapsam bildirmez ve CI'daki bir kapsam alt sınırı, kontrol edilemediği için değişikliği reddeder. Bu yüzden komutu ayarlayın. Her komutun iki dakikalık bir sınırı vardır.
İlgili kalite kapıları
- Başarısız testler pull request'i engeller ve yalnızca değişikliğin güncel sürümü için alınan bir sonuç sayılır.
- Açık yüksek (high) veya kritik (critical) bulgular, triyajdan geçirilene kadar engeller.
- Çalışma alanında başka bir onaylayıcı varsa onay, oturumu başlatan kişiden başka birinden gelir.
Alt sınırı CI'da uygulayın
Kapsam yalnızca pipeline'ınız istediğinde kapıdan geçirilir. Pull request URL'sini ve bir alt sınır gönderin:
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'
Kapsam bildiren en son test çalıştırmasının değeri en az 80 olmalıdır; aksi hâlde yanıt bir coverageShortfall ile reddedilir, örneğin "Coverage 71% is below the required 80%". Değişiklik üzerindeki hiçbir test çalıştırması kapsam bildirmediyse yanıt yine reddedilir: "Coverage wasn't reported, so the 80% floor can't be checked". Alt sınır, komutunuz neyi ölçüyorsa ona uygulanır; dolayısıyla --cov=app yalnızca değiştirdiğiniz dosyayı değil, paketin tamamını kapıdan geçirir. Alan ayrıntıları yayın kontrolü referansındadır.
Aynı servisin bağımlılık tarafı için SBOM ve lisans kapısı şablonuna bakın.
Sık sorulan sorular
Çalıştırma başına kalite kapısı kapsamı kontrol eder mi?
Hayır. Kapsam alt sınırları bir CI seçeneğidir. Çalıştırmanın kendi kapısı testleri, bulguları ve onayı kontrol eder; minCoveragePct yalnızca CI'ınız istediğinde uygulanır.
Sandbox pytest-cov'u yükleyemezse ne olur?
Verify adımı gerekçesiyle birlikte bir atlama kaydeder; bu ne başarısızlık ne de geçti sayılır. pytest-cov'u projenizin yüklediği bağımlılıklara ekleyin.
İlgili içerikler
- Yapay zekânın yazdığı kod üzerinde çalışan kendi test paketiniz
- Kalite kapıları
- Python servisi: SBOM ve lisans kapısı
- Yapay zekânın yazdığı kodu yayına alan ekipler için yayın kontrol listesi
- Yapay zekânın yazdığı değişiklikler için pull request açıklaması şablonu
- Yapay zekâ kodlama ajanları için tehdit modeli şablonu
- Tüm şablonlar