Development Processes and Tools

Versioning

pvcaptest follows semantic versioning.

pvcaptest uses Versioneer to set the version from git tags on the master branch.

Git Workflow

The pvcaptest project follows the git workflow / branching strategy as described by the following bullets.

  • There is a single master branch from which feature branches originate.

  • There are no development or release branches.

  • Version tags are used to initiate testing and releases to pypi. So, any commit not tagged on master or any other branch is part of development.

  • Releases should be made from an upstream repository under an organization account.

  • Development work should occur on feature branch on a fork of the upstream organization repository under the contributor’s github profile.

This approach is based on the strategy described by Mark Mikofski in his blog post, Winning Workflow.

Testing

Github actions are used for continuous integration testing. All pull requests are built and tested and version tags on upstream master are built and tested and then, if passing, released to PyPI.

Release Checklist

These steps may change as this process is implemented and tested.

  • Pull from upstream master to update your local clone of your fork

  • Push to origin master to keep your local clone up up to date

  • Checkout new feature branch

  • Create test and pull request

  • Update change log

  • Complete changes in branch and ensure pull request passes tests

Maintainer will:

  • checkout master branch

  • merge release branch into master

  • tag master branch (this will trigger versioneer to update version)

  • push updates and tag to github

  • delete the release branch

Pushing a tag beginning with v from master in pvcaptest/pvcaptest will trigger the Github action publish, which will build and publish to PyPI.

git tag -a v0.X.X -m 'v0.X.X'

git push origin v0.X.X