包含 --instrumentation_filter
比對的規則目標來源檔案和檢測設備中繼資料檔案的相關資訊,以便收集程式碼涵蓋率資料。啟用涵蓋率資料收集功能後,資訊清單就會包含 instrumented_files
和 metadata_files
中的組合路徑,並以輸入內容的形式傳遞至測試動作,而資訊清單的路徑會記錄在環境變數 COVERAGE_MANIFEST
中。中繼資料檔案 (而非來源檔案) 也會做為輸入內容傳遞至測試動作。當 aspect 的實作函式傳回 InstrumentedFilesInfo
時,系統會忽略基本規則目標的任何 InstrumentedFilesInfo
。
成員
instrumented_files
depset InstrumentedFilesInfo.instrumented_files
depset
的 File
物件,代表此目標及其依附元件的檢測來源檔案。metadata_files
depset InstrumentedFilesInfo.metadata_files
File
物件的 depset
,代表此目標及其依附元件的涵蓋率中繼資料檔案。這些檔案包含在程式碼執行後產生 LCOV 格式涵蓋率輸出時所需的額外資訊,例如在 gcc
搭配 -ftest-coverage
執行時產生的 .gcno
檔案。to_json
string InstrumentedFilesInfo.to_json()
---incompatible_struct_has_no_methods
會停用。使用這個標記,確認您的程式碼與即將移除的標記相容。使用結構體參數建立 JSON 字串。只有在所有結構體元素 (遞迴) 都是字串、整數、布林值、其他結構體、這些類型的清單,或是含有這些類型字串鍵和值的字典時,這個方法才有效。字串中的引號和換行符號會逸出。範例:
struct(key=123).to_json() # {"key":123} struct(key=True).to_json() # {"key":true} struct(key=[1, 2, 3]).to_json() # {"key":[1,2,3]} struct(key='text').to_json() # {"key":"text"} struct(key=struct(inner_key='text')).to_json() # {"key":{"inner_key":"text"}} struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_json() # {"key":[{"inner_key":1},{"inner_key":2}]} struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_json() # {"key":{"inner_key":{"inner_inner_key":"text"}}}
已淘汰:請改用 json.encode(x) 或 json.encode_indent(x),這兩者適用於結構體以外的值,且不會污染結構體欄位命名空間。
to_proto
string InstrumentedFilesInfo.to_proto()
---incompatible_struct_has_no_methods
會停用。使用這個標記,確認您的程式碼與即將移除的標記相容。使用結構體參數建立文字訊息。只有在所有結構體元素 (遞迴) 都是字串、整數、布林值、其他結構體或字典或這些類型的清單時,這個方法才會運作。字串中的引號和換行符號會逸出。結構體鍵會依照排序順序進行疊代。範例:
struct(key=123).to_proto() # key: 123 struct(key=True).to_proto() # key: true struct(key=[1, 2, 3]).to_proto() # key: 1 # key: 2 # key: 3 struct(key='text').to_proto() # key: "text" struct(key=struct(inner_key='text')).to_proto() # key { # inner_key: "text" # } struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_proto() # key { # inner_key: 1 # } # key { # inner_key: 2 # } struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_proto() # key { # inner_key { # inner_inner_key: "text" # } # } struct(foo={4: 3, 2: 1}).to_proto() # foo: { # key: 4 # value: 3 # } # foo: { # key: 2 # value: 1 # }
已淘汰:請改用 proto.encode_text(x)。