Acme-CPANModules-TextTable

 view release on metacpan or  search on metacpan

README  view on Meta::CPAN


    *   Text::Table::Sprintf (perl_code)

        Text::Table::Sprintf

    *   Text::Table::TinyColor (perl_code)

        Text::Table::TinyColor

    *   Text::Table::TinyColorWide (perl_code)

        Text::Table::TinyColorWide

    *   Text::Table::TinyWide (perl_code)

        Text::Table::TinyWide

    *   Text::Table::Org (perl_code)

        Text::Table::Org

    *   Text::Table::CSV (perl_code)

        Text::Table::CSV

    *   Text::Table::HTML (perl_code)

        Text::Table::HTML

    *   Text::Table::HTML::DataTables (perl_code)

        Text::Table::HTML::DataTables

    *   Text::TabularDisplay (perl_code)

        Text::TabularDisplay

BENCHMARK DATASETS
    *   tiny (1x1)

    *   small (3x5)

    *   wide (30x5)

    *   long (3x300)

    *   large (30x300)

    *   multiline data (2x1) (not included by default)

    *   wide char data (1x2) (not included by default)

    *   color data (1x2) (not included by default)

BENCHMARK SAMPLE RESULTS
  Sample benchmark #1
    Run on: perl: *v5.38.0*, CPU: *Intel(R) Core(TM) i5-7200U CPU @ 2.50GHz
    (2 cores)*, OS: *GNU/Linux Ubuntu version 20.04*, OS kernel: *Linux
    version 5.4.0-164-generic*.

    Benchmark command (default options):

     % bencher --cpanmodules-module TextTable

    Result formatted as table (split, part 1 of 5):

     #table1#
     {dataset=>"large (30x300)"}
     +-------------------------------+-----------+-----------+-----------------------+-----------------------+-----------+---------+
     | participant                   | rate (/s) | time (ms) | pct_faster_vs_slowest | pct_slower_vs_fastest |  errors   | samples |
     +-------------------------------+-----------+-----------+-----------------------+-----------------------+-----------+---------+
     | Text::UnicodeBox::Table       |      0.92 |    1100   |                 0.00% |             35566.44% |   0.0024  |      20 |
     | Text::ANSITable               |      1.8  |     560   |                94.68% |             18220.90% |   0.0012  |      20 |
     | Text::Table::More             |      2.5  |     400   |               167.94% |             13211.33% |   0.00094 |      20 |
     | Text::ASCIITable              |      9.6  |     100   |               934.43% |              3347.94% |   0.00076 |      20 |
     | Text::Table::TinyColorWide    |     10    |      70   |              1365.67% |              2333.45% |   0.0008  |      20 |
     | Text::FormatTable             |     15    |      69   |              1474.71% |              2164.95% |   0.00063 |      20 |
     | Text::Table::TinyWide         |     20    |      50   |              1927.24% |              1659.36% |   0.00058 |      20 |
     | Text::SimpleTable             |     26    |      38   |              2719.79% |              1164.86% |   0.00033 |      20 |
     | Text::Table::Manifold         |     30    |      30   |              3432.47% |               909.67% |   0.00039 |      20 |
     | Text::Table::Tiny             |     30    |      30   |              3660.87% |               848.36% |   0.00043 |      20 |
     | Text::TabularDisplay          |     40    |      30   |              4123.89% |               744.40% |   0.00046 |      20 |
     | Text::Table::HTML             |     50    |      20   |              4776.96% |               631.33% |   0.00036 |      20 |
     | Text::Table::TinyColor        |     50    |      20   |              5139.30% |               580.75% |   0.00056 |      20 |
     | Text::MarkdownTable           |     60    |      20   |              6854.90% |               412.82% |   0.00035 |      20 |
     | Text::Table                   |     90    |      10   |              9175.49% |               284.52% |   0.00026 |      20 |
     | Text::Table::HTML::DataTables |    100    |      10   |             10410.10% |               239.35% |   0.00018 |      20 |
     | Text::Table::TinyBorderStyle  |    200    |       6   |             19509.01% |                81.89% |   0.00011 |      20 |
     | Text::Table::Org              |    200    |       5   |             20190.87% |                75.78% |   0.00013 |      20 |
     | Text::Table::CSV              |    200    |       4.9 |             21769.21% |                63.09% | 4.3e-05   |      20 |
     | Text::Table::Sprintf          |    300    |       4   |             28690.71% |                23.88% | 7.4e-05   |      20 |
     | Text::Table::Any              |    300    |       3   |             35566.44% |                 0.00% | 3.3e-05   |      20 |
     +-------------------------------+-----------+-----------+-----------------------+-----------------------+-----------+---------+

    The above result formatted in Benchmark.pm style:

                                       Rate  Text::UnicodeBox::Table  Text::ANSITable  Text::Table::More  Text::ASCIITable  Text::Table::TinyColorWide  Text::FormatTable  Text::Table::TinyWide  Text::SimpleTable  Text::Table::Manifold  Text::Table::T...
      Text::UnicodeBox::Table        0.92/s                       --             -49%               -63%              -90%                        -93%               -93%                   -95%               -96%                   -97%               -...
      Text::ANSITable                 1.8/s                      96%               --               -28%              -82%                        -87%               -87%                   -91%               -93%                   -94%               -...
      Text::Table::More               2.5/s                     175%              39%                 --              -75%                        -82%               -82%                   -87%               -90%                   -92%               -...
      Text::ASCIITable                9.6/s                    1000%             459%               300%                --                        -30%               -31%                   -50%               -62%                   -70%               -...
      Text::Table::TinyColorWide       10/s                    1471%             700%               471%               42%                          --                -1%                   -28%               -45%                   -57%               -...
      Text::FormatTable                15/s                    1494%             711%               479%               44%                          1%                 --                   -27%               -44%                   -56%               -...
      Text::Table::TinyWide            20/s                    2100%            1019%               700%              100%                         39%                37%                     --               -24%                   -40%               -...
      Text::SimpleTable                26/s                    2794%            1373%               952%              163%                         84%                81%                    31%                 --                   -21%               -...
      Text::Table::Manifold            30/s                    3566%            1766%              1233%              233%                        133%               129%                    66%                26%                     --                ...
      Text::Table::Tiny                30/s                    3566%            1766%              1233%              233%                        133%               129%                    66%                26%                     0%                ...
      Text::TabularDisplay             40/s                    3566%            1766%              1233%              233%                        133%               129%                    66%                26%                     0%                ...
      Text::Table::HTML                50/s                    5400%            2700%              1900%              400%                        250%               245%                   150%                89%                    50%                ...
      Text::Table::TinyColor           50/s                    5400%            2700%              1900%              400%                        250%               245%                   150%                89%                    50%                ...
      Text::MarkdownTable              60/s                    5400%            2700%              1900%              400%                        250%               245%                   150%                89%                    50%                ...
      Text::Table                      90/s                   10900%            5500%              3900%              900%                        600%               590%                   400%               280%                   200%               2...
      Text::Table::HTML::DataTables   100/s                   10900%            5500%              3900%              900%                        600%               590%                   400%               280%                   200%               2...
      Text::Table::TinyBorderStyle    200/s                   18233%            9233%              6566%             1566%                       1066%              1050%                   733%               533%                   400%               4...
      Text::Table::Org                200/s                   21900%           11100%              7900%             1900%                       1300%              1280%                   900%               660%                   500%               5...
      Text::Table::CSV                200/s                   22348%           11328%              8063%             1940%                       1328%              1308%                   920%               675%                   512%               5...
      Text::Table::Sprintf            300/s                   27400%           13900%              9900%             2400%                       1650%              1625%                  1150%               850%                   650%               6...
      Text::Table::Any                300/s                   36566%           18566%             13233%             3233%                       2233%              2200%                  1566%              1166%                   900%               9...
 
     Legends:
       Text::ANSITable: participant=Text::ANSITable

