图 API

警告

此功能处于实验阶段，可能会发生重大更改。有关更多信息，请参阅Conan 稳定性部分。

class GraphAPI(conan_api)

load_root_test_conanfile(path, tested_reference, profile_host, profile_build, update=None, remotes=None, lockfile=None, tested_python_requires=None)

从 test_package/conanfile.py 消费者创建一个并初始化根节点

参数：

• tested_python_requires – 要测试的python_require的引用

• lockfile – 可能有助于锁定 python-requires 和 build-requires

• path – 正在使用的 test_package/conanfile.py 的完整路径

• tested_reference – 被测试包的完整 RecipeReference

• profile_host –

• profile_build –

• update –

• remotes –

返回值：

一个图节点，recipe=RECIPE_CONSUMER

load_graph(root_node, profile_host, profile_build, lockfile=None, remotes=None, update=None, check_update=False)

计算依赖关系图，从根包开始，使用 profile_build 和 profile_host 中提供的配置评估图。生成的图是配方的图，但包尚未计算（package_ids）在结果中将为空。结果可能存在错误，例如版本或配置冲突，但仍然可以检查它。只有尝试安装此类图才会失败

参数：

• root_node – 起点，一个已初始化的节点结构，由“load_root_node” api 返回

• profile_host – 主机配置文件

• profile_build – 构建配置文件

• lockfile – 有效的 lockfile（默认为 None，表示未锁定）

• remotes – 我们要检查的远程列表

• update – （默认为 False），如果 Conan 应该查找 Conan 缓存中已存在配方的更新版本或修订版

• check_update – 对于“graph info”命令，检查是否存在配方更新

analyze_binaries(graph, build_mode=None, remotes=None, update=None, lockfile=None, build_modes_test=None, tested_graph=None)

给定一个依赖关系图，将计算图中所有配方的 package_ids，并评估它们是否应该从源代码构建、从远程服务器下载，或者包是否已存在于本地 Conan 缓存中

参数：

• lockfile –

• graph – 由“load_graph()”返回的 Conan 依赖关系图

• build_mode – TODO：讨论这是否应该是一个 BuildMode 对象或参数列表

• remotes – 远程列表

• update – （默认为 False），如果 Conan 应该查找 Conan 缓存中已存在配方的更新版本或修订版

• build_modes_test – –build-test 参数

• tested_graph – 在“test_package”的情况下，正在测试的图