Wednesday August 23, 2006
Test::Pod::Snippets v0.01 is out!
From T::P::S's manpage:
- Fact 1
In a perfect world, a module's full API should be covered by an extensive
battery of testcases neatly tucked in the distribution's t directory.
But then, in a perfect world each backyard would have a marshmallow tree and
postmen would consider their duty to circle all the real good deals in pamphlets
before stuffing them in your mailbox. Obviously, we're not living in a perfect
- Fact 2
Typos and minor errors in module documentation. Let's face it: it happens to everyone.
And while it's never the end of the world and is prone to rectify itself in
time, it's always kind of embarassing. A little bit like electronic zits on
prepubescent docs, if you will.
Test::Pod::Snippets's goal is to address those issues. Quite simply,
it extracts verbatim text off pod documents -- which it assumes to be
code snippets -- and generate test files out of them.
Test::Pod::Snippets: on its way to a CPAN near you. In the meantime, it can be peeked at in its
svn repository or its