Making a release

A core developer should use the following steps to create a release X.Y.Z of scikit-build on PyPI.

Prerequisites

• All CI tests are passing on AppVeyor, CircleCI and Travis CI.
• You have a GPG signing key.

Documentation conventions

The commands reported below should be evaluated in the same terminal session.

Commands to evaluate starts with a dollar sign. For example:

$ echo "Hello"
Hello

means that echo "Hello" should be copied and evaluated in the terminal.

Setting up environment

1. First, register for an account on PyPI.

2. If not already the case, ask to be added as a Package Index Maintainer.

3. Create a ~/.pypirc file with your login credentials:

   [distutils]
   index-servers =
     pypi
     pypitest
   
   [pypi]
   username=<your-username>
   password=<your-password>
   
   [pypitest]
   repository=https://test.pypi.org/legacy/
   username=<your-username>
   password=<your-password>
   

where <your-username> and <your-password> correspond to your PyPI account.

PyPI: Step-by-step

1. Make sure that all CI tests are passing on AppVeyor, CircleCI and Travis CI.
2. Download the latest sources

$ cd /tmp && \
  git clone git@github.com:scikit-build/scikit-build && \
  cd scikit-build

3. List all tags sorted by version

$ git fetch --tags && \
  git tag -l | sort -V

4. Choose the next release version number

$ release=X.Y.Z

Warning

To ensure the packages are uploaded on PyPI, tags must match this regular expression: ^[0-9]+(\.[0-9]+)*(\.post[0-9]+)?$.

5. In README.rst, update PyPI download count after running this big table query and commit the changes.

$ git add README.rst && \
  git commit -m "README: Update download stats [ci skip]"

Note

To learn more about pypi-stats, see How to get PyPI download statistics.

6. In CHANGES.rst replace Next Release section header with Scikit-build X.Y.Z and commit the changes.

$ git add CHANGES.rst && \
  git commit -m "Scikit-build ${release}"

7. Tag the release

$ git tag --sign -m "Scikit-build ${release}" ${release} master

Warning

We recommend using a GPG signing key to sign the tag.

8. Create the source distribution and wheel

$ python setup.py sdist bdist_wheel

9. Publish the both release tag and the master branch

$ git push origin ${release} && \
  git push origin master

10. Upload the distributions on PyPI

twine upload dist/*

Note

To first upload on TestPyPI , do the following:

$ twine upload -r pypitest dist/*

11. Create a clean testing environment to test the installation

$ pushd $(mktemp -d) && \
  mkvirtualenv scikit-build-${release}-install-test && \
  pip install scikit-build && \
  python -c "import skbuild"

Note

If the mkvirtualenv command is not available, this means you do not have virtualenvwrapper installed, in that case, you could either install it or directly use virtualenv or venv.

To install from TestPyPI, do the following:

$ pip install -i https://test.pypi.org/simple scikit-build

12. Cleanup

$ popd && \
  deactivate  && \
  rm -rf dist/* && \
  rmvirtualenv scikit-build-${release}-install-test

13. Add a Next Release section back in CHANGES.rst, commit and push local changes.

$ git add CHANGES.rst && \
  git commit -m "CHANGES.rst: Add \"Next Release\" section [ci skip]" && \
  git push origin master