exp list

别名：dvc exp ls。

列出 DVC 仓库（远程或本地）中的实验。

概要

usage: dvc exp list [-h] [-q | -v] [-A] [--rev <commit>]
                    [-n <num>] [--name-only]
                    [git_remote]

positional arguments:
  git_remote    Optional Git remote name or Git URL

描述

打印当前仓库中找到的实验列表及其所基于的分支/标签或提交。这与 dvc exp show --no-pager 类似，但仅限于实验名称，且格式极为简洁。另请参阅 dvc exp run。

如果提供了有效的 git_remote 名称（例如 origin）或 Git URL，则列出该 仓库 中的实验（如有）。

请注意，当提供 git_remote URL 时，此命令无需在现有的 DVC 项目 中运行。

默认情况下仅列出源自 HEAD 提交的实验（参见下方选项）。

选项

• --rev <commit> - 列出以指定的 <commit> 为基线的实验（默认为 HEAD）。

• -n <num>, --num <num> - 从 --rev 基线开始，列出最近 num 个提交（首个父提交）的实验。传入负值可包含所有首个父提交（类似 git log -n）。

• -A, --all-commits - 列出仓库中的所有实验（覆盖 --rev 和 --num）。

• --name-only - 仅打印实验的 名称，不显示其父 Git 提交。

• -h, --help - 显示帮助信息并退出。

• -q, --quiet - 不向标准输出写入任何内容。如果没有问题则以 0 退出，否则以 1 退出。

• -v, --verbose - 显示执行 dvc pull 命令时的详细跟踪信息。

示例

假设我们在项目中运行了 3 个实验，可通过此命令快速列出所有可用实验：

$ dvc exp list --all-commits
10-bigrams-experiment:
    60b225a [bally-gude]
    b485671 [gluey-leak]
    5f30433 [lurid-lair]

与 dvc exp show 显示的完整表格对比。

你也可以使用 dvc exp list 列出任何 DVC 仓库中的实验：

$ dvc exp list --all-commits git@github.com:iterative/example-get-started.git
10-bigrams-experiment:
    bally-gude
    conic-ease

我们可以看到（该 DVC 仓库）中有两个实验可用。

如果我们当前位于该仓库的本地克隆中，也可使用 Git 远程 名称：

$ git remote -v
origin  git@github.com:iterative/example-get-started.git
$ dvc exp list --all-commits origin
10-bigrams-experiment:
    bally-gude
    conic-ease

在此上下文中，dvc exp pull 可按需下载实验，而 dvc exp push 可上传我们希望共享的任何本地实验。