Developer’s guide¶

Contributing¶

Drafting new releases¶

Follow these steps when drafting a new release:

Ensure that the master branch is passing the tests and that the latest version of the documentation is properly being built.
Decide whether to issue a minor or a major release following this guide.
Create and switch to a new branch named release-X.Y.
Update the release number accordingly in the VERSION file.
Update the required PyCOMPSs version in the quickstart guide if necessary.
Update the change log.
Push the release branch with the changes.
Merge the newly created branch to the master branch.
Draft a new release in Github using this template using tag name vX.Y.Z.

Create and tag a docker image for the release running the following at the repo’s root:

Create the image:

docker build -t bscwdc/Qdislib:vX.Y.Z .

# Create also new 'latest' tag using newly created image
docker tag bscwdc/Qdislib:vX.Y.Z bscwdc/Qdislib:latest

Log in and push it to dockerhub

docker login -u DOCKERHUB_USER -p DOCKERHUB_PASSWORD
docker push bscwdc/Qdislib:vX.Y.Z
docker push bscwdc/Qdislib:latest

Create a pip package and upload it to PyPi:
- Ensure that you have the latest version of setuptools, wheel, and twine installed:
```
pip3 install --upgrade setuptools wheel twine
```
- Create and upload the pip package:
```
./build.sh
python3 -m twine upload dist/Qdislib-X.Y.Z*
```