Tony Bowden wrote:
On Thu, Apr 07, 2005 at 12:32:31PM -0400, Christopher H. Laco wrote:
CPANTS can't check that for me, as I don't ship those tests.
They're part of my development environment, not part of my release tree.
That is true. But if you don't ship them, how do I know you bothered to check those things in the first place?
Why do you care? What's the difference to you between me shipping a a .t
file that uses Pod::Coverage, or by having an internal system that uses
Devel::Cover in a mode that makes sure I have 100% coverage on everything,
including POD, or even if I hire a team of Benedictine Monks to peruse
my code and look for problems?
The only thing that should matter to you is whether the Pod coverage is adequate, not how that happens.
I think you just answered youre own question, assuming you just agreed that I should care about whether your pod coverage is adequate.
How as a module consumer would I find out that the Pod coverage is adequate again? Why the [unshipped] .t file in this case.
The only other way to tell is to a) write my own pod_coverage.t test for someone elses module at install time, or b) hand review all of the pod vs. code. Or CPANTS.
The main point is not so much that you define a measure of quality, but that you dictate to everyone the one true way in which they must determine it.
The POD is the worst example of this. Why on earth should you care? You say because you should care if the author does consistent POD checking. Fine, but you dictate the "One True Path" to POD checking, which is to bundle a test for it with the package.
I've got all sorts of crap in my package delivery pipeline, but it doesn't mean I want to go bundling all of it in. Imagine a PPI-based tool that verifies that the required version matches the syntax. Should we make every single module bundle it, and make every single user download a 55 class 5000 SLOC 3 meg package? Just to install Thingy.pm.
Why not give a kwalitee point for modules that bundle a test that checks for kwalitee? The required kwalitee.t checks quality and requires your kwalitee be over 15 before passing.
Where does it end?
Adam K
