发布¶
发布流程应遵循以下步骤
通过运行
tox -e docs
测试文档是否构建和渲染正常。如果有错误的拼写问题,请将单词添加到
spelling_wordlist.txt
中。更新
CHANGELOG.rst
和AUTHORS.rst
以保持最新。通过运行
bumpversion [ major | minor | patch ]
提升版本。这将自动添加一个标签。使用以下命令推送更改和标签:
git push git push --tags
等待 GitHub Actions 给出绿色构建。
检查 ReadTheDocs 上的文档是否已构建。
确保您有一个干净的检出,运行
git status
进行验证。手动清理临时文件(这些文件被忽略,不会显示在
git status
中)rm -rf dist build src/*.egg-info
需要删除这些文件以强制 distutils/setuptools 重新构建所有内容并重新创建 egg-info 元数据。
构建发行版
python3 setup.py clean --all sdist bdist_wheel
验证生成的归档文件(位于
dist/
中)是否良好。使用 twine 上传 sdist 和 wheel
twine upload dist/*