sphinx_to_gh_pages.sh

#!/bin/bash
# http://redsymbol.net/articles/unofficial-bash-strict-mode/
set -euo pipefail
IFS=$'\n\t'

buildDirectory=/tmp/_build

# get a clean master branch assuming
git checkout master
git pull origin master
git clean -df
git checkout -- .
git fetch --all

# build html docs from sphinx files
sphinx-apidoc -o . .
sphinx-build -b html . "$buildDirectory"

# create or use orphaned gh-pages branch
branch_name=gh-pages
if [ $(git branch --list "$branch_name") ]
then
	git clean  -d  -fx .
	git checkout $branch_name
	git pull origin $branch_name
	#git stash apply
#	git checkout stash -- . # force git stash to overwrite added files
else
	git checkout --orphan "$branch_name"
fi

if [ -d "$buildDirectory" ]
then
	ls | grep -v _build | xargs rm -r
	mv "$buildDirectory"/* . && rm -rf _build
	git add .
	git commit -m "new pages version $(date)"
	git push origin $branch_name
else
	echo "directory $buildDirectory does not exists"
fi