A Test That Isn’t Automated Is a (fill in the blank)

Recently I ran into some problems with tests that could not easily be run in an automated manner.  In the spirit of a glass half full, I am trying to decide if manual tests are partially useful, partially useless, or totally useless.

The kind of work that I do, laboratory automation, scientific instrumentation, medical devices, deals a lot with hardware: sensors, motors, lasers, all kinds of fun stuff.  Over the last several years I have relied heavily on TDD, DI, and mocking frameworks to be able to abstract away many of the dependencies on the actual hardware for my testing and instead use mocks to verify higher level control functions.

At some point the rubber needs to meet the road and you need to make sure that what you are doing with the hardware is really what is supposed to happen, i.e. did a motor move, was an image captured, did you really measure the temperature correctly.  I have found that the ease-of-use of modern testing frameworks like MbUnit make writing a test a convenient way to perform this kind of hardware-software integration test.  As an example, consider a test that verifies that a motor moves correctly.  The test will read the position of the motor, move the motor in the forward direction, stop the motor, then read the position again and see if the motor has moved.

        [TestCategory("Motor Harware Tests")]
        public void TestMovingMotorForward()
            double moveMillimeters = 10.0;
            double allowedTolerance = 0.1;
            LinearMotor motor = new LinearMotor();
            double startPosition = motor.GetPosition();
            double endPosition = motor.GetPosition();

            Assert.AreEqual(moveMillimeters, endPosition - startPosition, allowedTolerance);

Now this test is doing a lot of things and it certainly is not a unit test in the strictest definition.   I want to stress that before I ever get to this kind of test I have already written a lot of lower level unit tests with the hardware abstracted away.  In many cases the code has been written and unit-tested long before the hardware even gets in the door and gets wired up, so these types of tests are really more like system integration tests.

But here’s the problem.  I can’t run this test on my automated build server because the test requires a special fixture, i.e. the hardware.  I can exclude the test by including it in a special test category and telling my automated test runner to not execute that category, but what do I do about running the test?  Do I make sure to run it manually at some frequency (1/week, 1/day, etc).  Do I just leave it in the code base and only run it manually if there is a reported problem?  What happens when I run it and there is a problem, how to I know when the error got introduced?  Do I rip the test out since it is not automated and is just cruft?

After some recent experiences of having problems occur and not knowing when they were introduced, I am really leaning heavily towards the notion of setting up a special build platform that is able to run several types of hardware tests.  Tests like these can take a long time to run due to the delays associated with the hardware, so it is not realistic to run them on every check-in, otherwise any hope at the 10 minute build is out the window.  But you could certainly set up a build to run once a day, or on the weekend, or at some frequency that works for you.

Now you may not have test problems just like this, i.e. hardware related, but maybe you have some integration tests that are long running tests.  Maybe you want to test how a database runs under extended load or you have some other stress test.  Find a way to make sure that the tests are automatically executed at some frequency, otherwise you are inviting the time when you go to run a “manual” test, only to find that it has long since stopped working.

My take-away is that if a test is not automated at some meaningful frequency it should be removed from the code, because it is not doing what you need it to do and if it is not being run it is just more technical debt.


2 thoughts on “A Test That Isn’t Automated Is a (fill in the blank)

  1. fschwiet

    Its good to hear the push you’re making towards proper automation, good work. I want to comment on your statement though, “before I ever get to this kind of test I have already written a lot of lower level unit tests”. One lesson I’ve learned is that its useful to write a few of those integration/spanning tests firsts, so they can can guide development. This can reduce the number of artificial abstractions introduced into your system, which makes the code simpler and the tests easier to maintain. Karl Seguin blogged about his shift away from mocking recently: http://openmymind.net/2010/10/20/My-Slow-Transition-Away-From-Mocks. Its a transition I started making myself recently, after seeing the codebase for RavenDB did not even include a mocking container (and it was written by the author of Rhino Mocks). I think I saw that a reference to Rhino Mocks was added to RavenDB’s tests later, but you’ll find thats the exception not the norm for that codebase (and yeah, I treat Ayende’s work as a model for what I should be doing). I definitely still do a lot of mocking myself.

  2. mdenomy Post author

    @fschwiet, thanks for your comments,

    I agree that integration/spanning tests are an important part of a complete testing strategy and can point to problems that unit level testing may not expose. I sometimes wonder if I rely too heavily on mock objects, and appreciated the link you sent. I have seen some other articles and blogs along the same lines.

    In embedded systems and automation applications, mocks play an important role because you often care a great deal about the implementation of a method/object under test. By that I mean that the order and timing that operations are performed can be critical, and mocks provide an excellent way to test this type of problem. Could be a blog post in there someplace.

    That is very interesting about RavenDB not using mocks in its tests. I am a big fan of Ayende’s blog, so I will need to take a look at the RavenDB source.


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 )

Connecting to %s