The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Module::CoreList::More - More functions for Module::CoreList

VERSION

This document describes version 0.08 of Module::CoreList::More (from Perl distribution Module-CoreList-More), released on 2016-02-17.

SYNOPSIS

 use Module::CoreList::More;

 # true, this module has always been in core since specified perl release
 Module::CoreList::More->is_still_core("Benchmark", 5.010001);

 # false, since CGI is removed in perl 5.021000
 Module::CoreList::More->is_still_core("CGI");

 # false, never been in core
 Module::CoreList::More->is_still_core("Foo");

 my %modules = list_still_core_modules(5.010001);

DESCRIPTION

This module is my experiment for providing more functionality to (or related to) Module::CoreList. Some ideas include: faster functions, more querying functions, more convenience functions. When I've got something stable and useful to show for, I'll most probably suggest the appropriate additions to Module::CoreList.

Below are random notes:

FUNCTIONS

These functions are not exported. They can be called as function (e.g. Module::CoreList::More::is_still_core($name) or as class method (e.g. Module::CoreList::More->is_still_core($name).

first_release( MODULE )

Like Module::CoreList's version, but faster (see "BENCHMARK").

first_release_by_date( MODULE )

Like Module::CoreList's version, but faster (see "BENCHMARK").

removed_from( MODULE )

Like Module::CoreList's version, but faster (see "BENCHMARK").

removed_from_by_date( MODULE )

Like Module::CoreList's version, but faster (see "BENCHMARK").

is_core( MODULE, [ MODULE_VERSION, [ PERL_VERSION ] ] )

Like Module::CoreList's version, but faster (see "BENCHMARK").

is_still_core( MODULE, [ MODULE_VERSION, [ PERL_VERSION ] ] )

Like is_core, but will also check that from PERL_VERSION up to the latest known version, MODULE has never been removed from core.

Note/idea: could also be implemented by adding a fourth argument MAX_PERL_VERSION to is_core, defaulting to the latest known version.

list_core_modules([ PERL_VERSION ]) => %modules

List modules that are in core at specified perl release.

list_still_core_modules([ PERL_VERSION ]) => %modules

List modules that are (still) in core from specified perl release to the latest. Keys are module names, while values are versions of said modules in specified perl release.

BENCHMARK

                                  Rate MC->removed_from(Foo) MC->removed_from(CGI) MCM->removed_from(Foo) MCM->removed_from(CGI)
 MC->removed_from(Foo)  153.77+-0.42/s                    --                -88.3%                 -99.7%                 -99.8%
 MC->removed_from(CGI)     1314.4+-4/s           754.8+-3.5%                    --                 -97.7%                 -98.0%
 MCM->removed_from(Foo)   57760+-280/s           37460+-210%             4294+-25%                     --                 -11.7%
 MCM->removed_from(CGI) 65407.3+-1.2/s           42440+-120%             4876+-15%           13.25+-0.55%                     --
 
                                            Rate MC->removed_from_by_date(Foo) MC->removed_from_by_date(CGI) MCM->removed_from_by_date(Foo) MCM->removed_from_by_date(CGI)
 MC->removed_from_by_date(Foo)    151.41+-0.25/s                            --                        -87.9%                         -99.7%                         -99.8%
 MC->removed_from_by_date(CGI)     1252.7+-1.7/s                   727.4+-1.8%                            --                         -97.9%                         -98.2%
 MCM->removed_from_by_date(Foo) 59798.3+-0.074/s                    39395+-64%                  4673.5+-6.5%                             --                         -13.6%
 MCM->removed_from_by_date(CGI)     69210+-120/s                   45610+-110%                     5424+-12%                    15.73+-0.2%                             --
 
                                  Rate MC->first_release(Foo) MC->first_release(CGI) MCM->first_release(Foo) MCM->first_release(CGI)
 MC->first_release(Foo)   154.7+-0.2/s                     --                 -87.0%                  -99.7%                 -100.0%
 MC->first_release(CGI)  1186.2+-2.3/s            666.8+-1.8%                     --                  -97.6%                  -99.7%
 MCM->first_release(Foo)   48641+-62/s             31342+-57%           4000.5+-9.4%                      --                  -88.2%
 MCM->first_release(CGI) 411020+-550/s           265590+-490%             34550+-80%               745+-1.6%                      --
 
                                           Rate MC->first_release_by_date(Foo) MC->first_release_by_date(CGI) MCM->first_release_by_date(Foo) MCM->first_release_by_date(CGI)
 MC->first_release_by_date(Foo)  155.92+-0.13/s                             --                         -82.9%                          -99.7%                         -100.0%
 MC->first_release_by_date(CGI)  913.53+-0.71/s                   485.9+-0.68%                             --                          -98.2%                          -99.8%
 MCM->first_release_by_date(Foo)    50483+-16/s                       32277.9%                        5426.2%                              --                          -87.7%
 MCM->first_release_by_date(CGI)  410590+-400/s                   263230+-340%                     44845+-56%                   713.32+-0.83%                              --
 
                              Rate MC->is_core(Foo) is_still_core(Foo) MCM->is_core(Foo)
 MC->is_core(Foo)   155.99+-0.14/s               --             -98.7%            -99.3%
 is_still_core(Foo) 11568.8+-3.6/s          7316.4%                 --            -50.9%
 MCM->is_core(Foo)     23562+-96/s       15005+-63%      103.66+-0.83%                --
 
                                  Rate MC->is_core(Benchmark) is_still_core(Benchmark) MCM->is_core(Benchmark)
 MC->is_core(Benchmark)   575.3+-1.3/s                     --                   -94.8%                  -97.4%
 is_still_core(Benchmark)  11053+-13/s             1821.3+-5%                       --                  -49.6%
 MCM->is_core(Benchmark)  21930+-130/s              3713+-24%               98.4+-1.2%                      --
 
                            Rate MC->is_core(CGI) is_still_core(CGI) MCM->is_core(CGI)
 MC->is_core(CGI)   680.4+-3.2/s               --             -93.9%            -96.9%
 is_still_core(CGI)  11098+-13/s     1531.1+-7.9%                 --            -49.1%
 MCM->is_core(CGI)   21818+-32/s        3107+-16%       96.59+-0.37%                --
 
                                             Rate list_still_core_modules(5.020002) list_core_modules(5.020002) list_still_core_modules(5.010001) list_core_modules(5.010001)
 list_still_core_modules(5.020002) 267.21+-0.69/s                                --                      -13.0%                            -18.6%                      -66.4%
 list_core_modules(5.020002)       307.07+-0.57/s                      14.92+-0.37%                          --                             -6.5%                      -61.4%
 list_still_core_modules(5.010001)  328.3+-0.53/s                      22.86+-0.37%                 6.91+-0.26%                                --                      -58.7%
 list_core_modules(5.010001)       795.53+-0.98/s                     197.71+-0.85%               159.07+-0.58%                     142.32+-0.49%                          --

SEE ALSO

Module::CoreList

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Module-CoreList-More.

SOURCE

Source repository is at https://github.com/perlancar/perl-Module-CoreList-More.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Module-CoreList-More

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by perlancar@cpan.org.

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