Skip to content

Instantly share code, notes, and snippets.

@skim0119
Forked from audreyfeldroy/pypi-release-checklist.md
Last active December 29, 2021 04:34
Show Gist options
  • Select an option

  • Save skim0119/1ac2051ef4610a97fc04c1f14ebc8840 to your computer and use it in GitHub Desktop.

Select an option

Save skim0119/1ac2051ef4610a97fc04c1f14ebc8840 to your computer and use it in GitHub Desktop.

Revisions

  1. skim0119 revised this gist Dec 29, 2021. 1 changed file with 42 additions and 26 deletions.
    68 changes: 42 additions & 26 deletions pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -1,37 +1,53 @@
    - [ ] Update HISTORY.md
    ## Release Checklist

    - [ ] Update RELEASE.md - It should be in based on milestone description.
    - [ ] Commit the changes:
    ```bash
    git add RELEASE.md
    git commit -m "Changelog for upcoming release <version>"
    ```
    git add HISTORY.md
    git commit -m "Changelog for upcoming release 0.1.1."
    ```
    - [ ] Final check `README` and `CONTRIBUTING`.

    ### Setup.py
    - [ ] Update version number (can also be minor or major)
    - [ ] Check if we need to upgrade `REQUIRES_PYTHON` or `REQUIRED` dependencies.
    - [ ] Update `download_url` in setup
    - [ ] Check if local installation can be done.

    ### Test
    - [ ] Run the tests
    - [ ] Run the formatting
    - [ ] CI Check
    ```
    bumpversion patch
    ```
    - [ ] Install the package again for local development, but with the new version number:
    ```
    python setup.py develop
    ```
    - [ ] Run the tests:
    python -m pytest
    make all
    ```
    tox

    ### Documentation and Website
    - [ ] Update version label on documentation
    - [ ] docs/conf.py
    - [ ] docs/documentation.rst
    - [ ] Update Sphinx
    - [ ] Update version label on website

    ```diff
    - BEYOND THIS, EACH STEP SHOULD BE DONE IN SERIAL (STEP_BY_STEPS). -
    ```
    - [ ] Submit a pull request with the history and version number changes. Have it reviewed and merged.
    - [ ] Release on PyPI by uploading both sdist and wheel:

    ### Last Edit
    - [ ] Rebase the commit history (should be done by only one person) right before the PR.

    ### Update
    1. [ ] Submit a pull request to private. Have it reviewed and merge.
    2. [ ] Push the merged branch (master/main) into the public repo.
    3. [ ] Mark the tag in a public repo. `git push --tags`
    4. [ ] Release on PyPI by uploading both sdist and wheel:
    ```
    python setup.py sdist upload
    python setup.py bdist_wheel upload
    ```

    - [ ] Test that it pip installs:
    ```
    mktmpenv
    pip install my_project
    <try out my_project>
    deactivate
    ```

    - [ ] Push: `git push`
    - [ ] Push tags: `git push --tags`
    - [ ] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [ ] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.
    ### Final Check
    - [ ] Test that it pip installs
    - [ ] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly.
    - [ ] Edit the release-page on GitHub. Paste the release notes with a title for the release.
  2. @audreyfeldroy audreyfeldroy revised this gist Dec 11, 2021. 1 changed file with 1 addition and 0 deletions.
    1 change: 1 addition & 0 deletions pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -16,6 +16,7 @@ python setup.py develop
    ```
    tox
    ```
    - [ ] Submit a pull request with the history and version number changes. Have it reviewed and merged.
    - [ ] Release on PyPI by uploading both sdist and wheel:
    ```
    python setup.py sdist upload
  3. @audreyfeldroy audreyfeldroy revised this gist Dec 11, 2021. 1 changed file with 2 additions and 2 deletions.
    4 changes: 2 additions & 2 deletions pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -1,7 +1,7 @@
    - [ ] Update HISTORY.rst
    - [ ] Update HISTORY.md
    - [ ] Commit the changes:
    ```
    git add HISTORY.rst
    git add HISTORY.md
    git commit -m "Changelog for upcoming release 0.1.1."
    ```
    - [ ] Update version number (can also be minor or major)
  4. @audreyfeldroy audreyfeldroy revised this gist Sep 18, 2015. 1 changed file with 15 additions and 39 deletions.
    54 changes: 15 additions & 39 deletions pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -1,60 +1,36 @@
    - [x] Update HISTORY.rst
    - [x] Update version number in `my_project/__init__.py`
    - [x] Update version number in `setup.py`
    - [x] Install the package again for local development, but with the new version number:
    - [ ] Update HISTORY.rst
    - [ ] Commit the changes:
    ```
    python setup.py develop
    git add HISTORY.rst
    git commit -m "Changelog for upcoming release 0.1.1."
    ```
    - [x] Run the tests:
    - [ ] Update version number (can also be minor or major)
    ```
    python setup.py test
    tox
    bumpversion patch
    ```

    - [x] Commit the changes:
    - [ ] Install the package again for local development, but with the new version number:
    ```
    git add .
    git commit -m "Release 0.1.1"
    ```

    - [x] Build the source distribution:
    ```
    python setup.py sdist
    python setup.py develop
    ```

    - [x] Test that the sdist installs:
    - [ ] Run the tests:
    ```
    mktmpenv
    cd dist
    tar xzvf my_project-0.1.1.tar.gz
    cd my_project-0.1.1/
    python setup.py install
    <try out my_project>
    deactivate
    tox
    ```

    - [x] Release on PyPI by uploading both sdist and wheel:
    - [ ] Release on PyPI by uploading both sdist and wheel:
    ```
    python setup.py sdist upload
    python setup.py bdist_wheel upload
    ```

    - [x] Test that it pip installs:
    - [ ] Test that it pip installs:
    ```
    mktmpenv
    pip install my_project
    <try out my_project>
    deactivate
    ```

    - [x] Tag the last git commit with the version number:
    ```
    git tag -a 0.1.1
    ```

    Put the same message as in HISTORY.rst.
    - [x] Push: `git push`
    - [x] Push tags: `git push --tags`
    - [x] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [ ] Push: `git push`
    - [ ] Push tags: `git push --tags`
    - [ ] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [ ] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.

  5. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -55,6 +55,6 @@ git tag -a 0.1.1
    Put the same message as in HISTORY.rst.
    - [x] Push: `git push`
    - [x] Push tags: `git push --tags`
    - [ ] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [x] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [ ] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.

  6. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -54,7 +54,7 @@ git tag -a 0.1.1

    Put the same message as in HISTORY.rst.
    - [x] Push: `git push`
    - [ ] Push tags: `git push --tags`
    - [x] Push tags: `git push --tags`
    - [ ] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [ ] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.

  7. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -53,7 +53,7 @@ git tag -a 0.1.1
    ```

    Put the same message as in HISTORY.rst.
    - [ ] Push: `git push`
    - [x] Push: `git push`
    - [ ] Push tags: `git push --tags`
    - [ ] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [ ] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.
  8. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -47,7 +47,7 @@ pip install my_project
    deactivate
    ```

    - [ ] Tag the last git commit with the version number:
    - [x] Tag the last git commit with the version number:
    ```
    git tag -a 0.1.1
    ```
  9. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -39,7 +39,7 @@ python setup.py sdist upload
    python setup.py bdist_wheel upload
    ```

    - [ ] Test that it pip installs:
    - [x] Test that it pip installs:
    ```
    mktmpenv
    pip install my_project
  10. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -33,7 +33,7 @@ python setup.py install
    deactivate
    ```

    - [ ] Release on PyPI by uploading both sdist and wheel:
    - [x] Release on PyPI by uploading both sdist and wheel:
    ```
    python setup.py sdist upload
    python setup.py bdist_wheel upload
  11. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -22,7 +22,7 @@ git commit -m "Release 0.1.1"
    python setup.py sdist
    ```

    - [ ] Test that the sdist installs:
    - [x] Test that the sdist installs:
    ```
    mktmpenv
    cd dist
  12. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -17,7 +17,7 @@ git add .
    git commit -m "Release 0.1.1"
    ```

    - [ ] Build the source distribution:
    - [x] Build the source distribution:
    ```
    python setup.py sdist
    ```
  13. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -11,7 +11,7 @@ python setup.py test
    tox
    ```

    - [ ] Commit the changes:
    - [x] Commit the changes:
    ```
    git add .
    git commit -m "Release 0.1.1"
  14. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -5,7 +5,7 @@
    ```
    python setup.py develop
    ```
    - [ ] Run the tests:
    - [x] Run the tests:
    ```
    python setup.py test
    tox
  15. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -1,7 +1,7 @@
    - [x] Update HISTORY.rst
    - [x] Update version number in `my_project/__init__.py`
    - [x] Update version number in `setup.py`
    - [ ] Install the package again for local development, but with the new version number:
    - [x] Install the package again for local development, but with the new version number:
    ```
    python setup.py develop
    ```
  16. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -1,6 +1,6 @@
    - [x] Update HISTORY.rst
    - [x] Update version number in `my_project/__init__.py`
    - [ ] Update version number in `setup.py`
    - [x] Update version number in `setup.py`
    - [ ] Install the package again for local development, but with the new version number:
    ```
    python setup.py develop
  17. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -1,5 +1,5 @@
    - [x] Update HISTORY.rst
    - [ ] Update version number in `my_project/__init__.py`
    - [x] Update version number in `my_project/__init__.py`
    - [ ] Update version number in `setup.py`
    - [ ] Install the package again for local development, but with the new version number:
    ```
  18. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -1,4 +1,4 @@
    - [ ] Update HISTORY.rst
    - [x] Update HISTORY.rst
    - [ ] Update version number in `my_project/__init__.py`
    - [ ] Update version number in `setup.py`
    - [ ] Install the package again for local development, but with the new version number:
  19. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -56,5 +56,5 @@ git tag -a 0.1.1
    - [ ] Push: `git push`
    - [ ] Push tags: `git push --tags`
    - [ ] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [x] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.
    - [ ] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.

  20. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -55,6 +55,6 @@ git tag -a 0.1.1
    Put the same message as in HISTORY.rst.
    - [ ] Push: `git push`
    - [ ] Push tags: `git push --tags`
    - [x] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [ ] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [x] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.

  21. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -54,7 +54,7 @@ git tag -a 0.1.1

    Put the same message as in HISTORY.rst.
    - [ ] Push: `git push`
    - [x] Push tags: `git push --tags`
    - [ ] Push tags: `git push --tags`
    - [x] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [x] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.

  22. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -53,7 +53,7 @@ git tag -a 0.1.1
    ```

    Put the same message as in HISTORY.rst.
    - [x] Push: `git push`
    - [ ] Push: `git push`
    - [x] Push tags: `git push --tags`
    - [x] Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.
    - [x] Edit the release on GitHub (e.g. https://github.com/audreyr/cookiecutter/releases). Paste the release notes into the release's release page, and come up with a title for the release.
  23. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -47,7 +47,7 @@ pip install my_project
    deactivate
    ```

    - [x] Tag the last git commit with the version number:
    - [ ] Tag the last git commit with the version number:
    ```
    git tag -a 0.1.1
    ```
  24. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -39,7 +39,7 @@ python setup.py sdist upload
    python setup.py bdist_wheel upload
    ```

    - [x] Test that it pip installs:
    - [ ] Test that it pip installs:
    ```
    mktmpenv
    pip install my_project
  25. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -33,7 +33,7 @@ python setup.py install
    deactivate
    ```

    - [x] Release on PyPI by uploading both sdist and wheel:
    - [ ] Release on PyPI by uploading both sdist and wheel:
    ```
    python setup.py sdist upload
    python setup.py bdist_wheel upload
  26. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -22,7 +22,7 @@ git commit -m "Release 0.1.1"
    python setup.py sdist
    ```

    - [x] Test that the sdist installs:
    - [ ] Test that the sdist installs:
    ```
    mktmpenv
    cd dist
  27. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -17,7 +17,7 @@ git add .
    git commit -m "Release 0.1.1"
    ```

    - [x] Build the source distribution:
    - [ ] Build the source distribution:
    ```
    python setup.py sdist
    ```
  28. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -11,7 +11,7 @@ python setup.py test
    tox
    ```

    - [x] Commit the changes:
    - [ ] Commit the changes:
    ```
    git add .
    git commit -m "Release 0.1.1"
  29. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -5,7 +5,7 @@
    ```
    python setup.py develop
    ```
    - [x] Run the tests:
    - [ ] Run the tests:
    ```
    python setup.py test
    tox
  30. @audreyfeldroy audreyfeldroy revised this gist Aug 22, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion pypi-release-checklist.md
    Original file line number Diff line number Diff line change
    @@ -1,7 +1,7 @@
    - [ ] Update HISTORY.rst
    - [ ] Update version number in `my_project/__init__.py`
    - [ ] Update version number in `setup.py`
    - [x] Install the package again for local development, but with the new version number:
    - [ ] Install the package again for local development, but with the new version number:
    ```
    python setup.py develop
    ```