This very morning I discovered TheDamian's Smart::Comments which allows you to embed debugging code in the comments. Brilliant!

It includes facilities for assertions which cause the script to warn() or die() on failure.

To top it all off, it also does animated progress bars (in ASCII of course).