Skip to content

Releasing Ibis

Phillip Cloud edited this page Aug 14, 2019 · 9 revisions

Ibis is released in two places:

  • PyPI (the PYthon Package Index), to enable pip install ibis-framework
  • Conda Forge, to enable conda install ibis-framework

Prepare the Release

  1. Generate release notes using dev/ $NEXT_VERSION and add the output to docs/source/release.rst immediately above the current release's :release: line.
  2. Make a pull request with these changes.

Tag a Commit and Push

  1. git tag $NEXT_VERSION; $NEXT_VERSION should be replaced with the next semantic version. This tag should correspond to the commit just merged from the release notes generation.
  2. git push --tags upstream master; upstream should point to

PyPI Release

  1. Install twine and wheel
  2. Inside of an ibis clone, run python sdist bdist_wheel.
    1. This creates a source distribution as well as a wheel inside of $PWD/dist.
  3. Run twine upload dist/*
    1. This uploads packages to PyPI. This step cannot be undone.

The twine upload takes action immediately and users can now pip install the latest version of ibis.

Conda Forge Release

  1. Install conda-smithy.
  2. Run git clone
  3. cd into the clone.
  4. Update recipe/meta.yaml with the sha256 of the release.
    1. You can compute the new sha256 using:
      curl -SLqs$NEXT_VERSION.tar.gz | sha256sum | cut -f1 -d' '
  5. Set the build number to 0.
  6. If any new hard dependencies have been added, add those to the requirements in the recipe.
  7. Run conda smithy rerender. Follow the instructions provided, if any.
  8. Make a pull request to

Conda packages should be installable shortly after the pull request is merged.

Clone this wiki locally
You can’t perform that action at this time.