Slash Boxes
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

Monday March 19, 2007
01:42 AM

Module::CPANTS::Analyse stricter than Test::Pod

[ #32738 ]

CPANTS tests module kwalitee, including a metric for Pod tests. It does much more than Test::Pod I discovered.

While fixing PodToHTML, I discovered that even though Test::Pod did not complain, did. It took me a while to figure it out, but Test::Pod only looks for specific files (modules and scripts), while the Pod checker in Module::CPANTS::Analyse looks for any files with the right extensions (.pm, .pl, .pod). It doesn't care what they are or where they come from.

PodToHTML has a t/testpod.pod. Test::Pod ignores it, but Module::CPANTS::Analyse looks at it. Since it's a test file, it has some broken Pod in it on purpose. Since it has broken Pod, complains.

This is a bit of a problem for authors writing Pod modules and testing bad input. :(

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
More | Login | Reply
Loading... please wait.
  • I would have thought the kwalitee and CPANTS movement was harmful anyway. I've since removed all my author-level tests from my distributions because really... they suffer from the Module::Install problem where every distribution has its own version of an adhoc series of author sanity tests.

    I used to check for pod sanity and coverage and such but after a dozen modules or so it wasn't sane to leave that stuff in my distributions. Really, I just want a Distribution::AuthorTests or something like that which has
  • If you really care about the CPANTs game, you could use some trivial encoding for the file with the bad POD and then generate the file used to test at test time as a temporary file. Maybe as little as renaming the file would suffice to hide it.