baurel has asked for the wisdom of the Perl Monks concerning the following question:

hi dear friends
I'd like to install a perl module from cpan (HTML::WikiConverter::Markdown). The installation doesn't work because of failing tests. What do you do in such a situation?
- most of the forum linked in the cpan modules (->"Discussion Forum") are empty
- there are lots and lots of mailinglists listed on cpan. I'm simply confused
- is Perlmonks the way to go?
thanks
ben

Replies are listed 'Best First'.
Re: best way to report cpan errors?
by mje (Curate) on Oct 15, 2008 at 12:14 UTC

    As others have said there is http://rt.cpan.org where you can report bugs.

    As you have found few people seem to use the cpan forums. As a module author I get a handful of posts a year on the cpan forums.

    What I do pay particular attention to is the cpan testers reports http://www.cpantesters.org/ and via the test reports link on each module on CPAN. One rather easy way to contribute reports whenever you attempt to install a module via cpan shell is to install http://search.cpan.org/~dagolden/CPAN-Reporter-1.1702/ then once it is configured every pass and fail is automatically reported to cpan and the author gets a daily notification of failures.

    If tests fail when I am installing a module I first attempt to work out why. Sometimes there are tests which fail because they have not been written to check on module dependencies and often you can either get the dependencies and re-run or if you are confident you don't need that dependency (e.g., if the test needs it but the module you want to install doesn't) you can ignore it.

    In summary the nice things to do for module authors would be to report the problem via rt or the forum or via CPAN::Reporter and attempt to fix it. If you can't fix it report it anyway. For yourself, you will either have to get a fix or a least obtain sufficient confidence in the module to decide if you can force the install.

Re: best way to report cpan errors?
by marto (Cardinal) on Oct 15, 2008 at 10:40 UTC
Re: best way to report cpan errors?
by Anonymous Monk on Oct 15, 2008 at 10:51 UTC
    best way to report cpan errors?
    FYI, failing tests are not a cpan error :)

    The installation doesn't work because of failing tests. What do you do in such a situation?...
    Depends on what you're comfortable with and what you want to accomplish. If you don't care that some tests failed, you can force install,

    $ cpan cpan>force install <module> # or alternatively $ cpan cpan> look <module> perl Makefile.PL make make test make install
    If you do care that some test failed, you should file a bug report with the author (even though cpan-testers have several automated reports sent in). If you really care, you'll debug the failing tests, and write/submit a patch along with your report :)
    http://rt.cpan.org/NoAuth/Bugs.html?Dist=HTML-WikiConverter-Markdown