列表类

class PackagesList

配方、修订版和包的集合。

split()

返回一个 PackageList 列表，每个引用拆分为一个。这对于并行处理上传等任务非常有用，按引用进行并行处理。

only_recipes() → None

过滤掉所有包和包修订版，仅保留 self.recipes 中的配方和配方修订版。

serialize()

将实例序列化为字典。

static deserialize(data)

从序列化的字典加载数据。

class MultiPackagesList

按远程名称组织的 PackagesList 集合。

serialize()

将对象序列化为字典。

static load(file)

从指向 file 的序列化 JSON 文件路径创建类的实例。

static load_graph(graphfile, graph_recipes=None, graph_binaries=None, context=None)

从图文件路径创建类的实例，该文件是 conan graph info 或 conan create/install. 等命令返回的 JSON 格式。

参数:

  • graphfile (str) – 图文件的路径。

  • graph_recipes (list[str]) – 要返回的配方种类的列表。例如，"cache" 将仅返回本地缓存中的配方，"download" 将仅返回已下载的配方，而传递 "*" 将返回所有配方。

  • graph_binaries (list[str]) – 要返回的二进制文件种类的列表。例如，"cache" 将仅返回本地缓存中的二进制文件，"download" 将仅返回已下载的二进制文件，"build" 将仅返回已构建的二进制文件，"missing" 将仅返回缺失的二进制文件，"invalid" 将仅返回无效的二进制文件，而传递 "*" 将返回所有二进制文件。

  • context (str) – 用于过滤图的上下文，可以是 "host"、"build"、"host-only" 或 "build-only"。

class ListPattern(expression, rrev='latest', package_id=None, prev='latest', only_recipe=False)

保存匹配配方、修订版和包的模式的对象。

参数:

  • expression – 要匹配的模式，例如 "name/*:*"。

  • rrev – 要匹配的配方修订版，默认为 "latest"，也可以是 "!latest" 或 "~latest" 以匹配除最新修订版之外的所有修订版，也可以是像 "1234*" 这样的模式以匹配特定修订版，或者像 "1234" 这样的特定修订版。

  • package_id – 要匹配的包 ID，默认为 None，匹配所有包 ID。

  • prev – 要匹配的包修订版，默认为 "latest"，也可以是 "!latest" 或 "~latest" 以匹配除最新修订版之外的所有修订版，也可以是像 "1234*" 这样的模式以匹配特定修订版，或者像 "1234" 这样的特定修订版。

  • only_recipe – 如果为 True，则仅解析表达式的配方部分，忽略 package_id 和 prev。这对于仅在配方上操作的命令（如 conan search）很有用。