List classes

class PackagesList

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

split()

返回一个 PackageList 列表，每个引用一个。这对于并行化上传等操作，按引用并行化处理很有用。

only_recipes() → None

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

add_ref(ref: RecipeReference) → None

将一个新的 RecipeReference 添加到包列表中

add_pref(pref: PkgReference, pkg_info: dict = None) → None

将 PkgReference 添加到包列表中的现有 RecipeReference 中

items() → Iterable[Tuple[RecipeReference, Dict[PkgReference, Dict]]]

迭代包列表的内容。

第一个字典是直接属于配方修订版的信息。第二个字典包含 PkgReference 作为键，以及包含属于该特定包引用（设置、选项等）的字典。

recipe_dict(ref: RecipeReference)

提供对包含特定 RecipeReference 信息的字典的读/写访问权限。

package_dict(pref: PkgReference)

提供对包含特定 PkgReference 信息的字典的读/写访问权限

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。