NAME
CPAN::ParseDistribution - index a file from the BackPAN
DESCRIPTION
Given a file from the BackPAN, this will let you find out what versions of what modules it contains, the distribution name and version
SYNOPSIS
my $dist = CPAN::ParseDistribution->new(
'A/AU/AUTHORID/subdirectory/Some-Distribution-1.23.tar.gz'
);
my $modules = $dist->modules(); # hashref of modname => version
my $distname = $dist->dist();
my $distversion = $dist->distversion();METHODS
new
Constructor, takes a single mandatory argument, which should be a tarball or zip file from the CPAN or BackPAN.
isdevversion
Returns true or false depending on whether this is a developer-only or trial release of a distribution. This is determined by looking for an underscore in the distribution version.
modules
Returns a hashref whose keys are module names, and their values are the versions of the modules. The version number is retrieved by eval()ing what looks like a $VERSION line in the code. This is done in a Safe compartment, but may be a security risk if you do this with untrusted code. Caveat user!
dist
Return the name of the distribution. eg, in the synopsis above, it would return 'Some-Distribution'.
distversion
Return the version of the distribution. eg, in the synopsis above, it would return 1.23.
Strictly speaking, the CPAN doesn't have distribution versions - Foo-Bar-1.23.tar.gz is not considered to have any relationship to Foo-Bar-1.24.tar.gz, they just happen to coincidentally have rather similar contents. But other tools, such as those used by the CPAN testers, do treat distributions as being versioned.
SECURITY
This module executes a very small amount of code from each module that it finds in a distribution. While every effort has been made to do this safely, there are no guarantees that it won't let the distributions you're examining do horrible things to your machine, such as email your password file to strangers. You are strongly advised to read the source code and to run it in a very heavily restricted user account.
LIMITATIONS, BUGS and FEEDBACK
I welcome feedback about my code, including constructive criticism. Bug reports should be made using http://rt.cpan.org/ or by email, and should include the smallest possible chunk of code, along with any necessary XML data, which demonstrates the bug. Ideally, this will be in the form of a file which I can drop in to the module's test suite.
SEE ALSO
AUTHOR, COPYRIGHT and LICENCE
Copyright 2009 David Cantrell <david@cantrell.org.uk>
Contains code originally from the PAUSE by Andreas Koenig.
This software is free-as-in-speech software, and may be used, distributed, and modified under the terms of either the GNU General Public Licence version 2 or the Artistic Licence. It's up to you which one you use. The full text of the licences can be found in the files GPL2.txt and ARTISTIC.txt, respectively.
CONSPIRACY
This module is also free-as-in-mason software.