conan lock merge¶
$ conan lock merge -h
usage: conan lock merge [-h] [--out-file OUT_FILE] [-v [V]] [-cc CORE_CONF]
[--lockfile LOCKFILE] [--lockfile-out LOCKFILE_OUT]
Merge 2 or more lockfiles.
options:
-h, --help show this help message and exit
--out-file OUT_FILE Write the output of the command to the specified file
instead of stdout.
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
-cc CORE_CONF, --core-conf CORE_CONF
Define core configuration, overwriting global.conf
values. E.g.: -cc core:non_interactive=True
--lockfile LOCKFILE Path to lockfile to be merged
--lockfile-out LOCKFILE_OUT
Filename of the created lockfile
conan lock merge
命令接受 2 个或更多锁文件并将其聚合,生成一个最终的锁文件。例如,如果我们有 2 个锁文件 lock1.lock
和 lock2.lock
,我们可以将两者合并到最终的 conan.lock
文件中。
# we have 2 lockfiles lock1.lock and lock2.lock
$ conan lock add --requires=pkg/1.1 --lockfile-out=lock1.lock
$ cat lock1.lock
{
"version": "0.5",
"requires": [
"pkg/1.1",
],
"build_requires": [],
"python_requires": []
}
$ conan lock add --requires=other/2.1 --build-requires=tool/3.2 --lockfile-out=lock2.lock
$ cat lock2.lock
{
"version": "0.5",
"requires": [
"other/2.1"
],
"build_requires": [
"tool/3.2"
],
"python_requires": []
}
# we can merge both
$ conan lock merge --lockfile=lock1.lock --lockfile=lock2.lock
$ cat conan.lock
{
"version": "0.5",
"requires": [
"pkg/1.1",
"other/2.1"
],
"build_requires": [
"tool/3.2"
],
"python_requires": []
}
与 conan lock add
命令类似,conan lock merge
确实保持了版本列表的严格排序
它不执行任何类型的验证,不验证包或版本是否存在,也不验证它们是否属于给定的依赖图
它只是对 JSON 文件进行基本处理,将它们聚合。
它不保证锁文件是完整的,如果不是,可能需要
--lockfile-partial
Recipe 修订版(如果已定义)必须包含时间戳才能正确排序。
警告
禁止手动操作 Conan 锁文件,更改引用的严格排序,这可能导致任何任意的未定义行为。
请记住,不可能
conan lock add
一个版本范围。版本可能不完全完整(例如未提供修订版),但它必须是一个精确的版本。
另请参阅
为了更好地理解 conan lock merge
,建议首先理解锁文件,请访问锁文件教程以获取锁文件的实用介绍。
当由于某些原因存在多个已分歧的锁文件时,此 conan lock merge
命令可用于将它们合并到单个锁文件中。一个用例是创建一个多配置锁文件,其中包含所有操作系统(Linux、Windows 等)所需的所有锁定版本,即使图中存在针对不同操作系统的条件依赖项。在某个时候测试一个新的依赖项版本时,例如 pkg/3.4
新版本,而之前 pkg/3.3
已经存在于图中时,我们可能希望生成一个新的锁文件来清除旧的 pkg/3.3
。如果我们应用 --lockfile-clean
参数,它将删除锁文件中未使用的版本,但也会删除依赖于操作系统的依赖项。因此可以这样做:假设我们有这个锁文件(简化版,为简单起见删除了修订版),作为测试我们主产品 app1/0.1
的新 pkgb/0.2
版本的G结果
{
"version": "0.5",
"requires": [
"pkgb/0.2",
"pkgb/0.1",
"pkgawin/0.1",
"pkganix/0.1",
"app1/0.1"
]
}
pkgawin
和 pkganix
分别是仅存在于 Windows 和 Linux 中的依赖项。一切看起来都很好,pkgb/0.2
新版本与我们的应用程序运行良好,我们希望从锁文件中清除未使用的内容
$ conan lock create --requires=app1/0.1 --lockfile=app.lock --lockfile-out=win.lock -s os=Windows --lockfile-clean
# Note how both pkgb/0.1 and pkganix are gone
$ cat win.lock
{
"version": "0.5",
"requires": [
"pkgb/0.2",
"pkgawin/0.1",
"app1/0.1"
]
}
$ conan lock create --requires=app1/0.1 --lockfile=app.lock --lockfile-out=nix.lock -s os=Linux --lockfile-clean
# Note how both pkgb/0.1 and pkgawin are gone
$ cat win.lock
{
"version": "0.5",
"requires": [
"pkgb/0.2",
"pkganix/0.1",
"app1/0.1"
]
}
# Finally, merge the 2 clean lockfiles, for keeping just 1 for next iteration
$ conan lock merge --lockfile=win.lock --lockfile=nix.lock --lockfile-out=final.lock
$ cat final.lock
{
"version": "0.5",
"requires": [
"pkgb/0.2",
"pkgawin/0.1",
"pkganix/0.1",
"app1/0.1"
]
}