PUBLISH.md

To publish new version

PyPI

This is to upload source to pypi. To upload linux wheel binaries, see manylinux.

1. Increment the version number in rerf/__init__.py

2. Create a ~/.pypirc file with the following content:

   [distutils]
   index-servers =
     neurodata
     neurodata-test
   
   [neurodata]
   repository=https://upload.pypi.org/legacy/
   username=xxxx
   password=xxxx
   
   [neurodata-test]
   repository=https://test.pypi.org/legacy/
   username=xxxx
   password=xxxx

3. Update packaging dependencies

   pip install --upgrade setuptools wheel
   pip install --upgrade twine

4. Test upload on test.pypi.org (only source)

   python setup.py sdist
   twine upload --repository neurodata-test dist/*

5. Test pip installable from test.pypi.org

   pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple rerf==0.0.3.dev2

6. Create dist files

   1. On Linux, only upload source

      python setup.py sdist

   2. On OSX include wheels

      python setup.py sdist bdist_wheel

7. If successful, upload version to PyPi

   twine upload --repository neurodata dist/*

8. Test pip installable

   pip install rerf -U

9. Create new release on GitHub (tag)

Docker

cd docker
docker build -t neurodata/rerf .
docker push neurodata/rerf