For Maintainers¶
The gwf build, testing and deployment process is automated through Travis.
Merging Changes¶
Make sure that the changes have proper test coverage, e.g. by checking the branch on Coveralls.
Check that the PR includes necessary updates of
CHANGELOG.rst
andCONTRIBUTORS.rst
.Always make a merge commit (don’t rebase/fast-forward). The merge commit will be referenced in the change log.
Add the change to the change log for the coming (draft) release on GitHub. Make sure to follow the formatting used in previous change logs. Also, read about how to keep a change log.
Rolling a New Release¶
Make sure that all changes for the new release have been merged into
master
and that tests pass. Check the CI output.Make any other release-related changes such as adding new contributors to
CONTRIBUTORS.rst
or adding missing items toCHANGELOG.rst
.Increase the version number in
gwf/__init__.py
Commit the changes and push the branch. Wait for tests to run.
Make a new release by tagging the merge commit with the version number, e.g.
vX.X.X
. Push the tag and wait for Travis to catch up.Run
make package
, thenmake publish
to publish the source distribution and wheel to PyPI.
The documentation will be automatically be built.