Module::CoreList(3pm)

1Module::CoreList(3)   User Contributed Perl Documentation  Module::CoreList(3)
2
3
4

NAME

6       Module::CoreList - what modules shipped with versions of perl
7

SYNOPSIS

9        use Module::CoreList;
10
11        print $Module::CoreList::version{5.00503}{CPAN}; # prints 1.48
12
13        print Module::CoreList->first_release('File::Spec');         # prints 5.00405
14        print Module::CoreList->first_release_by_date('File::Spec'); # prints 5.005
15        print Module::CoreList->first_release('File::Spec', 0.82);   # prints 5.006001
16
17        print join ', ', Module::CoreList->find_modules(qr/Data/);
18           # prints 'Data::Dumper'
19        print join ', ', Module::CoreList->find_modules(qr/test::h.*::.*s/i, 5.008008);
20           # prints 'Test::Harness::Assert, Test::Harness::Straps'
21
22        print join ", ", @{ $Module::CoreList::families{5.005} };
23           # prints "5.005, 5.00503, 5.00504"
24
25        print join " ", @{ $Module::CoreList::patchlevel{5.008001} };
26           # prints "maint-5.8 21377"
27

DESCRIPTION

29       Module::CoreList contains the hash of hashes %Module::CoreList::ver‐
30       sion, that is keyed on perl version as indicated in $].  The second
31       level hash is module => version pairs.
32
33       Note, it is possible for the version of a module to be unspecified,
34       whereby the value is undef, so use "exists $version{$foo}{$bar}" if
35       that's what you're testing for.
36
37       It also contains %Module::CoreList::released hash, which has ISO for‐
38       matted versions of the release dates, as gleaned from perlhist.
39
40       New, in 1.96 is also the %Module::CoreList::families hash, which clus‐
41       ters known perl releases by their major versions.
42
43       In 2.01 %Module::CoreList::patchlevel contains the branch and patch‐
44       level corresponding to the specified perl version in the Perforce
45       repository where the perl sources are kept.
46
47       Starting with 2.10, the special module name "Unicode" refers to the
48       version of the Unicode Character Database bundled with Perl.
49
50       Since 2.11, Module::CoreList::first_release() returns the first release
51       in the order of perl version numbers. If you want to get the earliest
52       perl release instead, use Module::CoreList::first_release_by_date().
53

CAVEATS

55       Module::CoreList currently covers the 5.000, 5.001, 5.002, 5.003_07,
56       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,
57       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,
58       5.9.1, 5.9.2, 5.9.3 and 5.9.4 releases of perl.
59

HISTORY

61       Moved to Changes file.
62

AUTHOR

64       Richard Clamp <richardc@unixbeard.net>
65
66       Currently maintained by the perl 5 porters <perl5-porters@perl.org>.
67

COPYRIGHT

69       Copyright (C) 2002-2007 Richard Clamp.  All Rights Reserved.
70
71       This module is free software; you can redistribute it and/or modify it
72       under the same terms as Perl itself.
73