Andrew Wilkinson

Random Ramblings on Programming

Continuous Integration Testing

with 7 comments

rom whence the brick came by mythotoAt work we recently set up Buildbot to replace an in-house continuous integration tool that never really took off. I’ve used Buildbot before, in a hobby capacity, but using it my day job has really brought home to me how important not only testing is, but testing continuously.

Buildbot is pretty simple to explain. Every time you make a commit to your source control system this triggers buildbot to run a series of steps over your code. What these steps are is totally configurable by you. Typically though, you’ll configure it to check out your code, compile it and run unit tests.

I’m a big fan of test driven and issue driven development. With these two methodologies when you want to make a change you record the issue in your bug tracking software, then write a test that detects the deficiency in your code. Once you’ve done that you can start actually making the change that you wanted to make in the first place. By writing down the issue you’re forced into thinking about the change that you want to make, and creating the test ensures that you know when it’s complete.

TDD and IDD are useful things to aim for, but in reality you’ll probably fall short sometimes. Not everything can be unit tested easily, or you might be under significant time pressures that force you to cut corners. One of the projects I manage has a test suite that takes 25 minutes to run. If I’m getting phone calls urging me to fix a problem as soon as possible then I can’t wait for the tests to run before I commit the change.

Because builtbot runs without user intervention you don’t need to remember to do anything. Buildbot is also a nag. If you introduce a bug with a change you quickly get an email letting you know that there is a problem, and if you set those emails up to go to your team then you also have peer pressure to get that problem fixed.

I spend most of my time building Django based sites. For these sites I set up six steps for Buildbot to follow. The first step is the checkout step, then a step to copy a settings file into place. Django stores settings in a Python file and these settings need to be configured for each server that the site is run on. I typically have a file settings_local.py.buildbot stored in the repository and this step copies this file to settings_local.py so the following commands will run with the correct settings. The next step is to download and install the dependencies of the site. I’m going to go into more detail on how I manage settings and dependencies in a future post, but Buildbot just runs the correct commands.

The first three steps that Buildbot runs are just configuration steps. The first of the real test is a simple compilation step. It’s rare that a change gets committed without it ever being run, but it’s still worthwhile to check that the code compiles. It is possible that when merging changes from different branches errors can creep in. Fortunately Python makes it easy to check that all the files in a directory structure compile using the compileall module. This can be run using the command python -m compileall -q which return an exit code of zero if all the files compile, and nonzero if there is an error. This means that if there is an error Buildbot will detect it, and mark the build as failed.

The next step I run is the unit tests. This where the bulk of the testing occurs. I’m not going to go into details on how to write unit tests, but assuming you have them this assures you that your tests pass after every commit. Because Buildbot can be easily configured to build on several different machines on each commit you can easily test that a change you made on a Python 2.5 machine also works on a Python 2.4 machine.

The final step I run is PyLint. PyLint checks that your code complies with a set of coding standards and simple checks. If your unit tests don’t have a 100% coverage (and frankly, whose does?) then PyLint will hep detect that there are no obvious flaws in your code. PyLint takes a bit of time to configure, especially as it doesn’t like some of the metaclass magic that Django uses, but once you have a configuration file written PyLint is an excellent final check.

Hopefully this has given you a flavour of what Buildbot can do for you, and if you’re in a team or are building a cross-platform piece of software then Buildbot really needs to be there, watching your back.

Photo of from whence the brick came by mythoto.

Advertisements

Written by Andrew Wilkinson

June 30, 2010 at 2:16 pm

Posted in deployment

Tagged with , , ,

7 Responses

Subscribe to comments with RSS.

  1. Out of curiosity, why buildbot? I’ve used it myself, but found it a bit overly complex unless I really needed it’s features (the critical one I view running builds across various platforms).

    Not baggin’ on it – just curious why you chose it.

    Joe

    July 4, 2010 at 12:18 am

  2. Hi Joe,

    I’m a Python developer so although I think you’re right, the Buildbot configuration file is complicated, I’m quite at home with them as they’re just Python files.

    I find it simplest to use one tool that covers everything I might want to do, rather than using several for similar but different sized tasks. I find that buildbot scales very well from a simple one branch single platform build up to many branches on many platforms.

    Cheers,
    Andrew

    Andrew Wilkinson

    July 7, 2010 at 1:03 pm

  3. Hi Joe,

    Good article – I’m going to give Buildbot a try myself. I’ve been looking for a CI server for a while that fits my needs. Something that scales will be useful if and when our team grows!

    You might also want to take a look at Django-Lint, written by a friend of mine. It’s basically a wrapper around PyLint, but makes more sense for Django projects.
    http://chris-lamb.co.uk/projects/django-lint/

    Mike.

    Michael Halls-Moore

    November 8, 2010 at 12:41 pm

  4. Ek … sorry I meant to say “Hi Andrew” 🙂 That was me reading the wrong comment.

    Michael Halls-Moore

    November 8, 2010 at 12:42 pm

  5. Can you post (or reply here) the configuration you are using for pylint?

    Iftah

    March 6, 2011 at 10:37 am


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: