devpi-pr 1.0.0

创建拉取请求

假设创建了一个新的功能，该功能需要在多个包中进行更改。我们目前在开发索引user/dev上工作，其中我们有两个更改的包pkg-app 1.0和app-dependency 1.2。应该最终用于生产的索引命名为prod/main。

目标索引的pull_requests_allowed选项必须为True

$ devpi index prod/main
http://example.com/prod/main:
  type=stage
  bases=root/pypi
  volatile=True
  acl_upload=root
  acl_toxresult_upload=:ANONYMOUS:
  mirror_whitelist=
  pull_requests_allowed=True

我们首先为目标创建一个新的拉取请求

$ devpi new-pr new-feature prod/main

这创建了一个新的pr索引，命名为user/new-feature。

接下来，我们将现有包从我们的开发索引推送到pr索引。

$ devpi push pkg-app==1.0 user/new-feature
$ devpi push app-dependency==1.2 user/new-feature

由于pr索引大部分像常规索引，因此也可以使用devpi upload或标准工具如twine直接将新包上传到pr索引。

为了方便起见，在首次创建时也可以列出多个包，让它们自动复制

$ devpi new-pr new-feature prod/main pkg-app==1.0 app-dependency==1.2

如果只给出包名，则使用最新版本。

之后，可以将拉取请求提交以供审查

$ devpi submit-pr new-feature

这会要求输入一个消息。

此时，pr索引的状态设置为待处理。

审查拉取请求

任何具有对目标索引的写入访问权限的用户（请参阅devpi-server中索引的acl_upload选项）现在都可以审查拉取请求。

要查看索引的当前拉取请求，请使用list-prs命令

$ devpi list-prs prod/main
pending pull requests
    user/new-feature -> prod/main at serial 123

使用review-pr命令开始审查

$ devpi review-pr new-feature

此时，可以使用pip等工具像常规索引一样使用pr索引安装新包。

审查完成后，可以接受它

$ devpi accept-pr new-feature

这又需要像submit-pr命令一样输入一个消息。

当接受拉取请求时，所有包的最新包含版本将一次性复制到目标索引。之后，pr索引会自动删除。

如果在执行review-pr命令之后，索引有任何变更，那么accept-pr命令将失败。要继续使用带-u选项的review-pr命令，需要这样做。

$ devpi review-pr -u new-feature

这可以防止意外变更被接受。在审查变更后，可以再次接受pull request。

如果需要进一步处理pull request，可以使用reject-pr命令并附带一条消息来拒绝。

$ devpi reject-pr new-feature -m "See comments in ticket #42 about a bug I found."

手动创建pr索引

也可以手动创建一个pull request。这不需要与devpi-pr一起安装devpi-client，但操作更为复杂。

首先需要创建一个新的pr索引。索引类型必须是pr，在bases、states和messages中指定目标索引。

$ devpi index -c new-feature type=pr bases=prod/main states=new messages="New pull request"

索引创建完成后，可以使用devpi upload将其上传到索引，或者使用devpi push从另一个索引推送。

最后，需要将索引的状态更新为pending，并添加状态变更消息。

$ devpi index new-feature states+=pending messages+="Please approve these updated packages"