InstrumentedFilesInfo

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6
包含與 --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

depset 的 File 物件，代表這個目標及其依附元件的涵蓋範圍中繼資料檔案。這些檔案包含程式碼執行後產生 LCOV 格式涵蓋率輸出內容所需的額外資訊，例如執行 gcc 時以 -ftest-coverage 產生的 .gcno 檔案。

to_json

string InstrumentedFilesInfo.to_json()

已淘汰。這項 API 已淘汰，並將在近期內移除。因此請勿依賴這項功能。使用 ---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()

已淘汰。這項 API 已淘汰，並將在近期內移除。因此請勿依賴這項功能。使用 ---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)。