CPAN | Use
How to use CPAN
Official CPAN Logo
What is CPAN?
CPAN is the Comprehensive Perl Archive Network. It is online repository of modules of software in Perl language and related documentations. Most of the modules/software are free and open source. These are hosted at www.cpan.org. The repository is mirrored on 250+ servers worldwide.
The archive was started in 1995 and now it contains more than 103,000 perl modules contributed by more than 9400+ developers. The repository is constantly growing with more and more modules being added daily.
CPAN also denotes a utility in Perl world that can fetch and install any module from the CPAN repository and install it when required quite automatically. It can be invoked by typing a command. Many high-end perl based software distributions use these modules and mention the module names that need to installed before installing the applications in their documentation.
Perl can be invoked from command line by typing the command,
# cpan <>
The above method is quite straight forward but If you have a long list of perl modules or want to have better control/understanding of what you are installing or want to troubleshoot a failed installation you may want to enter the cpan console or cpan shell. In this case start with the command,
# perl -MCPAN -e shell
This will start the cpan console as under,
When installing from this console you need to type one of the commands mentioned bellow along with the module name. If you want to install a perl module called PDF::API2 the correct syntax will be,
cpan> install PDF::API2
Note: If you are using the cpan for the Ist time on your machine it will ask you to configure the service on your machine. You can opt for autoconfigure or do the configuration manually by answering a few questions and defining a few locations. However, auto-configuration will be sufficient for you if you are new to the utility or you can reply most of the time with default values if doing it manually. Anyway, you can return back and reconfigure if needed at any time by typing 'o conf init' at the command prompt.
While using cpan the commonly used commands are get, make, test and install. The functions of these commands are,
This will get/download the perl module from the cpan repository to your machine. Syntax -
This will make the downloaded module for installation.
cpan> get PDF::API2
This will test the installation for any missing dependencies or any other issues.
cpan> make PDF::API2
This will install the perl module. This command is all comprehensive i.e. if used alone along with the name of module this will execute all the commands mentioned above in the same sequence (this will download, make and test the module and then install it).
cpan> test PDF::API2
cpan> install PDF::API2
The better option will be to use the last command i.e. install as this will perform all the functions required for the installation. However, if you are facing some issues and the module is not installing you can perform one task starting with download through installation to find the cause of failure. Or simply if you are curious and want to go through all the steps one by one you can use these commands in the sequence.
Important: If required you can install more than one module with the same command by typing all the modules on the same line with a space inbetween at the command prompt, i.e.
cpan PDF::API2 Text::CSV XML::Dumper YAML::Syck
Or typing install
followed by names of all the modules on the same line seperated by space on cpan prompt,
cpan> install PDF::API2 Text::CSV XML::Dumper YAML::Syck
Note: If somehow a module can't be installed using the cpan you can directly download the .tar.gz source file and install it manually.
Title - CPAN | Author - PunLib | Article ID - 00000000014 | Last Updated - 2012-04-25 09:20:22 | Keywords - CPAN, Comprehensive Perl Archive Network, Perl Modules,