README  view on Meta::CPAN

     | Text::Table::HTML             |      3370 |    0.297  |             10075.60% |               295.14% | 1.7e-07   |      20 |
     | Text::MarkdownTable           |      3400 |    0.3    |             10085.88% |               294.74% | 3.2e-07   |      20 |
     | Text::Table::HTML::DataTables |      4100 |    0.24   |             12334.13% |               223.37% | 7.8e-07   |      20 |
     | Text::Table::Sprintf          |      5260 |    0.19   |             15772.29% |               153.32% | 5.1e-08   |      21 |
     | Text::Table::Org              |      7800 |    0.13   |             23583.00% |                69.77% | 2.8e-07   |      20 |
     | Text::Table::CSV              |     11000 |    0.088  |             34210.03% |                17.19% | 1.6e-07   |      20 |
     | Text::Table::Any              |     13300 |    0.0751 |             40107.73% |                 0.00% | 4.5e-08   |      20 |
     +-------------------------------+-----------+-----------+-----------------------+-----------------------+-----------+---------+

    The above result formatted in Benchmark.pm style:

                                        Rate  Text::UnicodeBox::Table  Text::ANSITable  Text::Table::More  Text::ASCIITable  Text::FormatTable  Text::Table::TinyColorWide  Text::Table::TinyBorderStyle  Text::Table  Text::Table::TinyWide  Text::Table:...
      Text::UnicodeBox::Table           33/s                       --             -66%               -70%              -92%               -95%                        -96%                          -96%         -97%                   -97%              ...
      Text::ANSITable                   70/s                     200%               --                -9%              -78%               -85%                        -88%                          -90%         -91%                   -91%              ...
      Text::Table::More                100/s                     233%              11%                 --              -75%               -83%                        -86%                          -88%         -90%                   -90%              ...
      Text::ASCIITable                 450/s                    1263%             354%               309%                --               -31%                        -45%                          -54%         -60%                   -62%              ...
      Text::FormatTable                650/s                    1900%             566%               500%               46%                 --                        -20%                          -33%         -42%                   -44%              ...
      Text::Table::TinyColorWide       830/s                    2400%             733%               650%               83%                25%                          --                          -16%         -27%                   -30%              ...
      Text::Table::TinyBorderStyle     900/s                    2900%             900%               800%              120%                50%                         19%                            --         -13%                   -17%              ...
      Text::Table                     1200/s                    3348%            1049%               934%              152%                72%                         37%                           14%           --                    -4%              ...
      Text::Table::TinyWide           1200/s                    3514%            1104%               984%              165%                80%                         44%                           20%           4%                     --              ...
      Text::Table::Tiny               1000/s                    3650%            1150%              1025%              175%                87%                         49%                           25%           8%                     3%              ...
      Text::SimpleTable               1580/s                    4639%            1479%              1321%              247%               136%                         89%                           57%          37%                    31%              ...
      Text::Table::Manifold           1700/s                    4900%            1566%              1400%              266%               150%                        100%                           66%          44%                    38%              ...
      Text::TabularDisplay            2300/s                    6718%            2172%              1945%              400%               240%                        172%                          127%          97%                    88%              ...
      Text::Table::TinyColor          2900/s                    8471%            2757%              2471%              528%               328%                        242%                          185%         148%                   137%              ...
      Text::MarkdownTable             3400/s                    9900%            3233%              2900%              633%               400%                        300%                          233%         190%                   176%              ...
      Text::Table::HTML               3370/s                   10001%            3267%              2930%              640%               405%                        304%                          236%         192%                   179%              ...
      Text::Table::HTML::DataTables   4100/s                   12400%            4066%              3650%              816%               525%                        400%                          316%         262%                   245%              ...
      Text::Table::Sprintf            5260/s                   15689%            5163%              4636%             1057%               689%                        531%                          426%         357%                   336%              ...
      Text::Table::Org                7800/s                   22976%            7592%              6823%             1592%              1053%                        823%                          669%         569%                   538%              ...
      Text::Table::CSV               11000/s                   33990%           11263%             10127%             2400%              1604%                       1263%                         1036%         888%                   843%              ...
      Text::Table::Any               13300/s                   39846%           13215%             11884%             2829%              1897%                       1497%                         1231%        1058%                  1005%              ...
 
     Legends:
       Text::ANSITable: participant=Text::ANSITable
       Text::ASCIITable: participant=Text::ASCIITable
       Text::FormatTable: participant=Text::FormatTable
       Text::MarkdownTable: participant=Text::MarkdownTable
       Text::SimpleTable: participant=Text::SimpleTable
       Text::Table: participant=Text::Table
       Text::Table::Any: participant=Text::Table::Any
       Text::Table::CSV: participant=Text::Table::CSV
       Text::Table::HTML: participant=Text::Table::HTML
       Text::Table::HTML::DataTables: participant=Text::Table::HTML::DataTables
       Text::Table::Manifold: participant=Text::Table::Manifold
       Text::Table::More: participant=Text::Table::More
       Text::Table::Org: participant=Text::Table::Org
       Text::Table::Sprintf: participant=Text::Table::Sprintf
       Text::Table::Tiny: participant=Text::Table::Tiny
       Text::Table::TinyBorderStyle: participant=Text::Table::TinyBorderStyle
       Text::Table::TinyColor: participant=Text::Table::TinyColor
       Text::Table::TinyColorWide: participant=Text::Table::TinyColorWide
       Text::Table::TinyWide: participant=Text::Table::TinyWide
       Text::TabularDisplay: participant=Text::TabularDisplay
       Text::UnicodeBox::Table: participant=Text::UnicodeBox::Table

    The above result presented as chart:

  Sample benchmark #2
    Benchmark command (benchmarking module startup overhead):

     % bencher --cpanmodules-module TextTable --module-startup

    Result formatted as table:

     #table6#
     +-------------------------------+-----------+----------------------+-----------------------+-----------------------+-----------+---------+
     | participant                   | time (ms) |  mod_overhead_time   | pct_faster_vs_slowest | pct_slower_vs_fastest |  errors   | samples |
     +-------------------------------+-----------+----------------------+-----------------------+-----------------------+-----------+---------+
     | Text::UnicodeBox::Table       |     190   | 181                  |                 0.00% |              2053.49% |   0.00061 |      20 |
     | Text::Table::Manifold         |     110   | 101                  |                75.66% |              1125.93% |   0.00039 |      20 |
     | Text::ANSITable               |      48   |  39                  |               286.81% |               456.73% |   0.00026 |      20 |
     | Text::MarkdownTable           |      46   |  37                  |               301.84% |               435.91% |   0.00031 |      21 |
     | Text::Table::TinyColorWide    |      40   |  31                  |               366.96% |               361.18% |   0.00029 |      20 |
     | Text::Table::TinyWide         |      36   |  27                  |               413.28% |               319.56% |   0.00014 |      22 |
     | Text::Table::More             |      28   |  19                  |               553.94% |               229.31% |   0.00019 |      20 |
     | Text::Table                   |      28   |  19                  |               568.31% |               222.23% |   0.00027 |      20 |
     | Text::ASCIITable              |      20   |  11                  |               781.19% |               144.38% |   0.00028 |      20 |
     | Text::Table::Tiny             |      21   |  12                  |               795.31% |               140.53% |   0.00017 |      20 |
     | Text::Table::TinyColor        |      20   |  11                  |               951.17% |               104.87% |   0.00042 |      21 |
     | Text::FormatTable             |      17   |   8                  |               988.23% |                97.89% |   0.00017 |      20 |
     | Text::Table::Any              |      10   |   1                  |              1195.57% |                66.22% |   0.00021 |      20 |
     | Text::Table::TinyBorderStyle  |      10   |   1                  |              1201.51% |                65.46% |   0.00019 |      21 |
     | Text::TabularDisplay          |      10   |   1                  |              1342.19% |                49.32% |   0.0002  |      20 |
     | Text::Table::Org              |      10   |   1                  |              1396.46% |                43.91% |   0.0002  |      20 |
     | Text::Table::HTML             |      10   |   1                  |              1400.52% |                43.52% |   0.00019 |      20 |
     | Text::SimpleTable             |      12   |   3                  |              1421.63% |                41.53% |   0.00011 |      20 |
     | Text::Table::HTML::DataTables |      10   |   1                  |              1463.78% |                37.71% |   0.00012 |      20 |
     | Text::Table::Sprintf          |       9.1 |   0.0999999999999996 |              1954.13% |                 4.84% | 7.3e-05   |      20 |
     | Text::Table::CSV              |       8.7 |  -0.300000000000001  |              2029.97% |                 1.10% | 3.8e-05   |      20 |
     | perl -e1 (baseline)           |       9   |   0                  |              2053.49% |                 0.00% | 8.9e-05   |      20 |
     +-------------------------------+-----------+----------------------+-----------------------+-----------------------+-----------+---------+

    The above result formatted in Benchmark.pm style:

                                        Rate  Text::UnicodeBox::Table  Text::Table::Manifold  Text::ANSITable  Text::MarkdownTable  Text::Table::TinyColorWide  Text::Table::TinyWide  Text::Table::More  Text::Table  Text::Table::Tiny  Text::ASCIITable...
      Text::UnicodeBox::Table          5.3/s                       --                   -42%             -74%                 -75%                        -78%                   -81%               -85%         -85%               -88%              -89%...
      Text::Table::Manifold            9.1/s                      72%                     --             -56%                 -58%                        -63%                   -67%               -74%         -74%               -80%              -81%...
      Text::ANSITable                 20.8/s                     295%                   129%               --                  -4%                        -16%                   -25%               -41%         -41%               -56%              -58%...
      Text::MarkdownTable             21.7/s                     313%                   139%               4%                   --                        -13%                   -21%               -39%         -39%               -54%              -56%...
      Text::Table::TinyColorWide      25.0/s                     375%                   175%              19%                  14%                          --                    -9%               -30%         -30%               -47%              -50%...
      Text::Table::TinyWide           27.8/s                     427%                   205%              33%                  27%                         11%                     --               -22%         -22%               -41%              -44%...
      Text::Table::More               35.7/s                     578%                   292%              71%                  64%                         42%                    28%                 --           0%               -25%              -28%...
      Text::Table                     35.7/s                     578%                   292%              71%                  64%                         42%                    28%                 0%           --               -25%              -28%...
      Text::Table::Tiny               47.6/s                     804%                   423%             128%                 119%                         90%                    71%                33%          33%                 --               -4%...
      Text::ASCIITable                50.0/s                     850%                   450%             140%                 129%                        100%                    80%                39%          39%                 5%                --...
      Text::Table::TinyColor          50.0/s                     850%                   450%             140%                 129%                        100%                    80%                39%          39%                 5%                0%...
      Text::FormatTable               58.8/s                    1017%                   547%             182%                 170%                        135%                   111%                64%          64%                23%               17%...
      Text::SimpleTable               83.3/s                    1483%                   816%             300%                 283%                        233%                   200%               133%         133%                75%               66%...
      Text::Table::Any               100.0/s                    1800%                  1000%             380%                 359%                        300%                   260%               179%         179%               110%              100%...
      Text::Table::TinyBorderStyle   100.0/s                    1800%                  1000%             380%                 359%                        300%                   260%               179%         179%               110%              100%...
      Text::TabularDisplay           100.0/s                    1800%                  1000%             380%                 359%                        300%                   260%               179%         179%               110%              100%...
      Text::Table::Org               100.0/s                    1800%                  1000%             380%                 359%                        300%                   260%               179%         179%               110%              100%...
      Text::Table::HTML              100.0/s                    1800%                  1000%             380%                 359%                        300%                   260%               179%         179%               110%              100%...
      Text::Table::HTML::DataTables  100.0/s                    1800%                  1000%             380%                 359%                        300%                   260%               179%         179%               110%              100%...
      Text::Table::Sprintf           109.9/s                    1987%                  1108%             427%                 405%                        339%                   295%               207%         207%               130%              119%...
      perl -e1 (baseline)            111.1/s                    2011%                  1122%             433%                 411%                        344%                   300%               211%         211%               133%              122%...
      Text::Table::CSV               114.9/s                    2083%                  1164%             451%                 428%                        359%                   313%               221%         221%               141%              129%...
 
     Legends:

