Skip to content

Latest commit

 

History

History
83 lines (51 loc) · 2.38 KB

RELEASING.md

File metadata and controls

83 lines (51 loc) · 2.38 KB
Raw

  1. Make sure to have an environment set up with hatch installed. See CONTRIBUTING.md. Remove any existing environments managed by hatch so that it will create new ones with the latest dependencies when executing the commands further below:

    hatch env prune

  2. Make certain your branch is in sync with head. If you work on a fork, replace origin with upstream:

    git pull origin main

  3. Do a clean doc build:

    hatch run doc:clean-all
hatch run doc:build-html
hatch run doc:serve

    Navigate to http://localhost:8000 and ensure it looks OK (particularly do a visual scan of the gallery thumbnails).

  4. Create a new release branch:

    git switch -c version_5.0.0

  5. Update version to, e.g. 5.0.0:

    • in altair/__init__.py
    • in doc/conf.py

  6. Commit changes and push:

    git add . -u
git commit -m "chore: Bump version to 5.0.0"
git push

  7. Merge release branch into main, make sure that all required checks pass

  8. Tag the release:

    git tag -a v5.0.0 -m "version 5.0.0 release"
git push origin v5.0.0

  9. On main, build source & wheel distributions. If you work on a fork, replace origin with upstream:

    git switch main
git pull origin main
hatch clean  # clean old builds & distributions
hatch build  # create a source distribution and universal wheel

  10. publish to PyPI (Requires correct PyPI owner permissions):

    hatch publish

  11. build and publish docs (Requires write-access to altair-viz/altair-viz.github.io):

    hatch run doc:publish-clean-build

  12. On main, tag the release. If you work on a fork, replace origin with upstream:

    git tag -a v5.0.0 -m "Version 5.0.0 release"
git push origin v5.0.0

  13. Create a new branch:

    git switch -c maint_5.1.0dev

  14. Update version and add 'dev' suffix, e.g. 5.1.0dev:

    • in altair/__init__.py
    • in doc/conf.py

  15. Commit changes and push:

    git add . -u
git commit -m "chore: Bump version to 5.1.0dev"
git push

  16. Merge maintenance branch into main

  17. Double-check that a conda-forge pull request is generated from the updated pip package by the conda-forge bot (may take up to several hours): https://github.com/conda-forge/altair-feedstock/pulls

  18. Publish a new release in https://github.com/vega/altair/releases/