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
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.