NAME
dpan - create a DarkPAN from directories
SYNOPSIS
# from the command line
prompt> dpan [-l log4perl.config] [-f config] [directory [directory2]]DESCRIPTION
The dpan script takes a list of directories, indexes any Perl distributions it finds, and creates the PAUSE index files from what it finds. Afterward, you should be able to point a CPAN tool at the directory and install the distributions normally.
If you don't specify any directories, it works with the current working directory.
At the end, dpan creates a modules directory in the first directory (or the current working directory) and creates the 02package.details.txt.gz and 03modlist.data.gz.
Command-line processing
Configuration options
If you don't specify these values in a configuation file, dpan will use its defaults.
- report_dir
-
Where to store the distribution reports.
Default: a directory named indexer_reports in the current working directory
- temp_dir
-
Where to unpack the dists or create any temporary files.
Default: a temp directory in the current working directory
- alarm
-
The maximum amount of time allowed to index a distribution, in seconds.
Default: 15
- copy_bad_dists
-
If set to a true value, copy bad distributions to the named directory so you can inspect them later.
Default: 0
- retry_errors
-
Try to index a distribution even if it was previously tried and had an error. This depends on previous reports being in
report_dir, so if you don't set that configuration directive, it won't matter.Default: 1
- indexer_id
-
Give yourself a name so people who who ran
dpan.Default: Joe Example <joe@example.com>
- system_id macbookpro
-
Give the indexing system a name, just to identify the machine.
Default: 'an unnamed machine'
- indexer_class
-
The Perl class to use as the indexing class. It has to at least provide a run method. See MyCPAN::Indexer::Tutorial for details on indexing classes.
Default: MyCPAN::App::DPAN::Indexer
- queue_class MyCPAN::Indexer::Queue
-
The Perl class to use as the queue class. It has to at least provide a run method. See MyCPAN::Indexer::Tutorial for details on queue classes.
Default: MyCPAN::Indexer::Queue
- dispatcher_class
-
The Perl class to use as the dispatching class. It has to at least provide a run method. See MyCPAN::Indexer::Tutorial for details on dispatching classes.
Default: MyCPAN::Indexer::Dispatch::Parallel
- interface_class
-
The Perl class to use as the interface class. It has to at least provide a run method. See MyCPAN::Indexer::Tutorial for details on interface classes.
Default: MyCPAN::Indexer::Interface::Text
- worker_class
-
The Perl class to use as the worker class. It has to at least provide a run method. See MyCPAN::Indexer::Tutorial for details on worker classes.
Default: MyCPAN::Indexer::Worker
- reporter_class
-
The Perl class to use as the reporter class. It has to at least provide a run method. See MyCPAN::Indexer::Tutorial for details on reporter classes.
Default: MyCPAN::App::DPAN::Indexer
- parallel_jobs
-
The number of parallel jobs to run.
Default: 1
SEE ALSO
MyCPAN::Indexer, MyCPAN::Indexer::DPAN
SOURCE AVAILABILITY
This code is in Github:
git://github.com/briandfoy/mycpan-indexer.gitAUTHOR
brian d foy, <bdfoy@cpan.org>
COPYRIGHT AND LICENSE
Copyright (c) 2008-2009, brian d foy, All Rights Reserved.
You may redistribute this under the same terms as Perl itself.