AI CodeOps

Kapsam alt sınırı (coverage floor)

Son güncelleme

Kapsam alt sınırı, bir değişikliğin yayına alınabileceği en düşük test kapsamıdır. Ekiplerin onu nasıl belirlediği, tuzakları ve AI CodeOps CI kontrolünde minCoveragePct'nin nasıl çalıştığı.

Kapsam alt sınırı, bir kod tabanının veya değişikliğin bir kalite kontrolünden geçmek için ulaşması gereken asgari test kapsamı yüzdesidir. Ölçülen kapsam alt sınırın altındaysa kontrol başarısız olur.

Nedir

Kapsam araçları, testlerin kodun ne kadarını çalıştırdığını genellikle satırların, ifadelerin (statement) veya dalların yüzdesi olarak ölçer. Bir alt sınır bu sayı için bir asgari değer belirler; örneğin %80 satır kapsamı. Çalıştırma bunun altında kalırsa bir CI adımı başarısız olur. Bazı ekipler alt sınırı projenin tamamına, bazıları ise yalnızca bir değişikliğin dokunduğu satırlara uygular.

Bir alt sınır, testlerin herhangi bir şeyi kontrol edip etmediğini değil, testler sırasında ne kadar kodun çalıştığını ölçer. Hiç doğrulama (assertion) içermeyen bir test de kapsamı artırır.

Neden önemlidir

Kimse izlemediğinde kapsam düşme eğilimindedir; bir alt sınır bu düşüşü durdurur. En çok bir cırcır (ratchet) olarak işe yarar: onu bugünkü sayıya yakın belirleyin ve kapsam iyileştikçe yükseltin. Yapay zekânın yazdığı değişikliklerde, oturumun testleri kodun yerine değil, kodla birlikte yazdığına dair ucuz bir sinyaldir.

AI CodeOps'ta

Kapsam alt sınırı, CI'ınızın çağırdığı yayın kontrolünün (POST /api/release/check) minCoveragePct seçeneğidir:

{ "pullRequestURL": "https://github.com/acme/checkout/pull/42", "minCoveragePct": 80 }

Bir oturum testlerinizi kendi sandbox'ında çalıştırdığında AI CodeOps, çıktı bir özet taşıyorsa kapsam değerini test çıktısından ayrıştırır: bir pytest-cov TOTAL satırı, bir Istanbul All files satırı (Jest, Vitest; ilk sütun, yani ifadeler) veya coverage: 85.3% gibi etiketli bir satır. Değeri, aşağı yuvarlanmış bir tam sayı olarak test çalıştırmasıyla birlikte saklar.

minCoveragePct ayarlıyken kapsam raporlayan en son test çalıştırması bu değeri karşılamalıdır. Bir eksiklik yayını reddeder:

{
  "allowed": false,
  "reasons": ["Coverage 71% is below the required 80%"],
  "coverageShortfall": { "coveragePct": 71, "required": 80 },
  "coverageNotReported": null
}

İki ayrıntı önemlidir:

  • Kapsam raporlanmadıysa geçiş yok. Değişiklik üzerindeki hiçbir test çalıştırması kapsam raporlamadıysa alt sınır kontrol edilemez; bu yüzden yayın reddedilir: "Coverage wasn't reported, so the 80% floor can't be checked". Bu durumda yanıt "coverageNotReported": { "required": 80 } alanını taşır. Bir alt sınır belirlemeden önce projenizin test komutunun bir kapsam özeti yazdırmasını sağlayın; örneğin pytest --cov veya vitest run --coverage.
  • Yalnızca CI. Konsoldaki kalite kapısı başarısız testleri engeller ancak kapsamı kontrol etmez ve Release gate sayfasında kapsam alanı yoktur. Alt sınırı API çağrısında belirleyin.

Başarısız testler ayrı bir kontroldür: başarısız bir test veya sıfırdan farklı bir çıkış kodu içeren kaydedilmiş herhangi bir test çalıştırması, kapsam ne olursa olsun yayını reddeder. Seçeneklerin tam listesi API sayfasında, testlerin nasıl çalıştığı ise test sayfasındadır.

Sık sorulan sorular

Kapsam raporlanmadığında AI CodeOps değişikliği reddeder mi?

Evet, bir alt sınır belirlediyseniz. minCoveragePct ayarlıyken, kapsam raporlayan en son test çalıştırmasının bu sınırı karşılaması gerekir. Hiçbiri kapsam raporlamadıysa alt sınır kontrol edilemediği için kontrol reddeder.

Kapsam alt sınırı varsayılan olarak açık mıdır?

Hayır. Yalnızca CI'ınız yayın kontrolüne minCoveragePct değerini gönderdiğinde uygulanır. Konsoldaki oturum başına kapı kapsamı kontrol etmez.

AI CodeOps hangi kapsam değerini kullanır?

Test çıktısı bir özet taşıdığında, örneğin bir pytest-cov TOTAL satırı veya bir Istanbul All files satırı (onun ifadeler sütunu) olduğunda, buradan okunan toplam kapsam değerini.