包含与 --instrumentation_filter
匹配的规则目标的源文件和插桩元数据文件的相关信息,用于收集代码覆盖率数据。启用覆盖率数据收集后,系统会将包含 instrumented_files
和 metadata_files
中组合路径的清单作为输入传递给测试操作,并在环境变量 COVERAGE_MANIFEST
中记录清单的路径。元数据文件(而非源文件)也会作为输入传递给测试操作。当方面的实现函数返回 InstrumentedFilesInfo
时,系统会忽略基本规则目标中的任何 InstrumentedFilesInfo
。
成员
instrumented_files
depset InstrumentedFilesInfo.instrumented_files
File
对象的 depset
,表示此目标及其依赖项的插桩源文件。
metadata_files
depset InstrumentedFilesInfo.metadata_files
File
对象的 depset
,表示此目标及其依赖项的覆盖率元数据文件。这些文件包含在代码执行后生成 LCOV 格式覆盖率输出所需的其他信息,例如使用 -ftest-coverage
运行 gcc
时生成的 .gcno
文件。
to_json
string InstrumentedFilesInfo.to_json()
---incompatible_struct_has_no_methods
中,此功能处于停用状态。使用此标志可验证您的代码是否与即将移除的 API 兼容。根据结构体参数创建 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
中,此功能处于停用状态。使用此标志可验证您的代码是否与即将移除的 API 兼容。根据结构体参数创建文本消息。只有当所有结构体元素(递归)均为字符串、整数、布尔值、其他结构体或字典或这些类型的列表时,此方法才有效。字符串中的引号和换行符会被转义。结构体键会按排序顺序迭代。示例:
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)。