build-release.ps1

# This script assumes that the 'release' branch is actually ready for release.
# That includes merging in all relevant changes for the release (in particular
# the 'development' branch), and adding a new entry to CHANGELOG.txt. The latter
# is very important as the target version will be read from that file.
# You do NOT need to build the documentation yet. This script takes care of
# that.
# Note that this script does NOT merge the updated 'release' branch back into
# 'development'. If you need the documentation, CHANGELOG or other commits on
# 'release' in 'development', you'll need to do that extra merge manually.
# We recommend that you use git's credential cache or an SSH agent so you don't
# have to enter your credentials several times during the script.

################################################################################

# Make the project root directory the working directory (regardless of where the
# script has been called from).

$scriptPath = $MyInvocation.MyCommand.Path
$dir = Split-Path $scriptPath
Push-Location $dir

# Read current branch

$branch = git status | Select-String -Pattern "On branch (.*)" -List `
    | %{$_.matches[0].groups[1].value}

git checkout release

# Read version

$version = Select-String -Pattern "Version\s+([\d\w.-]+)" -List .\CHANGELOG.txt `
    | %{$_.matches[0].groups[1].value}

# Build and commit documentation

phpdoc -d src/FACTFinder -t docs --template clean --sourcecode
git add --all docs
git commit -m "Update documentation for release $version"
git push origin release

# Prepare and push master branch

git checkout master
git merge --no-ff --log release
git push origin master

# Prepare and push src-only branch

git subtree split --prefix=src --onto=src-only --branch=src-only
git push origin src-only

# Create release tags

git tag $version
git tag $version+src src-only

git push --tags origin

# Move back to original branch

git checkout $branch

Pop-Location