Another paste-archive. This is something I wrote up for the developers of a company which has a large, existing project. The situation is thus. They have a partially written test suite. Its inconvenient to write really useful tests properly, too much setup is required. The test suite has bad coverage. Trunk regularly fails its tests. The yelps of the nightly smoke test are largely ignored. I'm trying to do a big redesign which is stymied by having to stop and work out if I broke something or if the last merge had a failing test.
After fixing the failures in trunk on my own for a while, only to watch more failures creep in, I decided to sit down and analyze the situation. Its a very common one.
I call this one, "On Fixing A Broken Test Suite, Step One: Break The Cycle Of Failure"
Executive executive summary:
Give the test firefighters some breathing room and run the tests before you commit to trunk.
10 The test suite is not being run before all task submissions.
20 Its not being run because its slow and trunk fails a lot.
30 Trunk fails because failing tasks are being submitted.
40 Failing tasks are being submitted because the test suite is not being run.
50 GOTO 10
I'm trying to get trunk back to passing while new failures are being piled on
top faster than I can fix them. Please run "make test && commit_to_trunk". If it fails compare it against a clean trunk test or the last automated tester report to see if you added anything.
In working to get the tests up to a usable, stable state so I can know the new XXX implementation is working I've seeing clear patterns of breakage. The sorts of test breakage I'm seeing are mostly of these forms.
1) A method was removed but not all the tests were updated.
2) The schema was changed to remove a column or add a new constraint and the
tests were not updated.
3) The schema was changed and the test database was not updated.
4) The test database has dirty data in it.
5) The test relied on random data in the production database copy that went away.
These can be broken up into two categories. 1, 2 and 3 are of "preventable by
running the full test suite". You run it before submitting, see the failure
and fix it. If a little time consuming to run the tests, its a simple fix at
that point by the person making a change. Otherwise the fix gets pushed off
to someone else who then has to do detective work to figure out what's going
on and lots of developer time is wasted.
Ideally you should be doing this when you're done with a task:
make test && commit_to_trunk
I realize the tests are slow and the suite currently fails. I'm working on
the latter, for now please compare your results against the last nightly test
run. As to the former, just shove it off in another terminal and let it run.
At the very least, when you delete a method or column do a grep of lib and t
for that method.
4 and 5 are of the "it worked before, now it doesn't work" variety. #4 will
be greatly relieved once the automated tester is rebuilding the test database from the schema files every night. #5 is a little more involved to fix proper and I'm going to shelve that for the moment.
The tests aren't getting run, that much is clear. This is usually because of
a few things:
1) They're really slow.
2) They're unreliable.
3) They have bad coverage.
Again, two categories. #1 falls into the general category of "they're a pain
in the ass to run". As the system gets faster the tests should get faster, but
there's currently a lot of fat to be cut out. Most test files call Bootstrap to load up the entire system. That's 5 seconds each. I count about 100 calls. That's about 8 minutes of fat right there. A lot of these are stub "can_ok" tests or in some cases they do nothing at all except chew up time loading Bootstrap! Look at a good chunk of t/bin/. These should all probably be deleted or at least all the code entirely stubbed out. In the long run Bootstrap should be made unnecessary.
Task XXXX is available for cleaning out the useless tests.
Task XXXX is available to move all the stub can_ok() tests into one file to avoid having to load Bootstrap so many times.
Task XXXX is available to speed up the slowest test which takes about 10 minutes to run.
#2 and #3 are of the category "they're not worth running". Either because
they're not catching real bugs or because failing tests are allowed to leak
into trunk. Increasing coverage is more involved so I'll shelve that for the
moment. Unreliable tests are a pernicious but fortunately easily solved
problem. Unreliable tests are a vicious cycle, people don't run the full test
suite because they don't think its useful. Failures begin leaking into trunk
making it even less reliable which makes programmers even less likely to run
the full suite which means more failures leak in... and on until you have to
hire a specialist to fix the problem. Welcome to the bottom of the spiral
The failing trunk -> loss of confidence -> not running the tests cycle is even
more harmful to the test suite because while someone is trying to fix the
trunk test suite more failing tests are being piled in. Even if the repair
succeeds, developer confidence in the test suite takes time to restore thus
some devs won't run the test suite and failures will leak in again crushing
any confidence that might have been built up and the cycle starts again.
The only way to wind down this cycle is 1) to have devs be right on top of the
test suite repairing it and 2) for devs to run the tests, regardless of their
confidence in it, and not let more failures slip into trunk. Once people are
no longer putting out trunk fires we can work on increasing coverage and
making the tests easier to write.