Graph 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 consumer 创建并初始化根节点
- 参数:
tested_python_requires – 要测试的
python_require
的引用lockfile – 可能有助于锁定 python-requires, build-requires
path – 所使用的 test_package/conanfile.py 的完整路径
tested_reference – 被测试包的完整 RecipeReference
profile_host –
profile_build –
update –
remotes –
- 返回:
一个 graph Node, 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 – 主机 profile
profile_build – 构建 profile
lockfile – 有效的 lockfile(默认为 None,表示未锁定)
remotes – 我们想检查的 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_ids,并评估它们是应该从源代码构建、从远程服务器下载,还是包已存在于本地 Conan 缓存中
- 参数:
lockfile –
graph – 一个 Conan 依赖关系图,由“load_graph()”返回
build_mode – 待办事项:讨论这应该是一个 BuildMode 对象还是参数列表
remotes – remotes 列表
update – (默认为 False),Conan 是否应查找 Conan 缓存中已存在的 recipe 的更新版本或修订版
build_modes_test – –build-test 参数
tested_graph – 在“test_package”的情况下,被测试的图
- static find_first_missing_binary(graph, missing=None)¶
(实验性) 给定一个依赖关系图,将返回第一个缺少二进制包的节点