NAME
Module::CoreList - what modules shipped with versions of perl
SYNOPSIS
use Module::CoreList;
print $Module::CoreList::version{5.00503}{CPAN}; # prints 1.48
print Module::CoreList->first_release('File::Spec'); # prints 5.00405
print Module::CoreList->first_release_by_date('File::Spec'); # prints 5.005
print Module::CoreList->first_release('File::Spec', 0.82); # prints 5.006001
print join ', ', Module::CoreList->find_modules(qr/Data/);
# prints 'Data::Dumper'
print join ', ', Module::CoreList->find_modules(qr/test::h.*::.*s/i, 5.008008);
# prints 'Test::Harness::Assert, Test::Harness::Straps'
print join ", ", @{ $Module::CoreList::families{5.005} };
# prints "5.005, 5.00503, 5.00504"
print join " ", @{ $Module::CoreList::patchlevel{5.008001} };
# prints "maint-5.8 21377"DESCRIPTION
Module::CoreList contains the hash of hashes %Module::CoreList::version, that is keyed on perl version as indicated in $]. The second level hash is module => version pairs.
Note, it is possible for the version of a module to be unspecified, whereby the value is undef, so use exists $version{$foo}{$bar} if that's what you're testing for.
It also contains %Module::CoreList::released hash, which has ISO formatted versions of the release dates, as gleaned from perlhist.
New, in 1.96 is also the %Module::CoreList::families hash, which clusters known perl releases by their major versions.
In 2.01 %Module::CoreList::patchlevel contains the branch and patchlevel corresponding to the specified perl version in the Perforce repository where the perl sources are kept.
Starting with 2.10, the special module name Unicode refers to the version of the Unicode Character Database bundled with Perl.
Since 2.11, Module::CoreList::first_release() returns the first release in the order of perl version numbers. If you want to get the earliest perl release instead, use Module::CoreList::first_release_by_date().
CAVEATS
Module::CoreList currently covers the 5.000, 5.001, 5.002, 5.003_07, 5.004, 5.004_05, 5.005, 5.005_03, 5.005_04, 5.6.0, 5.6.1, 5.6.2, 5.7.3, 5.8.0, 5.8.1, 5.8.2, 5.8.3, 5.8.4, 5.8.5, 5.8.6, 5.8.7, 5.8.8, 5.9.0, 5.9.1, 5.9.2, 5.9.3 and 5.9.4 releases of perl.
HISTORY
Moved to Changes file.
AUTHOR
Richard Clamp <richardc@unixbeard.net>
Currently maintained by the perl 5 porters <perl5-porters@perl.org>.
COPYRIGHT
Copyright (C) 2002-2007 Richard Clamp. All Rights Reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.