mcpani -- A command line tool to manage a CPAN Mini Mirror.
mcpani [options] < --add | --update | --mirror | --inject >
Commands:
--add Add a new package to the repository --module Name of the module to add --authorid Author ID of the module --modversion Version number of the module --all-in-meta parse all modules in the META.yml --file tar.gz file of the module --update Update local CPAN mirror and inject modules --mirror Update local CPAN mirror from remote --inject Add modules from repository to CPAN mirror
Options:
-h, --help This synopsis -H, --man Detailed description -l, --local local location for CPAN::Mini Mirror -r, --remote CPAN mirror to mirror from -p, --passive Enable passive ftp for mirroring. -v, --verbose verbose output -V, --version Version information.
mcpani is a command-line brief description goes here.
Add a module to the repository for later inclusion in the CPAN Mini mirror. The add command requires the following parameters:
This is the name of the module (ie CPAN::Mini::Inject).
A CPAN 'like' author ID for the module. The author ID does not need to exist on CPAN.
Version number of the module. This must match the version number in the file name.
This option will add every module listed in the 'provides' section of the META.yml contained in the tar.gz provided by the --file option.
The options --module and --modversion are still recognized. If the same module/version is found in the META.yml it is not duplicated.
If the META.yml file or the 'provides' section is missing, then a warning is issued and the only module added is the one provided by --module / --modversion.
File name and path of the module. The file name must follow the standard CPAN naming convention (the resulting file from a make tardist).
make tardist
Example: mcpani --add --module CPAN::Mini::Inject --authorid SSORICHE --modversion 0.01 file ./CPAN-Mini-Inject-0.01.tar.gz
Update your local CPAN Mini mirror from a CPAN site. Once completed add the modules contained in the repository to it. This is the same as running mcpani --mirror followed by mcpani --inject
mcpani --mirror
mcpani --inject
Update the local CPAN Mini mirror from CPAN.
Add the repository modules into the CPAN Mini mirror.
A local directory to store the CPAN Mini mirror in. Specifying this option overrides the value in the config file.
A CPAN site to create the local CPAN Mini mirror from.
Display verbose processing information
Display version information.
mcpani uses a simple configuration file in the following format:
local: /www/CPAN remote: ftp://ftp.cpan.org/pub/CPAN ftp://ftp.kernel.org/pub/CPAN repository: /work/mymodules passive: yes dirmode: 0755
Description of options:
local
location to store local CPAN::Mini mirror (*REQUIRED*)
remote
CPAN site(s) to mirror from. Multiple sites can be listed, with spaces between them. (*REQUIRED*)
repository
Location to store modules to add to the local CPAN::Mini mirror.
passive
Enable passive FTP.
dirmode
Set the permissions of created directories to the specified mode (octal value). The default value is based on the umask (if supported).
mcpani will search the following four places in order:
file pointed to by the environment variable MCPANI_CONFIG
$HOME/.mcpani/config
/usr/local/etc/mcpani
/etc/mcpani
Shawn Sorichetti <ssoriche@coloredblocks.net>
<ssoriche@coloredblocks.net>
Copyright 2004 Shawn Sorichetti, All Rights Reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install CPAN::Mini::Inject, copy and paste the appropriate command in to your terminal.
cpanm
cpanm CPAN::Mini::Inject
CPAN shell
perl -MCPAN -e shell install CPAN::Mini::Inject
For more information on module installation, please visit the detailed CPAN module installation guide.