jupyterlab-pullrequests

一个用于审查拉取请求的JupyterLab扩展。

目前，它支持GitHub和GitLab提供者。

先决条件

• JupyterLab 3.x
  • 对于JupyterLab 2.x，请参阅2.x分支
• jupyterlab-git >=0.30.0

对于GitLab，您还需要diff-match-patch

用法

• 从左侧面板的选项卡打开拉取请求扩展

安装

1. 按以下步骤安装扩展

使用pip

pip install jupyterlab-pullrequests

或使用conda

conda install -c conda-forge jupyterlab-pullrequests

对于GitLab，您还需要

pip install diff-match-patch

或使用conda

conda install -c conda-forge diff-match-patch

2. 获取您的访问令牌

对于GitHub，文档在这里。令牌范围必须是repo。

对于GitLab，文档在这里。令牌范围必须是api。

请记住，此令牌实际上是您账户的密码。 请不要 在线分享或将其存入版本控制，因为他人可以使用它来访问您的所有数据。

3. 在 JupyterLab 拉取请求中设置访问令牌

现在您需要将提供者获得的凭证添加到服务器配置文件中。生成配置文件的说明可以在这里找到。一旦确定此文件，请添加以下行

c.PRConfig.access_token = '<YOUR_ACCESS_TOKEN>'

其中 "<YOUR_ACCESS_TOKEN>" 是您上面获得的一串字符串。

如果您使用的是 GitLab 而不是 GitHub，您还需要设置提供者

c.PRConfig.provider = 'gitlab'

恭喜，您做到了！启动 JupyterLab 并在左侧查找拉取请求标签！ 🎉

如果您不在 GitHub.com 或 GitLab.com 上，您可以使用可配置参数 PRConfig.api_base_url 设置提供者的 API 基础 URL。

设置

此扩展作为服务器设置。

• PRConfig.access_token：提供者需要验证的访问令牌
• PRConfig.provider：github（默认）或 gitlab
• PRConfig.api_base_url：提供者 API 基础 URL（默认为 https://api.github.com，除非提供者是 gitlab，则默认为 https://gitlab.com/api/v4/）

故障排除

• 如果您看到以下错误 [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self signed certificate in certificate chain，并且证书已安装到您的机器上，您需要设置 SSL_CERT_FILE 环境变量以指向您的系统证书包。例如

export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt

开发

贡献

如果您想为该项目做出贡献，请阅读我们的贡献者文档。

JupyterLab 遵循官方的Jupyter 行为准则。