在 GitHub 上编辑

version

显示 DVC 版本以及环境和项目信息。

概要

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

描述

dvc version 输出有关系统/环境的以下信息:

详细信息
DVC 版本DVC 的版本,以及用于安装 DVC 的二进制文件或包管理器名称(如 pipconda 等),如果是开发版本,则还会包含 Git 提交哈希
平台DVC 所在环境中 Python 的版本,以及操作系统相关信息
支持的功能当前 DVC 配置所支持的 远程存储 类型(其所需的依赖项已安装)
缓存类型支持的 链接类型(工作区 workspace 与缓存 cache 之间)
缓存目录缓存 cache 目录所在磁盘的文件系统类型(例如 ext4、FAT 等)和驱动器信息
远程配置仓库中配置的远程 位置类型(例如 SSH、S3、Google Drive 等)
工作区目录工作区 workspace 所在磁盘的文件系统类型(例如 ext4、FAT 等)和驱动器信息
仓库显示当前是否处于 DVC 仓库和/或 Git 仓库中

如果在 DVC 项目之外使用 dvc version,则不会打印有关 CacheWorkspace directory 的信息。

请注意,如果你使用 pip 安装 DVC,则需要手动运行 pip install psutil 安装 psutil,才能使 dvc version 显示文件系统信息。更多信息请参见 GitHub 上的原始 issue

DVC 版本组成

DVC 版本的具体信息取决于 DVC 的安装方式。

  • 正式发布版:DVC 的稳定版本(例如 1.10.0),可通过 安装存储在 Python Packaging Authority 中的官方包或使用二进制文件进行安装。这些版本在 DVC 仓库中有对应标签(参见 changelog 查看发布历史)。

    如果官方构建版本报告了问题,可以使用官方版本号进行追踪。

  • 开发版本:包含 DVC 仓库 master 分支在最新正式发布之后的所有更改。可以通过克隆 DVC 仓库后进行 安装。由于该版本可能包含尚未准备发布的更改,因此使用时可能会遇到问题。

    使用开发版本报告的任何错误,都可以通过 dvc version 输出中的 Git 提交哈希进行追踪,例如:1.10.0+292cab.mod。加号 + 前的部分是官方版本号,之后的部分是 master 分支顶端的提交哈希。.mod 这个可选后缀表示代码已被修改。

  • 二进制文件或包管理器:显示 DVC 是如何下载并 安装 的。

    DVC 可以通过以下二进制发行版之一进行安装:

    • Debian 包(.deb)——用于在多个 Linux 发行版(如 Ubuntu)中安装软件包的文件
    • Red Hat 包(.rpm)——用于在某些基于 Linux 的发行版(如 Fedora、CentOS 等)中安装软件包的文件
    • PKG 文件(.pkg)——用于在 macOS 上安装应用程序的文件
    • Windows 可执行文件(.exe)——用于在 Windows 上安装应用程序的文件

    这些下载资源可从我们的主页获取。它们最终包含一个二进制包,即软件应用程序的可执行文件,这意味着它将在特定平台(Linux、Windows、macOS)上原生运行。

    我们使用PyInstaller将源代码打包成二进制程序包。

    DVC 也可以通过包管理器进行下载和安装:

    这种安装方式需要先下载 DVC 的源代码,并按照一定的设置说明(参见开发指南)构建应用程序后才能使用。

选项

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

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

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

示例

获取 DVC 版本和环境信息:

在 DVC 项目内部:

$ dvc version

DVC version: 1.10.0 (pip)
---------------------------------
Platform: Python 3.8.3 on Linux-5.4.0-47-generic-x86_64-with-debian-buster-sid
Supports: gs, hdfs, http, https, s3
Cache types: hardlink, symlink
Cache directory: ext4 on /dev/sda1
Caches: local
Remotes: https, s3, ssh
Workspace directory: ext4 on /dev/sda1
Repo: dvc, git

在 DVC 项目外部:

$ dvc version

DVC version: 1.10.0 (pip)
---------------------------------
Platform: Python 3.8.3 on Linux-5.4.0-47-generic-x86_64-with-debian-buster-sid
Supports: All remotes
内容

🐛 发现问题?告诉我们!或者修复它:

在 GitHub 上编辑

有疑问?加入我们的聊天,我们会为您提供帮助:

Discord 聊天