diff --git a/pypi-build-upload.md b/pypi-build-upload.md new file mode 100644 index 0000000..cda8cae --- /dev/null +++ b/pypi-build-upload.md @@ -0,0 +1,49 @@ +## Instructions for building and uploading FoBiS.py to PyPi + +### Prepare before build + +In `release` branch, bump verion number in `src/main/python/fobis/FoBiSConfig.py`, e.g. `__version__ = "3.0.6"`. +Commit the file changed. + +### Build + +In repo root type + +```bash +pyb +``` + +This creates a `release/FoBiS-release-v3.0.6/` directory, build the package and test it. + +If `pyb` is not installed, install it via pip + +```bash +pip install pybuilder +``` + +### Upload the package to PyPi + +Enter release directory, prepare the package distribution and upload it: + +```bash +cd release/FoBiS-release-v3.0.6/ +python setup.py sdist +twine upload dist/* +``` + +After a successful upload, a message like the following is printed: + +```bash +Uploading distributions to https://upload.pypi.org/legacy/ +Uploading FoBiS.py-3.0.6.tar.gz +100% ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 54.4/54.4 kB • 00:00 • 142.4 MB/s + +View at: +https://pypi.org/project/FoBiS.py/3.0.6/ +``` + +If `twine` is not installed, install it via pip + +```bash +pip install twine +``` diff --git a/src/main/python/fobis/FoBiSConfig.py b/src/main/python/fobis/FoBiSConfig.py index 39fa6be..38ce5ee 100644 --- a/src/main/python/fobis/FoBiSConfig.py +++ b/src/main/python/fobis/FoBiSConfig.py @@ -39,7 +39,7 @@ from .utils import syswork __appname__ = "FoBiS.py" -__version__ = "3.0.5" +__version__ = "3.0.6" __author__ = "Stefano Zaghi" __author_email__ = "stefano.zaghi@gmail.com" __license__ = "GNU General Public License v3 (GPLv3)"