Automate PYPI wheels & Read The Docs with Travis

[wearpants]

ok @abadger i gave you collab access here & on pypi

[abadger]

Okay, PR #75 will let travis push to pypi. There's some information in the PR about finishing up the work (it's currently pushing to testpypi.org so that we can check it the first time to make sure it's doing what we want.) We should also create the twiggy-uploader user in the real pypi infrastructure and use that to upload there when we're ready. That way we won't lose either of our accounts passwords if there's a compromise of travis.

[abadger]

For setting up readthedocs I'll need to have access to admin the readthedocs twiggy project. You should be able to grant that to me on readthedocs once you've logged in: https://readthedocs.org/dashboard/twiggy/users/

[abadger]

TODO:

• Add the twiggy-uploader password to the .travis.yml file:
  • lwGo2bGY8NHj96K+l0jzUiJX2+ZUs/DACwZt94VXKmOTOeqU1sPOBunh4ajSGUJCo2KSG17QasiHEBNPQKnA3DjKm76v4DdpNKwHxzsENyy2B4QicJa/qur3OzpY0ozW0oei0Nj7oFydrfFZoY6NBrt0ox4bjJcQHoj+S4XmNKk=
• Add the readthedocs webhook to github: https://docs.readthedocs.io/en/latest/webhooks.html#github

Release procedure:

• Make final changes for the release
• git push
• Check that the commit passes in travis
• git tag $RELEASE
• git push --tags

Goal:

Once git push --tags is performed above:

PyPi:

Status: Pypi is being tested. The next release to be built should push to test.pypi.org. We should review it and if it looks correct we can update to use the real pypi.org credentials and url.

• travis should push to pypi once the tags are pushed.

Readthedocs

Status: Read the doc is now working as outlined here

• readthedocs will build docs for a versioned URL:
  • http://pubmarine.readthedocs.io/en/0.4.3/
• Readthedocs will then point the following URL to the same content as at the versioned URL:
  • http://pubmarine.readthedocs.io/en/stable/

Readthedocs will also rebuild docs whenever new commits are pushed to the master branch. These builds will end up at:

• http://twiggy.readthedocs.io/en/latest/

Going to http://twiggy.readthedocs.io/ will redirect to http://twiggy.readthedocs.io/en/stable/