List API

警告

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

class ListAPI(conan_api)

从缓存或远程的配方和包中获取引用

latest_recipe_revision(ref: RecipeReference, remote: Remote = None)

对于给定的配方引用,返回远程仓库中配方的最新修订版本,如果没有指定远程仓库,则返回本地缓存中的最新版本,如果配方不存在,则返回 `None`。

recipe_revisions(ref: RecipeReference, remote: Remote = None)

对于给定的配方引用,返回远程仓库中该配方的所有修订版本,如果没有指定远程仓库,则返回本地缓存中的所有修订版本。

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

对于给定的模式,返回一个匹配提供的过滤条件的配方和包的列表。

参数:
  • pattern (ListPattern) – 搜索条件

  • package_query (str) – 返回包时,使用形如 "os=Windows AND (arch=x86 OR compiler=gcc)" 的表达式来过滤包。如果为 None,则在请求时返回所有包。

  • remote (Remote) – 要搜索的远程仓库,如果为 None,则搜索本地缓存。

  • lru (str) – 如果设置,将过滤结果,只包含最近 ‘lru’ 时间内使用过的包/二进制文件。它可以是一个字符串,如 "2d" (2天) 或 "3h" (3小时)。

  • profile (Profile) – 用于按设置和选项过滤包的配置文件。

explain_missing_binaries(ref, conaninfo, remotes)

(Experimental) 解释为什么缓存中缺少某个二进制文件

find_remotes(package_list, remotes)

(Experimental) 查找当前包列表可以找到的远程仓库