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, 5.9.4, 5.9.5 and 5.10.0 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.

SEE ALSO

corelist, Module::Info, perl