NOTES.md

How to prepare a release

Prepare the pypi config file ~/.pypirc:

[distutils]
index-servers =
  pypi
  pypitest

[pypi]
repository=https://pypi.python.org/pypi
username=<user>
password=<password>

[pypitest]
repository=https://test.pypi.org/legacy/
username=<user>
password=<password>

Note: the user name and password are open text, so it is wise to change permissions:

chmod 600 ~/.pypirc

Release Steps

1. Update ChangeLog
2. Make sure git clone is clean
3. Update the cdmcfparserversion.py file with the new version:

version = '2.0.0'

4. Make sure pandoc is installed as well as pypandoc
5. Run

python setup.py sdist

6. Make sure that tar.gz in the dist directory has all the required files
7. Upload to pypitest

python setup.py sdist upload -r pypitest

8. Make sure it looks all right at pypitest
9. Install it from pypitest

pip install --index-url https://test.pypi.org/simple/ cdmcfparser

10. Check the installed version

cd ~/cdm-flowparser/tests
./ut.py
cd ~/cdm-flowparser/utils
./speed_test.py

11. Uninstall the pypitest version

pip uninstall cdmcfparser

12. Upload to pypy

python setup.py sdist upload

13. Make sure it looks all right at pypi
14. Install it from pypi

pip install cdmcfparser

15. Check the installed version

cd ~/cdm-flowparser/tests
./ut.py
cd ~/cdm-flowparser/utils
./speed_test.py

16. Create an annotated tag

git tag -a 2.0.0 -m "Release 2.0.0"
git push --tags

17. Publish the release on github at releases

Development

# Install a develop version (create links)
python setup.py develop

# Uninstall the develop version
python setup.py develop --uninstall

Links

Peter Downs instructions

Ewen Cheslack-Postava instructions