警告
此功能是实验性的,可能会发生重大更改。有关更多信息,请参阅 Conan 稳定性 部分。
conan.tools.sbom¶
CycloneDX¶
CycloneDX 工具可在 conan.tools.sbom 模块中使用。
它提供了 cyclonedx_1_4 和 cyclonedx_1_6 函数,它们接收一个 conanfile 并以 CycloneDX 1.4/1.6 JSON 格式返回包含 SBOM 数据的字典。
- cyclonedx_1_4(conanfile, name=None, add_build=False, add_tests=False, **kwargs)¶
(实验性) 使用 JSON 格式生成 cyclone 1.4 SBOM
从给定的依赖图中创建 CycloneDX 1.4 软件物料清单 (SBOM)。
- 参数
conanfile: conanfile 实例。 name (str, optional): 元数据字段的自定义名称。 add_build (bool, optional, default=False): 包含构建依赖项。 add_tests (bool, optional, default=False): 包含测试依赖项。
- 返回值
生成的 CycloneDX 1.4 文档,格式为字符串。
示例用法:
` cyclonedx_1_4(conanfile, name="custom_name", add_build=True, add_test=True, **kwargs) `
- cyclonedx_1_6(conanfile, name=None, add_build=False, add_tests=False, **kwargs)¶
(实验性) 使用 JSON 格式生成 cyclone 1.6 SBOM
从给定的依赖图中创建 CycloneDX 1.6 软件物料清单 (SBOM)。
- 参数
conanfile: conanfile 实例。 name (str, optional): 元数据字段的自定义名称。 add_build (bool, optional, default=False): 包含构建依赖项。 add_tests (bool, optional, default=False): 包含测试依赖项。
- 返回值
生成的 CycloneDX 1.6 文档,格式为字符串。
示例用法:
` cyclonedx_1_6(conanfile, name="custom_name", add_build=True, add_test=True, **kwargs) `
这两个函数共享相同的接口,并且非常相似;主要区别在于它们支持的 CycloneDX 版本。 add_build 和 add_test 选项允许您分别包含图解析的构建和测试包。
请记住,如果您希望将其中任何一项添加到您的 SBOM 中,请启用相应选项!
另请参阅