Graph API

警告

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

class GraphAPI(conan_api, helpers)

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 中提供的配置评估图。结果图是 recipe 的图，但包尚未计算（package_ids 将在结果中为空）。结果可能包含错误，例如版本或配置冲突，但仍然可以检查它。只有尝试安装这样的图才会失败

参数:

• root_node – 起点，一个已经初始化的 Node 结构，如 "load_root_node" API 返回的那样

• profile_host – host profile

• profile_build – build profile

• lockfile – 一个有效的 lockfile (默认 None，表示未锁定)

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

• update – (默认为 False)，如果 Conan 应该查找 Conan 缓存中已存在 recipe 的新版本或修订版

• check_update – 对于 "graph info" 命令，检查是否有 recipe 更新

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

给定一个依赖图，将计算图中所有 recipe 的 package_id，并评估它们应该从源码构建、从远程服务器下载，还是这些包已存在于本地 Conan 缓存中

参数:

• lockfile –

• graph – 一个 Conan 依赖图，如 "load_graph()" 返回的那样

• build_mode – TODO: 讨论这应该是 BuildMode 对象还是参数列表

• remotes – 远程列表

• update – (默认为 False)，如果 Conan 应该查找 Conan 缓存中已存在 recipe 的新版本或修订版

• build_modes_test – --build-test 参数

• tested_graph – 如果是 "test_package"，则是正在测试的图

static find_first_missing_binary(graph, missing=None)

(实验性) 给定一个依赖图，将返回第一个缺少二进制包的节点