cpan::api::howto(3pm) [osx man page]

CPAN::API::HOWTO(3pm)					 Perl Programmers Reference Guide				     CPAN::API::HOWTO(3pm)

NAME

       CPAN::API::HOWTO - a recipe book for programming with CPAN.pm

RECIPES

       All of these recipes assume that you have put "use CPAN" at the top of your program.

   What distribution contains a particular module?
	   my $distribution = CPAN::Shell->expand(
	       "Module", "Data::UUID"
	   )->distribution()->pretty_id();

       This returns a string of the form "AUTHORID/TARBALL".  If you want the full path and filename to this distribution on a CPAN mirror, then
       it is ".../authors/id/A/AU/AUTHORID/TARBALL".

   What modules does a particular distribution contain?
	   CPAN::Index->reload();
	   my @modules = CPAN::Shell->expand(
	       "Distribution", "JHI/Graph-0.83.tar.gz"
	   )->containsmods();

       You may also refer to a distribution in the form A/AU/AUTHORID/TARBALL.

SEE ALSO

       the main CPAN.pm documentation

LICENSE

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

AUTHOR

       David Cantrell

perl v5.16.2							    2012-08-26						     CPAN::API::HOWTO(3pm)

CPAN::Perl::Releases(3pm)				User Contributed Perl Documentation				 CPAN::Perl::Releases(3pm)

NAME

       CPAN::Perl::Releases - Mapping Perl releases on CPAN to the location of the tarballs

VERSION

       version 0.60

SYNOPSIS

	 use CPAN::Perl::Releases qw[perl_tarballs];

	 my $perl = '5.14.0';

	 my $hashref = perl_tarballs( $perl );

	 print "Location: ", $_, "
" for values %{ $hashref };

DESCRIPTION

       CPAN::Perl::Releases is a module that contains the mappings of all "perl" releases that have been uploaded to CPAN to the "authors/id/"
       path that the tarballs reside in.

       This is static data, but newer versions of this module will be made available as new releases of "perl" are uploaded to CPAN.

FUNCTIONS

       "perl_tarballs"
	   Takes one parameter, a "perl" version to search for. Returns an hashref on success or "undef" otherwise.

	   The returned hashref will have a key/value for each type of tarball. A key of "tar.gz" indicates the location of a gzipped tar file and
	   "tar.bz2" of a bzip2'd tar file. The values will be the relative path under "authors/id/" on CPAN where the indicated tarball will be
	   located.

	     perl_tarballs( '5.14.0' );

	     Returns a hashref like:

	     {
	       "tar.bz2" => "J/JE/JESSE/perl-5.14.0.tar.bz2",
	       "tar.gz" => "J/JE/JESSE/perl-5.14.0.tar.gz"
	     }

	   Not all "perl" releases had "tar.bz2", but only a "tar.gz".

SEE ALSO

       <http://www.cpan.org/src/5.0/>

       <http://search.cpan.org/faq.html#Is_there_a_API?>

AUTHOR

       Chris Williams <chris@bingosnet.co.uk>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Chris Williams.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.14.2							    2012-06-20						 CPAN::Perl::Releases(3pm)