Tests are no good unless you run them.
You should run them every time you make a change to your code.
Do you?
(does anyone?)
It’s hard to remember to run your tests.
So give up trying.
No, really.
Instead, allow your repository to run your tests for you.
Github provides simple integration with a service called Travis CI.
Travis leverages the power of an automated build tool called Jenkins. This tool allows you to cofigure jobs that can involve pretty much all aspects of setting up software, including running tests.
You can download and install Jenkins on your own, but unless you are a development team with complex needs, it’s probably overkill to do so. Travis CI provides access to the test-running abilities of Jenkins with a minimum of fuss and difficulty.
So long as your project has tests that can be run with a command, Travis is great for you.
Let’s start with one of our early repositories, fizzbuzz.
The first step is to sign in to Travis. Luckily, you can simply sign in using the account you already have with github (no new account required!).
Once you’ve signed in, click on the docs link in the top and then click the big red Get Started button.
The steps that are outlined on that page will tell you to go to your profile page. The link there is the easiest way to do so. Click it.
When the page loads, it will contain a list of all the repositories that you have in your GitHub account. For each, there is an on/off switch. Find your fizzbuzz repository and turn it on.
Once this is done, you need to let GitHub know that you want Travis CI to have access to your repositories. You do this by enabling the Travis Commit Hook.
For this operation, you’ll need your Travis Token. You can get this from your Travis CI profile page by clickin on the Profile tab at the top of the page. Copy the token then open your GitHub repository in a new browser tab.
In GitHub, find your fizzbuzz repository and on the right side of the page find the repsitory settings (a little wrench and screwdriver icon). Click it, and then on the left side of the page, find the Webhooks & Services menu item and click that.
You want to configure a third-party service, so click on the blue Configure services button and find the Travis service in the long, alphabetical list. Click it to open the settings for Travis CI.
You can configure a number of options, but to get started, all you have to provide is your Travis Token. Paste it in the provided text box.
After you’ve pasted your token, check the ‘active’ box, then click Update settings.
Once the page reloads, you can verify that the token is right by clicking on Test Hook. If you see “Test payload deployed!” then you’re all set.
Travis CI needs to know how your tests should be run. It does this using a configuration file written in YAML.
For a Python project there are a couple of things to set up:
For our fizzbuzz project, we want to test in Python 2.7.
We’ll also need to install the lettuce package so that we can use it for our tests.
Finally, we need to provide the command to be executed in order to run our tests.
Here’s what the YAML file will look like:
language: python
python:
- "2.7"
# command to install dependencies
install: "pip install -r requirements.txt"
# command to run tests
script: lettuce
To set this up, we need to add a new file to our fizzbuzz repository with that content.
$ workon fizzbuzz
[fizzbuzz]
[master *=]
heffalump:fizzbuzz cewing$ pwd
/Users/cewing/projects/fizzbuzz
[fizzbuzz]
[master *=]
heffalump:fizzbuzz cewing$ touch .travis.yml
[fizzbuzz]
[master *=]
heffalump:fizzbuzz cewing$ subl .travis.yml
[fizzbuzz]
[master *=]
heffalump:fizzbuzz cewing$
Once you’ve entered the above content, you’re nearly there. You’ve told Travis CI what it will need to build your project and test it. But there’s still one thing missing, requirements.txt.
When you created the virtualenv for your fizzbuzz project, you installed lettuce using the pip installation tool. Pip can also be automated to a degree by providing a list of packages to install (pip install -r requirements.txt).
But what goes in that file? You installed lettuce but if you remember, there were some other packages that were automatically installed because lettuce depended on them.
Do you remember what they were?
You don’t need to.
Run the following command in your terminal, while you are in the root directory of your fizzbuzz repository and while your fizzbuzz virtualenv is active:
[fizzbuzz]
[master *=]
heffalump:fizzbuzz cewing$ pip freeze > requirements.txt
The freeze subcommand to pip will dump out a list of all the packages installed in a given environment, with the specific versions currently installed.
This is good, explicit is better than implicit. Especially when it comes to software versions. When you have a set of packages that work together properly it is always a good idea to record exactly the combination you have so that you can repeat it.
Now that you have all the pieces in place, you should be ready to roll. Add the two new files you’ve created to your fizzbuzz repository. Then commit and push them:
[fizzbuzz]
[master *+=]
heffalump:fizzbuzz cewing$ git add .travis.yml requirements.txt
[fizzbuzz]
[master +=]
heffalump:fizzbuzz cewing$ git status
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# new file: .travis.yml
# new file: requirements.txt
#
[fizzbuzz]
[master +=]
heffalump:fizzbuzz cewing$ git commit
...
[fizzbuzz]
[master>]
heffalump:fizzbuzz cewing$ git push origin master
Counting objects: 10, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (6/6), done.
Writing objects: 100% (6/6), 670 bytes | 0 bytes/s, done.
Total 6 (delta 2), reused 0 (delta 0)
To git@github.com:cewing/fizzbuzz.git
68482be..3e3d283 master -> master
[fizzbuzz]
[master=]
heffalump:fizzbuzz cewing$
If all is well, you should be able to look at the main page in Travis CI and see your tests start, run and pass.
Now that you’ve got CI running, and you have your tests passing, let the world know about it.
Add a bit to your README.md that displays the test results badge from Travis CI:
[](https://api.travis-ci.org/<you>/<yourproject>)
And that’s it.
For your assignment outside of class, repeat this process for your data-structures repository.
The more often you repeat a process like this, the better you will get at doing it. From now on, make sure to do it for each repository you create.