釋出¶
釋出流程應遵循以下步驟
透過執行
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 元資料。
建立 dists
python3 setup.py clean --all sdist bdist_wheel
驗證產生的檔案(位於
dist/
)是否正確。使用 twine 上傳 sdist 和 wheel
twine upload dist/*