tomaz/appledoc — pull request #371 by paulmelnikow (2013-07-13 15:38:53+00:00)
Title: Set up Travis-CI

I set up appledoc to work with Travis-CI, a continuous integration platform for open-source projects. It will automatically build and run tests on the active branches, and on each pull request. It integrates well with Github. It's a great starting point for avoiding regressions.

I've tested this on my fork, but there are a few steps to get this running on the main repository (the order is important):

1. Sign in to Travis CI using GitHub OAuth. Go to [Travis CI](http://travis-ci.org/) and follow the Sign In link at the top. GitHub will ask you to grant read and write access. Travis CI needs write access for setting up service hooks for your repositories when you request it, but it won't touch anything else.
2. Once you're signed in go to your [profile page](https://travis-ci.org/profile). You'll see a list of your repositories. Flip the on/off switch for appledoc.
3. Merge this pull request. The git push will trigger the first build.

More info on this commit:

- .travis.yml contains the instructions to Travis, which is to install xctool and then invoke rake.
- Rake sets an environment variable GHUNIT_CLI and builds the tests.
- The Run Script action I added to the target will run the tests as part of the build action, but only when that environment variable is set.

If you have rake installed, you can also run the tests locally by running `rake` from the project directory.