AI CodeOps

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.

Bu şablonu kullan

İ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:

  1. Build, Builder tarafından: test dosyası ve senaryoların gerektirdiği her düzeltme.
  2. 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.
  3. 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 commandpytest -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.