NAME

Bencher::Scenario::DateModules::Storage - Measure memory storage usage of 1k date/duration objects/structures

VERSION

This document describes version 0.004 of Bencher::Scenario::DateModules::Storage (from Perl distribution Bencher-Scenarios-DateModules), released on 2017-08-27.

SYNOPSIS

To run benchmark with default option:

 % bencher -m DateModules::Storage

To run module startup overhead benchmark:

 % bencher --module-startup -m DateModules::Storage

For more options (dump scenario, list/include/exclude/add participants, list/include/exclude/add datasets, etc), see bencher or run bencher --help.

DESCRIPTION

Packaging a benchmark script as a Bencher scenario makes it convenient to include/exclude/add participants/datasets (either via CLI or Perl code), send the result to a central repository, among others . See Bencher and bencher (CLI) for more details.

BENCHMARKED MODULES

Version numbers shown below are the versions used when running the sample benchmark.

DateTime 1.36

DateTime::Tiny 1.06

Time::Moment 0.38

Time::Local 1.2300

Time::Piece 1.31

DateTime::Duration 1.36

BENCHMARK PARTICIPANTS

• DateTime (perl_code)

  Code template:

   [map {DateTime->new(year=>2016, month=>4, day=>19)} 1..1_000]

• DateTime::Tiny (perl_code)

  Code template:

   [map {DateTime::Tiny->new(year=>2016, month=>4, day=>19)} 1..1_000]

• Time::Moment (perl_code)

  Code template:

   [map {Time::Moment->new(year=>2016, month=>4, day=>19)} 1..1_000]

• Time::Local (perl_code)

  Code template:

   [map {Time::Local::timelocal(0, 0, 0, 19, 4-1, 2016-1900)} 1..1_000]

• Time::Piece (perl_code)

  Code template:

   [map {Time::Piece::localtime()} 1..1_000]

• DateTime::Duration (perl_code)

  Code template:

   [map {DateTime::Duration->new(months=>1, days=>2, minutes=>3, seconds=>4, nanoseconds=>5)} 1..1_000]

SAMPLE BENCHMARK RESULTS

Run on: perl: v5.24.0, CPU: Intel(R) Core(TM) M-5Y71 CPU @ 1.20GHz (2 cores), OS: GNU/Linux LinuxMint version 17.3, OS kernel: Linux version 3.19.0-32-generic.

Benchmark with default options (bencher -m DateModules::Storage):

 #table1#
 +--------------------+-------------+-----------+-------------+------------------+---------+---------+
 | participant        | rate (/s)   | time (ms) | vs_slowest  | result_size (MB) |  errors | samples |
 +--------------------+-------------+-----------+-------------+------------------+---------+---------+
 | DateTime           |   27.126052 | 36.86493  |   1         |       1.4849157  | 5.2e-11 |       1 |
 | DateTime::Duration |   54.215377 | 18.444952 |   1.9986461 |       0.50765514 | 4.8e-11 |       1 |
 | Time::Local        |  109.661    |  9.11897  |   4.04266   |       0.0610962  |   0     |       1 |
 | Time::Piece        |  218.912    |  4.56804  |   8.07018   |       0.274719   |   0     |       1 |
 | DateTime::Tiny     | 1508.35     |  0.662976 |  55.6052    |       0.282457   |   0     |       1 |
 | Time::Moment       | 2724.06     |  0.367099 | 100.422     |       0.116409   |   0     |       1 |
 +--------------------+-------------+-----------+-------------+------------------+---------+---------+

Benchmark module startup overhead (bencher -m DateModules::Storage --module-startup):

 #table2#
 +---------------------+------------------------------+--------------------+----------------+------------+------------------------+------------+---------+---------+
 | participant         | proc_private_dirty_size (MB) | proc_rss_size (MB) | proc_size (MB) | time (ms)  | mod_overhead_time (ms) | vs_slowest |  errors | samples |
 +---------------------+------------------------------+--------------------+----------------+------------+------------------------+------------+---------+---------+
 | DateTime::Duration  | 0.820312                     | 4.09375            | 16.0039        | 91.7918    |             86.862794  |  1         |   0     |       1 |
 | DateTime            | 1.04688                      | 4.40625            | 16.1367        | 72.2122    |             67.283194  |  1.27114   |   0     |       1 |
 | Time::Piece         | 11.0039                      | 14.875             | 44.3125        | 16.9727    |             12.043694  |  5.4082    |   0     |       1 |
 | Time::Local         | 2.28125                      | 5.886719           | 19.44922       | 12.02887   |              7.099864  |  7.630959  | 1.1e-09 |       1 |
 | Time::Moment        | 1.5234375                    | 5.1289062          | 16.652344      | 10.576904  |              5.647898  |  8.6785138 | 5.2e-11 |       1 |
 | DateTime::Tiny      | 1.3554688                    | 4.75               | 18.601562      |  8.7360744 |              3.8070684 | 10.507215  | 5.2e-11 |       1 |
 | perl -e1 (baseline) | 11.09375                     | 14.95312           | 44.46875       |  4.929006  |              0         | 18.62278   | 5.2e-11 |       1 |
 +---------------------+------------------------------+--------------------+----------------+------------+------------------------+------------+---------+---------+

To display as an interactive HTML table on a browser, you can add option --format html+datatables.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Bencher-Scenarios-DateModules.

SOURCE

Source repository is at https://github.com/perlancar/perl-Bencher-Scenarios-DateModules.

BUGS

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

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

cpanm Bencher::Scenarios::DateModules

perl -MCPAN -e shell
install Bencher::Scenarios::DateModules