Releasing Text

Release for Orange3-Text

1. Update stable and master from upstream:

   git checkout stable
   git pull upstream stable
   git checkout master
   git pull upstream master
   

2. Set IS_RELEASED = True in setup.py.

3. Build a documentation

   cd doc
   make html
   cd ..
   

4. Run

    python setup.py sdist
    python setup.py bdist_wheel
   

5. Test release with installing dist/<filename>.tar.gz:

    pip install <path to the addon>/dist/<filenam>.tar.gz
   

6. Make a release: twine upload dist/<latest tar.gz>

7. Update the changelog:

   bash scripts/create_changelog.sh
   

   and incorporate the output in the CHANGELOG.md file. Do not forget to update links a the bottom of the file.

8. Make a new tag on the Github:

   git add setup.py CHANGELOG.md
   git commit -m "Release <release number>"
   git push upstream master
   git tag <release number>
   git push upstream --tags
   

9. Update the stable branch:

   git checkout stable
   git merge <release number>
   git push upstream stable
   git checkout master
   

10. Set IS_RELEASED = False and update version (to dev) in setup.py.

11. Set setup.py to dev version:

    git add setup.py
    git commit -m "Bump version to <development version>"
    git push upstream master

12. For add-ons available at conda-forge: Make a pull request on the appropriate conda-forge repository. For Text, specifically, the bot automatically creates a PR, which you can merge as a maintainer in a few hours after the upload on PyPi.