README  view on Meta::CPAN

         </thead>
         <tbody>
         <tr><td>row1.1</td><td>row1.2</td><td>row1.3</td></tr>
         <tr><td>row2.1</td><td>row2.2</td><td>row2.3</td></tr>
         <tr><td>row3.1</td><td>row3.2</td><td>row3.3</td></tr>
         <tr><td>row4.1</td><td>row4.2</td><td>row4.3</td></tr>
         <tr><td>row5.1</td><td>row5.2</td><td>row5.3</td></tr>
         </tbody>
         </table>
         </body>
 
         </html>

    *   "Text::TabularDisplay"

         +--------+--------+--------+
         | col1   | col2   | col3   |
         +--------+--------+--------+
         | row1.1 | row1.2 | row1.3 |
         | row2.1 | row2.2 | row2.3 |
         | row3.1 | row3.2 | row3.3 |
         | row4.1 | row4.2 | row4.3 |
         | row5.1 | row5.2 | row5.3 |
         +--------+--------+--------+

FAQ
  What is an Acme::CPANModules::* module?
    An Acme::CPANModules::* module, like this module, contains just a list
    of module names that share a common characteristics. It is a way to
    categorize modules and document CPAN. See Acme::CPANModules for more
    details.

  What are ways to use this Acme::CPANModules module?
    Aside from reading this Acme::CPANModules module's POD documentation,
    you can install all the listed modules (entries) using cpanm-cpanmodules
    script (from App::cpanm::cpanmodules distribution):

     % cpanm-cpanmodules -n TextTable

    Alternatively you can use the cpanmodules CLI (from App::cpanmodules
    distribution):

        % cpanmodules ls-entries TextTable | cpanm -n

    or Acme::CM::Get:

        % perl -MAcme::CM::Get=TextTable -E'say $_->{module} for @{ $LIST->{entries} }' | cpanm -n

    or directly:

        % perl -MAcme::CPANModules::TextTable -E'say $_->{module} for @{ $Acme::CPANModules::TextTable::LIST->{entries} }' | cpanm -n

    This Acme::CPANModules module contains benchmark instructions. You can
    run a benchmark for some/all the modules listed in this
    Acme::CPANModules module using the bencher CLI (from Bencher
    distribution):

        % bencher --cpanmodules-module TextTable

    This Acme::CPANModules module also helps lcpan produce a more meaningful
    result for "lcpan related-mods" command when it comes to finding related
    modules for the modules listed in this Acme::CPANModules module. See
    App::lcpan::Cmd::related_mods for more details on how "related modules"
    are found.

