◉ClassyGitShadowzzh

codecov.yml

codecov.yml
# Codecov 設定。
#
# 定位很明確:**這裡不是守門員**。真正擋 merge 的是 CI 裡的
# `cargo llvm-cov nextest --fail-under-regions 78`,那條在 runner 上跑、
# 不依賴外部服務。Codecov 給的是它給不了的東西——逐行熱區、PR 的增減量、
# 以及「這次改動碰到的行有沒有被測到」。
#
# ⚠ 刻意不設 ignore。把 main.rs、bin/export_types.rs 這種本來就測不到的檔案
#   排除掉會讓百分比好看一點,但也會讓 Codecov 的數字跟 `cargo llvm-cov` 對不起來,
#   於是每次都要先想「這個數字是哪一套算的」。兩邊算同一件事才有比較的意義。

coverage:
  # 用 region 覆蓋率當基準的理由寫在 ci.yml:line coverage 會被排版影響
  # (導入 rustfmt 時測試一個沒少,line 掉了 3pp,region 只動 0.01pp)。
  # lcov 只帶得動 line/branch,所以這裡的數字會跟 CI 的門檻略有出入——
  # 趨勢一致就夠了,絕對值以 CI 那條為準。
  status:
    project:
      backend:
        flags: [backend]
        # auto = 跟自己的 base 比。訂死一個數字的話,每次補完測試都要回來改一次,
        # 而沒改的那幾次它就變成一條假的下限。
        target: auto
        # 0.5pp 的餘裕:region/line 兩套算法本來就會有小數點的漂移,
        # 貼著 0 訂等於每隔幾次就買一個假紅。
        threshold: 0.5%
      # 前端剛從 2% 起步(單元測試長期只有 6 支)。這兩條都設成 informational:
      # 以現在的基準,任何一個「加了元件但還沒補測試」的 PR 都會讓它變紅,
      # 而每個 PR 都要略過的紅燈等於沒有門檻——只會訓練人忽略它。
      # 先讓數字被看見、追趨勢;等站穩再把 informational 拿掉、訂真的門檻。
      frontend:
        flags: [frontend]
        target: auto
        threshold: 1%
        informational: true
      # e2e 覆蓋率:203 條 e2e 走過多少 src/。跟 frontend 那個 flag 量的是**不同的東西**,
      # 不是同一個數字的兩種算法——frontend 是單元測試(分母八成是 React 元件,
      # 所以數字很低),e2e 是瀏覽器真的執行到的行。兩個要並排看。
      e2e:
        flags: [e2e]
        target: auto
        threshold: 2%
        informational: true
    patch:
      backend:
        flags: [backend]
        # 改動到的行要有八成被測到。這條比 project 有用得多:整體百分比可以
        # 靠「不動的舊檔」撐著,patch 看的是這次真的新增了多少沒測到的路徑。
        target: 80%
        threshold: 0%
      frontend:
        flags: [frontend]
        target: 60%
        threshold: 0%
        informational: true
      e2e:
        flags: [e2e]
        # e2e 量的是「走過」而不是「驗過」,patch 門檻對它意義不大——
        # 改一行元件的 render,e2e 幾乎一定會走到,數字漂亮但沒說明任何事。
        # 留 informational,看趨勢就好。
        target: 50%
        threshold: 0%
        informational: true

flags:
  backend:
    paths:
      - backend/src/
    # carryforward:某次 CI 沒跑到這個 flag 時沿用上一次的結果。
    # 兩個 flag 都要開——否則只改了前端的 PR 會讓 backend 的覆蓋率顯示成 0,
    # 看起來像「後端測試全沒了」。
    carryforward: true
  frontend:
    paths:
      - src/
    carryforward: true
  e2e:
    paths:
      - src/
    carryforward: true

comment:
  layout: 'condensed_header, diff, flags, files'
  # 沒有覆蓋率變化就不要留言。每個 PR 都貼一則「沒有變化」只會訓練人略過它。
  require_changes: true
  behavior: default