root

返回到 DVC 项目 根目录的相对路径。

概要

usage: dvc root [-h] [-q | -v]

描述

返回相对于当前工作目录的 DVC 项目 根目录路径。dvc root 在子目录中工作时，可用于引用其他目录中的文件。

使用此命令可构建指向依赖项、文件或阶段 输出 的固定路径。在以编程方式生成 dvc.yaml 文件或使用 dvc stage add 辅助命令时非常有用。

选项

• -h, --help - 打印使用说明/帮助信息，然后退出。

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

• -v, --verbose - 显示详细的跟踪信息。

示例

基本演示：

$ dvc root
.

$ mkdir subdir
$ cd subdir
$ dvc root
..

示例：在其他命令中引用固定路径

当在 DVC 项目 的子目录中工作时，通过将所有路径设为相对于根目录来简化文件引用。

$ dvc root
../../../

$ dvc stage add -d $(dvc root)/data/file.cvs ... \
      python $(dvc root)/scripts/something.py

同样的方法也可应用于非 DVC 命令：

$ dvc root
../..

$ tree $(dvc root)/data/
../../data/
├── data.xml
├── data.xml.dvc
...