List API¶

警告

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

class ListAPI(conan_api)¶

获取本地缓存或远程仓库中的 recipes 和 packages 的引用

latest_recipe_revision(ref: RecipeReference, remote: Remote = None)¶: 给定一个 recipe 引用，返回远程仓库中该 recipe 的最新 revision，或者在未指定 remote 时返回本地缓存中的最新 revision。如果 recipe 不存在，则返回 None。

recipe_revisions(ref: RecipeReference, remote: Remote = None)¶: 给定一个 recipe 引用，返回远程仓库中该 recipe 的所有 revisions，或者在未指定 remote 时返回本地缓存中的所有 revisions。

select(pattern: ListPattern, package_query=None, remote: Remote = None, lru=None, profile=None) → PackagesList¶

给定一个模式，返回匹配指定过滤器的 recipes 和 packages 列表。

参数:

pattern (ListPattern) – 搜索条件
package_query (str) – 在返回 packages 时，用于按条件过滤 packages 的表达式，格式为 "os=Windows AND (arch=x86 OR compiler=gcc)"。如果为 None，则在请求时返回所有 packages。
remote (Remote) – 要搜索的远程仓库，如果为 None，则搜索本地缓存。
lru (str) – 如果设置，将过滤结果，仅包含在最近 ‘lru’ 时间内使用的 packages/binaries。它可以是类似 "2d" (2 天) 或 "3h" (3 小时) 的字符串。
profile (Profile) – 用于按 settings 和 options 过滤 packages 的 profile。

explain_missing_binaries(ref, conaninfo, remotes)¶: (实验性) 解释为什么在缓存中缺少某个 binary。