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)

(实验性) 解释为什么缓存中缺少某个二进制文件。

find_remotes(package_list, remotes)

(实验性) 查找当前包列表可以找到的远程仓库。