CPANPLUS::TesterGuide

CPANPLUS::TesterGuide allows you to become a CPAN Tester with CPANPLUS.
Download

CPANPLUS::TesterGuide Ranking & Summary

Advertisement

  • Rating:
  • License:
  • Perl Artistic License
  • Price:
  • FREE
  • Publisher Name:
  • Autrijus Tang
  • Publisher web site:
  • http://search.cpan.org/~autrijus/CPANPLUS-0.0499/lib/CPANPLUS/TesterGuide.pod

CPANPLUS::TesterGuide Tags


CPANPLUS::TesterGuide Description

CPANPLUS::TesterGuide allows you to become a CPAN Tester with CPANPLUS. CPANPLUS::TesterGuide allows you to become a CPAN Tester with CPANPLUS.SYNOPSIS # This is an article, not a module.The following article first appeared in perl.com, and is copyrighted 2002 by Autrijus Tang. This document may be distributed under the same terms as Perl itself.IntroductionIn CPANPLUS -- Like CPAN.pm only better? , Jos Boumans recounted the tale of how his CPANPLUS project came to be; one of the original goals was to provide a modular backend to CPANTS, the CPAN Testing Service, so modules can be automatically built and tested on multiple platforms.Although the initial CPANPLUS release did not support testing-related features, Jos considered them important enough to be listed near the top of his Current and Future Developments wish list, and quoted Michael Schwern's opinion on their potential benefits : It would alter the way free software is distributed. It would get a mark of quality; it would be tested and reviewed. And gosh darnit, it would be good.At that time, despite having participated in CPANPLUS's development for more than four months, I was blissfully unaware of the project's original vision. But it seemed like a worthwhile goal to pursue, so I quickly jotted down several pieces that need to work together:Check test reports of modules before installation.Report make test results to the author, and make them available for other users to check.Tools to batch-test modules with or without human intervention.A clean API for other programs to perform tests, reporting and queries.Today, with the 0.032 release of CPANPLUS, all the above pieces are completed. This article will show you how to configure and use these tools, as well as describing some important new features in CPANPLUS that made them possible.Setting up the environmentFirst, you need a copy of CPANPLUS 0.032 or above. I recommend the tarball automatically built from the distribution branch, available at http://p4.elixus.org/snap/cpanplus-dist.tar.gz; it should contain the latest bug-fixes and features marked as stable.Since Jos's article and README already contained install instructions, I will not repeat the details here. However, please note that the dependency detection logic in Makefile.PL has been changed since Jos's previous article, which means when faced with this prompt: - Net::SMTP ...loaded. (2.24 >= 0.01) - IPC::Run ...loaded. (0.74 >= 0.55) - Test::Reporter ...failed! (needs 1.13) ==> Do you wish to install the 1 optional module(s)? You should generally answer y here, as only modules that can safely install on your machine are displayed. The default n does not mean we don't recommend it; it merely means it isn't mandatory for the bare-bone CPANPLUS to function.For this article's purpose, you need to answer y to all such questions, since we will be using LWP, IPC::Run and Test::Reporter extensively in testing-related functions.After running Makefile.PL, you should run make test like every good user; if any dependent modules were selected in the previous step, you will have to run make test as root, so it can fetch and install these modules automatically before testing itself.After the comforting All tests successful message appears on your screen, just do a make install, and we are ready to go. Requirements: · Perl


CPANPLUS::TesterGuide Related Software