釋出

釋出流程應遵循以下步驟

  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. 建立 dists

    python3 setup.py clean --all sdist bdist_wheel
    
  10. 驗證產生的檔案(位於 dist/)是否正確。

  11. 使用 twine 上傳 sdist 和 wheel

    twine upload dist/*