fetchdep

概述

fetchdep实用程序为开发者提供了一个简单的方法来获取在容器路径下运行的软件项目的依赖项。如果项目根目录中包含fetchdep配置，则用户可以通过调用fetchdep自动下载与项目工作路径并行的源代码。这对于可能没有包管理功能的 projekty 可能很有用。

支持以下版本控制系统：CVS、Git、Mercurial、SVN。

要求

• Python 2.7或3.5+
• PyYAML
• (可选) CVS
• (可选) Git
• (可选) Mercurial
• (可选) SVN

安装

此工具可以使用pip进行安装

pip install fetchdep
 (or)
python -m pip install fetchdep

用法

可以使用命令行调用此工具

fetchdep --help
 (or)
python -m fetchdep --help

示例

假设项目已克隆到以下路径

└── ~/workdir
    └── my-awesome-project/
        └── fetchdep.yml

如果用户在项目目录内工作并调用fetchdep

$ cd workdir/my-awesome-project
$ fetchdep

这可以自动将依赖项与项目一起克隆，如下所示：

└── ~/workdir
    ├── my-awesome-library-a/
    |   └── ...
    ├── my-awesome-library-b/
    |   └── ...
    ├── my-awesome-library-c/
    |   └── ...
    └── my-awesome-project/
        └── fetchdep.yml

配置

fetchdep配置文件可以命名为以下之一：

• fetchdep.yml
• .fetchdep.yml
• .fetchdep

配置文件是YAML定义的配置。每个配置都应该有一个根fetchdep列表，其中包含一个或多个要获取的依赖项。例如

fetchdep:
  # cvs
  - name: my-module-a
    site: :pserver:anonymous@cvs.example.org:/cvsroot/my-module-a my-module-a
  # git
  - name: my-module-b
    site: https://example.com/myteam/my-module-b.git
  # hg
  - name: my-module-c
    site: hg+https://www.example.org/repo/my-module-c
  # svn
  - name: my-module-d
    site: svn+https://svn.code.example.com/c/myteam/my-module-d/trunk

• 每个条目必须有一个name，该名称将被用于检出源代码的文件夹名称。
• 每个条目还必须有一个site，用于定义要获取的源类型。接受的站点前缀包括cvs+、git+、hg+和svn+。尽管如此，如果这个工具可以确定正在获取哪种类型的源，则某些站点可以省略前缀。

功能

标签

此工具支持带标签的依赖项。项目可以为项目定义一个或多个标签。例如

fetchdep:
  - name: my-test-module
    site: https://example.com/myteam/my-test-module.git
    tags:
      - test

默认情况下，如果用户不使用其他参数调用fetchdep，则上面所示的my-test-module模块将不会获取。要包括具有分配标签的源，必须在命令行中添加标签。

fetchdep --tag test

可以通过重复使用--tag参数添加多个标签。用户还可以使用--all-tags参数获取每个依赖项。

递归

fetchdep工具将仅获取当前项目定义的依赖项。如果项目依赖项定义了自己的fetchdep配置，则默认情况下不会获取额外的依赖项。

为了支持下载项目依赖项的依赖项，可以使用--recursive选项

fetchdep --recursive

获取过多的项目可能会导致fetchdep提示继续。这可以通过使用-y参数来覆盖。

模拟运行

用户始终可以使用--dry-run参数来检查将要获取哪些依赖项，而无需调用获取操作。