发布

发布流程应遵循以下步骤

  1. 通过运行 tox -e docs 测试文档是否构建和渲染正常。

    如果有错误的拼写问题,请将单词添加到 spelling_wordlist.txt 中。

  2. 更新 CHANGELOG.rstAUTHORS.rst 以保持最新。

  3. 通过运行 bumpversion [ major | minor | patch ] 提升版本。这将自动添加一个标签。

  4. 使用以下命令推送更改和标签:

    git push
    git push --tags
    
  5. 等待 GitHub Actions 给出绿色构建。

  6. 检查 ReadTheDocs 上的文档是否已构建。

  7. 确保您有一个干净的检出,运行 git status 进行验证。

  8. 手动清理临时文件(这些文件被忽略,不会显示在 git status 中)

    rm -rf dist build src/*.egg-info
    

    需要删除这些文件以强制 distutils/setuptools 重新构建所有内容并重新创建 egg-info 元数据。

  9. 构建发行版

    python3 setup.py clean --all sdist bdist_wheel
    
  10. 验证生成的归档文件(位于 dist/ 中)是否良好。

  11. 使用 twine 上传 sdist 和 wheel

    twine upload dist/*