cpandb - interface to
This script is an interface to the routines of CPAN::SQLite for setting up, maintaining and searching a
DBD::SQLite database of CPAN. Available options can be grouped into three categories.
These are options which are common to both setting up and maintaining the database or performing queries on it. These are
This specifies the path to where the index files are to be stored. This could be a local CPAN mirror, defined here by the presence of a MIRRORED.BY file beneath this directory, or a local directory in which to store these files from a remote CPAN mirror. In the latter case, the index files are fetched from a remote CPAN mirror, using the same list that
CPAN.pmuses, if this is configured, and are updated if they are more than one day old.
CPANoption is not given, it will default to
cpan_homeof CPAN::, if this is configured, with the sources being found under
keep_source_where. A fatal error results if such a directory isn't found. Updates to these index files are assumed here to be handled by
This is the name of the database that
DBD::SQLitewill use. If not given, this defaults to
This specifies the path to where the database file is found. If not given, it defaults to the
CPAN.pm, if present, or to the directory in which the script was invoked.
These are options which are used for setting up and maintaining the database. These include
This specifies that the database is to be created and populated from the CPAN indices; any existing database will be overwritten.
This is used to update an existing database, which must have first been created with the
This specifies that the CPAN distribution
dist_nameis to be reindexed.
These options are used to query the database. Available options are
This provides information on the specified module name.
This provides information on the specified distribution name.
This provides information on the specified CPAN author id
All search terms are assumed to be exact matches in a case-insensitive manner.
There's no limit on maximum number of records. If you need to adjust the number because you get too many results, set the CPAN_SQLITE_MAX_RESULTS environment variable.