Module::CoreList(3p)

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