Skip to content

Latest commit

 

History

History
124 lines (86 loc) · 3.23 KB

RELEASE-howto.md

File metadata and controls

124 lines (86 loc) · 3.23 KB
Raw

Howto release PyWPS

This document gives you, as PyWPS release master, a complete tutorial of how to get a PyWPS release rolled up and deployed to a target server, create packages etc.

PyWPS versioning

PyWPS uses Debian version naming system. Every policy should be checked against it.

PyWPS uses a 3 number release description: MAJOR.MINOR.MAINTENANCE. Within MAJOR releases, we should aim, not to break backwards compatibility.

Event MINOR version numbers (0, 2, 4, 6, ...) are considered as stable, where as odd numbers (1, 3, 5, 7, ...) are current development branches. MINOR releases should add new features.

The MAINTENANCE number should be used for bugfix releases only. No new features are added.

For release candidates, the MAJOR.MINOR.MAINTENANCE-rcX format should be used.

Merge develop branch

develop is the main development branch, therefore it must be merged to the master branch before a new release. Before merging, make sure, that Travis CI is indicating full successful test suite check.

To merge develop into master user following commands:

git checkout master

git merge develop

Fix files, create tags, commit, push

git commit -m"Creating new release of PYWPS X.Y.Z[-rcX] fixes" -a
  • Create tag in PyWPS main source tree
git tag X.Y.Z[-rcX]
git push
git push --tags
  • Update version in VERSION.txt and pywps/__init__.py to dev branch, e.g. 4.1-dev and push to develop:
git checkout develop
$EDITOR VERSION.txt pywps/__init__.py # add 4.1-dev version
git commit -m"Updating version to 4.1-dev"
git push

Send PyWPS to http://pypi.python.org repository (only for stable releases)

cd /tmp
git clone git@github.com:geopython/pywps.git pywps-4
cd pywps-4
git checkout X.Y.Z
python setup.py bdist_wheel upload

Fix the pywps-flask project (only for stable releases)

git checkout master

$EDITOR VERSION.txt
git commit -m"Creating new release of PYWPS X.Y.Z fixes #TICKET_NUMBER" -a
git push
  • Add tag, once pull request is accepted
git tag X.Y.Z
git push --tags

Fix web pages && write to mailing list

PyWPS [X.Y.Z]
#############

The PyWPS Development team announces the release of PyWPS X.Y.Z.

Features of this version:
 - [SHOULD COPY THIS FROM Changelog]

To download this version, please follow the link below [2].

NOTE: [IF ANY]

What is PyWPS:
--------------

PyWPS (Python Web Processing Service) is an implementation of the Web
Processing Service standard from Open Geospatial Consortium (OGC(R)). 
Processes can be written using GRASS GIS, but usage of other programs, like
R, GDAL or PROJ tools, is possible as well.

Happy GISing!

PyWPS Development team

[1] http://pywps.org
[2] http://pywps.org/download