NAME
CPAN::Nargile - Front-end for cpansmoke
SYNOPSIS
nargile.pl --cpan http://www.cpan.org --ask
or if you want to run it on another perl installation:
nargile.pl --cpan http://www.cpan.org --perl /home/gabor/perl/585/bin/perl -ask
See also nargile.pl --help
DESCRIPTION
Enable the user on any platform (will someone test this on other platforms as well, please)
to run smoke tests of CPAN modules.
The original recommended CPAN smoking is done based on e-mails sent to the
CPAN Testsers mailing list. This has the drawback that it requres some way to
parse the incoming mails on the same box where I want to run the smoker.
Nargile downloads the list of the latest modules from CPAN and works on that list so
you don't need to read mail any more.
It also ensures that only modules that already reached CPAN will be tested.
Frequency
By default CPANPLUS is being configured to reload its index ever 86400 seconds,
that is 24 hours. If you would like to run nargile more often with fresh data
from CPAN you'll have to configure the C<update> value of CPANPLUS to a lower number.
FILES
The scipt maintains a file called $ENV{HOME}/.nargile.dbm where it lists the
distributes which were already tried.
BUGS
This is an experimental version that works on my computer...
Sometimes I get the following error message:
Can't call method "module" on an undefined value at /home/gabor/perl/585/lib/site_perl/5.8.5/CPANPLUS/Internals/Install.pm line 220.
It seems that cpansmoke when it notices that I have already sent a report about a distribution
(in a previous life) it won't even install it. This might be a problem but it might be that it
happens only as I have installed some modules in a previous attemt to test the Nargile script.
This might be a bug in CPANPLUS 0.049 - should upgrade it before complaining:
In the recent uploads list there was
TMTM Text-Decorator-1.5.tar.gz
but when I ran cpansmok Text-Decorator-1.5
it tiread to fetch /S/SI/SIMON/Text-Decorator-1.5.tar.gz
It seem the module just changed owners as SIMON has the earlier versions of this module.
TODO
Fix the bugs.
Enable the user to give a list of modules (using regexes) to be smoked or a list of
modules (using regexes) to exclude from smoking.
Enable the user to decide per module if s/he wants to smoke it or not.
Interactive mode asking the user for every module what to do before and maybe even after running it.
Test/Skip/Quit/Exclude ?
Reduce prerequisites of this module ?
Enable user initiate smoking a specific distribution by giving its name.
Automatically skip Bundles ?
With the current way of testing all the files in the latest 150 it migth happen that
the user uploaded 2 or more versions in the past few days and we might test an already
outdated version (in addition to the new one). Worse than that it can easily happen
especially if using CPAN::Mini that we don't have one of the versions. I should find out
first what is really the latest version of a dist on the CPAN mirror I am using.
Somehow catch the output of each cpansmoke run (using script on unix ?) for later reference.
Changes
v0.03
code moved mostly from script to module
fix bug
When user selects Skiping a module or Quiting (in case of --ask) the name of the module is already
addedd to the "smoked" list and it won't be smoked again in the next run.
split the Don't do and the Skip modes
cpanplus option -p removed to install prerequisites too
SEE ALSO
L<CPANPLUS::TesterGuide>
L<cpansmoke>
L<http://search.cpan.org/dist/CPANPLUS>
L<CPAN::Mini>
Spelling
Maybe it was better if I spelled it as Nargila ?
AUTHOR
Gabor Szabo <gabor@pti.co.il>
Copyright 2004, Gabor Szabo
The code is released under the same terms as Perl itself.
L<http://www.szabgab.com/>