Release PyPi Instruction

Instruction to release pyclustering library to PyPi repository:

1. Create release branch using the following pattern <version>.<year>.<year version>.<optional minor version>.rel, for example, 0.9.1.rel or 0.9.3.1.rel.
2. Check version in setup.py and update it if it is required.
3. Check DOI link (README.rst, PKG-INFO.rst) and update it if it is required.
4. Check description PKG-INFO.rst and update it if it is required.
5. Generate doxygen documentation and deploy it to github pages.

$ sudo apt-get install graphviz
$ sudo apt-get install texlive
$ doxygen docs/doxygen_conf_pyclustering

$ cd ../
$ mkdir pyclustering-website
$ cd pyclustering-website
$ git clone https://github.com/pyclustering/pyclustering.github.io.git .
$ cp -r ../pyclustering/doxygen_docs docs/<library_version>
$ git add docs/<library_version>/
$ git commit . -m "[docs] Upload documentation for library version <library_version>."
$ git push

6. Add core binaries to the library from cloud. For that step token is required that can be obtained by following HTTP GET request:

https://oauth.yandex.ru/authorize?response_type=token&client_id=ID_YANDEX_APPLICATION

$ python3 ci/cloud $CLOUD_TOKEN get_bin <release branch> windows x64
$ python3 ci/cloud $CLOUD_TOKEN get_bin <release branch> windows x86
$ python3 ci/cloud $CLOUD_TOKEN get_bin <release branch> macos x64
$ python3 ci/cloud $CLOUD_TOKEN get_bin <release branch> linux x64
$ python3 ci/cloud $CLOUD_TOKEN get_bin <release branch> linux x86

7. Create pypi file description:

$ touch ~/.pypirc
$ nano ~/.pypirc

8. Add following description:

[distutils]
index-servers=
    testpypi
    pypi

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

[pypi]
repository = https://upload.pypi.org/legacy/
username = <username>
password = <password>

9. Check setup file:

$ python3 setup.py check -r -s

10. Create distributive:

$ python3 setup.py sdist

11. Upload to test repository:

$ twine upload dist/* -r testpypi

12. If everything is ok on test page then upload it to legacy:

$ twine upload dist/* -r pypi