rafe: 环境可复现工件

rafe是一个用于检查Python环境和以可复现方式构建包（无论语言）的工具。

构建

要从源代码创建新的rafe wheel，只需运行

python setup.py bdist_wheel

然后wheel应可在dist/文件夹中找到。

安装

要安装rafe，只需pip安装wheel

pip install <wheel>

使用方法

在开始使用rafe之前，需要生成配置。通过运行以下命令来完成此操作：

rafe config --init

现在，您可以按需使用rafe。请注意，您可以通过两种方式调用它：

• python -m rafe
• rafe

两者都有效。

Griffe API 检查的工作流程

假设您已经运行了 rafe config --init，您将拥有文件夹 .rafe/work/ - 将您的 Git 仓库文件夹放在那里，这样 numpy 就会在 .rafe/work/numpy/

放好后，接下来应该运行

python rafe check-api-breaks --package numpy --old v1.12.1 --new v1.17.5`

在旧的 griffe 版本中，如果您遇到 Git 分支错误，您需要清理 griffe 创建的分支后再重新运行。例如，从适当的文件夹执行 git branch -D griffe_v1.12.1。已验证，这不再是 griffe v0.30.1（最后一个支持 py3.7）的问题。

运行上述命令后，您应该可以使用以下命令运行验证步骤（针对已删除的对象）

python rafe verify-breaks --package numpy --path ./numpy_objects_removed.json`

这将尝试为每个丢失的项目执行一个 hasattr()，如果它失败，它可能会尝试导入丢失的属性并再次尝试。生成的 numpy_actual_misses.json 应该更接近真实情况。