INSTRUCTIONS FOR RELEASE
========================


Requirements:
-------------

1. Github account
2. PYPI account
3. pip, wheel and twine must be installed


Github:
-------
A. Chose an appropriate name for your plugin 
   (something like isbnlib-XXX, where XXX is the new provider),
   and rename the folder with the source code like isbnlib_XXX
   (please note the difference '-' vs '_')

B. Check: 
   1. setup.py 
   2. tox.ini
   3. .travis.yaml 
   and see if version, names and paths are the correct ones for your case!

C. Tag and push to github:
   1. Edit CHANGES.txt and add version, date and small description (e.g. v0.0.1, 2018-03-08 -- Initial alpha release.)
   2. git tag -a vVERSION -m "small description" (e.g. git tag -a v0.0.1 -m "Initial alpha release")
   3. git push origin master
   4. git push origin v0.0.1 (adapt!)



PYPI:
-----

Prepare packages and upload to pypi:
1. python setup.py check -s
2. python setup.py sdist bdist_wheel
3. twine check dist/*
4. twine upload dist/* -u UN -p PW  (UN, PW are the credentials of your PYPI account)