HOMEPAGE
    Please visit the project's homepage at
    <https://metacpan.org/release/Acme-CPANModules-TextTable>.

SOURCE
    Source repository is at
    <https://github.com/perlancar/perl-Acme-CPANModules-TextTable>.

SEE ALSO
    Related lists: Acme::CPANModules::HTMLTable,
    Acme::CPANModules::BrowsingTableInteractively.

    Acme::CPANModules - about the Acme::CPANModules namespace

    cpanmodules - CLI tool to let you browse/view the lists

AUTHOR
    perlancar <perlancar@cpan.org>

CONTRIBUTING
    To contribute, you can send patches by email/via RT, or send pull
    requests on GitHub.

    Most of the time, you don't need to build the distribution yourself. You
    can simply modify the code, then test via:

     % prove -l

    If you want to build the distribution (e.g. to try to install it locally
    on your system), you can install Dist::Zilla,
    Dist::Zilla::PluginBundle::Author::PERLANCAR,
    Pod::Weaver::PluginBundle::Author::PERLANCAR, and sometimes one or two
    other Dist::Zilla- and/or Pod::Weaver plugins. Any additional steps
    required beyond that are considered a bug and can be reported to me.

COPYRIGHT AND LICENSE
    This software is copyright (c) 2023, 2021, 2020, 2019 by perlancar
    <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.

BUGS
    Please report any bugs or feature requests on the bugtracker website
    <https://rt.cpan.org/Public/Dist/Display.html?Name=Acme-CPANModules-Text
    Table>

    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.



( run in 1.470 second using v1.01-cache-2.11-cpan-f56aa216473 )