TITLE

SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/Benchmark/Benchmark-1.0/README.md","sources":[],"node":{"type":"block","id":"JpBUC24zuh7Qxw4LYV7cE","margin":"","name":"root","content":[{"type":"para","id":"M0HVy899Ae8WDMe9H9xa2","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":159,"offset":158}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Benchmark/actions","type":"fcode","name":"L","content":[{"type":"block","id":"fLH9szNnwd21enVnW7awX","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":97,"offset":96}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Benchmark/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"2Wm7U7vy7ia-C6ZEnZgRr","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":160},"end":{"line":3,"column":7,"offset":166}},"content":["NAME"]},{"type":"para","id":"nsz77EyY9Ka6eqWZEJs_Y","margin":"","location":{"start":{"line":5,"column":1,"offset":168},"end":{"line":5,"column":32,"offset":199}},"text":"text","content":["Benchmark - Simple benchmarking"]},{"type":"block","id":"Xf3XCv9BJ8V0qOcJpktb3","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":201},"end":{"line":7,"column":11,"offset":211}},"content":["SYNOPSIS"]},{"type":"block","id":"NIKlNopGx5EUfNbpC3N9n","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":213},"end":{"line":21,"column":4,"offset":459}},"content":[{"type":"verbatim","value":"use Benchmark;\n\nmy ($start, $end, $diff, $avg) = timethis(1000, \"code\");\nmy @stats = timethis(1000, sub { #`( code ) });\nsay @stats;\n\nmy %results = timethese 1000, {\n    \"foo\" => sub { ... },\n    \"bar\" => sub { ... },\n}\nsay ~%results;"}]},{"type":"block","id":"eOozyqZHhT7oQRxQLdD_l","margin":"","level":1,"name":"head","location":{"start":{"line":23,"column":1,"offset":461},"end":{"line":23,"column":14,"offset":474}},"content":["DESCRIPTION"]},{"type":"para","id":"MYeTLNdsHt-mlRRaoIpaA","margin":"","location":{"start":{"line":25,"column":1,"offset":476},"end":{"line":25,"column":209,"offset":684}},"text":"text","content":["A simple benchmarking module with an interface similar to Perl's ",{"type":"fcode","name":"C","content":["Benchmark.pm"]},". However, rather than output results to ",{"type":"fcode","name":"C","content":["$*OUT"]},", the results are merely returned so that you can output them however you please."]},{"type":"block","id":"Pn9mJ7nAO88YcXKdAfqpd","margin":"","level":1,"name":"head","location":{"start":{"line":27,"column":1,"offset":686},"end":{"line":27,"column":9,"offset":694}},"content":["AUTHOR"]},{"type":"para","id":"l1Dm2MC0O9vJI0OzylMTD","margin":"","location":{"start":{"line":29,"column":1,"offset":696},"end":{"line":29,"column":20,"offset":715}},"text":"text","content":["Jonathan Scott Duff"]},{"type":"block","id":"luJWob4xe6PY1QwzDDPf5","margin":"","level":1,"name":"head","location":{"start":{"line":31,"column":1,"offset":717},"end":{"line":31,"column":24,"offset":740}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"ThZoW4u2jknUlJC1XanDR","margin":"","location":{"start":{"line":33,"column":1,"offset":742},"end":{"line":33,"column":42,"offset":783}},"text":"text","content":["Copyright 2009 - 2016 Jonathan Scott Duff"]},{"type":"para","id":"c2dEnmNucBXjl02l-zdhI","margin":"","location":{"start":{"line":35,"column":1,"offset":785},"end":{"line":35,"column":37,"offset":821}},"text":"text","content":["Copyright 2017 - 2022 Raku Community"]},{"type":"para","id":"J8ioWShy0EIFRmJ7HN2uu","margin":"","location":{"start":{"line":37,"column":1,"offset":823},"end":{"line":37,"column":104,"offset":926}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Benchmark/Benchmark-1.0/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Jonathan Scott Duff","Raku Community"],"build-depends":[],"depends":[],"description":"Simple benchmarking","dist":"Benchmark:ver<1.0>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Benchmark","path":"B/EN/BENCHMARK/21c54fcbaa7ea2e8c4f31fc702d2edb99323a769.tar.gz","provides":{"Benchmark":"lib/Benchmark.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/Benchmark.git","tags":["CPAN5","BENCHMARK","DEVELOPMENT"],"test-depends":["Test"],"version":"1.0"},"files":[{"file":"work_mods/zef/Benchmark/Benchmark-1.0/README.md","publishUrl":"/mods/zef/Benchmark/Benchmark-1.0/README.md"},{"file":"work_mods/zef/Benchmark/Benchmark-1.0/lib/Benchmark.rakumod","publishUrl":"/mods/zef/Benchmark/Benchmark-1.0/lib/Benchmark.rakumod"}],"src":"zef","url":"/mods/zef/Benchmark"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Benchmark/Benchmark-1.0/README.md","sources":[],"node":{"type":"block","id":"JpBUC24zuh7Qxw4LYV7cE","margin":"","name":"root","content":[{"type":"para","id":"M0HVy899Ae8WDMe9H9xa2","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":159,"offset":158}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Benchmark/actions","type":"fcode","name":"L","content":[{"type":"block","id":"fLH9szNnwd21enVnW7awX","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":97,"offset":96}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Benchmark/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"2Wm7U7vy7ia-C6ZEnZgRr","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":160},"end":{"line":3,"column":7,"offset":166}},"content":["NAME"]},{"type":"para","id":"nsz77EyY9Ka6eqWZEJs_Y","margin":"","location":{"start":{"line":5,"column":1,"offset":168},"end":{"line":5,"column":32,"offset":199}},"text":"text","content":["Benchmark - Simple benchmarking"]},{"type":"block","id":"Xf3XCv9BJ8V0qOcJpktb3","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":201},"end":{"line":7,"column":11,"offset":211}},"content":["SYNOPSIS"]},{"type":"block","id":"NIKlNopGx5EUfNbpC3N9n","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":213},"end":{"line":21,"column":4,"offset":459}},"content":[{"type":"verbatim","value":"use Benchmark;\n\nmy ($start, $end, $diff, $avg) = timethis(1000, \"code\");\nmy @stats = timethis(1000, sub { #`( code ) });\nsay @stats;\n\nmy %results = timethese 1000, {\n    \"foo\" => sub { ... },\n    \"bar\" => sub { ... },\n}\nsay ~%results;"}]},{"type":"block","id":"eOozyqZHhT7oQRxQLdD_l","margin":"","level":1,"name":"head","location":{"start":{"line":23,"column":1,"offset":461},"end":{"line":23,"column":14,"offset":474}},"content":["DESCRIPTION"]},{"type":"para","id":"MYeTLNdsHt-mlRRaoIpaA","margin":"","location":{"start":{"line":25,"column":1,"offset":476},"end":{"line":25,"column":209,"offset":684}},"text":"text","content":["A simple benchmarking module with an interface similar to Perl's ",{"type":"fcode","name":"C","content":["Benchmark.pm"]},". However, rather than output results to ",{"type":"fcode","name":"C","content":["$*OUT"]},", the results are merely returned so that you can output them however you please."]},{"type":"block","id":"Pn9mJ7nAO88YcXKdAfqpd","margin":"","level":1,"name":"head","location":{"start":{"line":27,"column":1,"offset":686},"end":{"line":27,"column":9,"offset":694}},"content":["AUTHOR"]},{"type":"para","id":"l1Dm2MC0O9vJI0OzylMTD","margin":"","location":{"start":{"line":29,"column":1,"offset":696},"end":{"line":29,"column":20,"offset":715}},"text":"text","content":["Jonathan Scott Duff"]},{"type":"block","id":"luJWob4xe6PY1QwzDDPf5","margin":"","level":1,"name":"head","location":{"start":{"line":31,"column":1,"offset":717},"end":{"line":31,"column":24,"offset":740}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"ThZoW4u2jknUlJC1XanDR","margin":"","location":{"start":{"line":33,"column":1,"offset":742},"end":{"line":33,"column":42,"offset":783}},"text":"text","content":["Copyright 2009 - 2016 Jonathan Scott Duff"]},{"type":"para","id":"c2dEnmNucBXjl02l-zdhI","margin":"","location":{"start":{"line":35,"column":1,"offset":785},"end":{"line":35,"column":37,"offset":821}},"text":"text","content":["Copyright 2017 - 2022 Raku Community"]},{"type":"para","id":"J8ioWShy0EIFRmJ7HN2uu","margin":"","location":{"start":{"line":37,"column":1,"offset":823},"end":{"line":37,"column":104,"offset":926}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Benchmark/Benchmark-1.0/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Jonathan Scott Duff","Raku Community"],"build-depends":[],"depends":[],"description":"Simple benchmarking","dist":"Benchmark:ver<1.0>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Benchmark","path":"B/EN/BENCHMARK/21c54fcbaa7ea2e8c4f31fc702d2edb99323a769.tar.gz","provides":{"Benchmark":"lib/Benchmark.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/Benchmark.git","tags":["CPAN5","BENCHMARK","DEVELOPMENT"],"test-depends":["Test"],"version":"1.0"},"files":[{"file":"work_mods/zef/Benchmark/Benchmark-1.0/README.md","publishUrl":"/mods/zef/Benchmark/Benchmark-1.0/README.md"},{"file":"work_mods/zef/Benchmark/Benchmark-1.0/lib/Benchmark.rakumod","publishUrl":"/mods/zef/Benchmark/Benchmark-1.0/lib/Benchmark.rakumod"}],"src":"zef","url":"/mods/zef/Benchmark"}}}
    =end data
    =end React


root

Simple benchmarking


para

L<Examples| file:../examples/index.podlite>


L<Download |file:../download/index.podlite>


=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


HEADER

FOOTER

Benchmark


=begin data
{"type":"page","file":"work_mods/zef/Benchy/Benchy-1.1/README.md","sources":[],"node":{"type":"block","id":"bDLrZO44e9pH7MpXuHeap","margin":"","name":"root","content":[{"type":"para","id":"cShOyj7lJt792o6TNV-Ch","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":165,"offset":164}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Benchy/actions","type":"fcode","name":"L","content":[{"type":"block","id":"QpT-e8dil7jQRe_0ubhTd","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":106,"offset":105}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Benchy/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"KSTmRTMLCWlJvl_Bk2A5G","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":166},"end":{"line":3,"column":7,"offset":172}},"content":["NAME"]},{"type":"para","id":"tGfK3Jd0927cBQXdqlKv2","margin":"","location":{"start":{"line":5,"column":1,"offset":174},"end":{"line":5,"column":29,"offset":202}},"text":"text","content":["Benchy - Benchmark some code"]},{"type":"block","id":"3zKTgrzW0YB21a4Sps30O","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":204},"end":{"line":7,"column":11,"offset":214}},"content":["SYNOPSIS"]},{"type":"block","id":"MZFUVXVKc6UWxHFR2CXdY","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":216},"end":{"line":22,"column":4,"offset":567}},"content":[{"type":"verbatim","value":"use Benchy;\n\nb 20_000,  # number of times to loop\n    { some-setup; my-old-code }, # your old version\n    { some-setup; my-new-code }, # your new version\n    { some-setup } # optional \"bare\" loop to eliminate setup code's time\n\n# SAMPLE OUTPUT:\n# Bare: 0.0606532677866851s\n# Old:  2.170558s\n# New:  0.185170s\n# NEW version is 11.72x faster"}]},{"type":"block","id":"RE4-yZ0Az-rPX-MTBrl3f","margin":"","level":1,"name":"head","location":{"start":{"line":24,"column":1,"offset":569},"end":{"line":24,"column":14,"offset":582}},"content":["DESCRIPTION"]},{"type":"para","id":"JIA1CU_xPfs0cbCNnLTrQ","margin":"","location":{"start":{"line":26,"column":1,"offset":584},"end":{"line":26,"column":225,"offset":808}},"text":"text","content":["Takes 2 ",{"type":"fcode","name":"C","content":["Callable"]},"s and measures which one is faster. Optionally takes a 3rd ",{"type":"fcode","name":"C","content":["Callable"]}," that will be run the same number of times as other two callables, and the time it took to run will be subtracted from the other results."]},{"type":"block","id":"wYk9MfVria1vu7Gw1zshM","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":810},"end":{"line":28,"column":19,"offset":828}},"content":["EXPORTED PRAGMAS"]},{"type":"block","id":"rlK-SY_0m2bGOTb51thS0","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":830},"end":{"line":30,"column":10,"offset":839}},"content":["MONKEY"]},{"type":"para","id":"u65daF2_qOhMJFfAJrJha","margin":"","location":{"start":{"line":32,"column":1,"offset":841},"end":{"line":32,"column":132,"offset":972}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["use"]}," of this module enables ",{"type":"fcode","name":"C","content":["MONKEY"]}," pragma, so you can augment, use NQP, EVAL, etc, without needing to specify those pragmas."]},{"type":"block","id":"DeoYXsx6-dKCMGY0tMxLg","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":974},"end":{"line":34,"column":23,"offset":996}},"content":["EXPORTED SUBROUTINES"]},{"type":"block","id":"kEhAMFRyvxEbhWBGUwc-S","margin":"","level":2,"name":"head","location":{"start":{"line":36,"column":1,"offset":998},"end":{"line":36,"column":54,"offset":1051}},"content":["b(int ",{"type":"fcode","name":"F","content":[{"type":"text","value":"n, &old, &new, &bare = { "}]}," = ",{"type":"fcode","name":"F","content":[{"type":"text","value":" }, :"}]},"silent)"]},{"type":"para","id":"_3vP5B46eScxVSMhQD2ci","margin":"","location":{"start":{"line":38,"column":1,"offset":1053},"end":{"line":38,"column":156,"offset":1208}},"text":"text","content":["Benches the codes and prints the results. Will print in colour, if ",{"meta":"https://modules.raku.org/repo/Terminal::ANSIColor","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["Terminal::ANSIColor"]}]}," is installed."]},{"type":"block","id":"HQqLi6JkBHIlhwZ1RgQ7Y","margin":"","level":3,"name":"head","location":{"start":{"line":40,"column":1,"offset":1210},"end":{"line":40,"column":7,"offset":1216}},"content":["$n"]},{"type":"para","id":"ldkXmvw-YmsRdIE305CLj","margin":"","location":{"start":{"line":42,"column":1,"offset":1218},"end":{"line":42,"column":24,"offset":1241}},"text":"text","content":["How many times to loop."]},{"type":"para","id":"_t5ocEQDltmm1kNWIM5rC","margin":"","location":{"start":{"line":44,"column":1,"offset":1243},"end":{"line":44,"column":186,"offset":1428}},"text":"text","content":["Note that the exact number to loop will always be evened out, as the bench splits the work into two chunks that are measured at different times, so the total time is ",{"type":"fcode","name":"C","content":["2 × floor ½ × $n"]},"."]},{"type":"block","id":"roXx2F6LSsqU2eef_zL_f","margin":"","level":3,"name":"head","location":{"start":{"line":46,"column":1,"offset":1430},"end":{"line":46,"column":9,"offset":1438}},"content":["&old"]},{"type":"para","id":"qSqfTIUhgiHM8zHE4_KLg","margin":"","location":{"start":{"line":48,"column":1,"offset":1440},"end":{"line":48,"column":109,"offset":1548}},"text":"text","content":["Your \"old\" code; assumption is you have \"old\" code and you're trying to write some \"new\" code to replace it."]},{"type":"block","id":"JMScNCIRw8yjjCes9sR32","margin":"","level":3,"name":"head","location":{"start":{"line":50,"column":1,"offset":1550},"end":{"line":50,"column":9,"offset":1558}},"content":["&new"]},{"type":"para","id":"ypS5ASmYQnn4VF5JfsiZM","margin":"","location":{"start":{"line":52,"column":1,"offset":1560},"end":{"line":52,"column":17,"offset":1576}},"text":"text","content":["Your \"new\" code."]},{"type":"block","id":"EkHVtCAutkyJE-cRey3w2","margin":"","level":3,"name":"head","location":{"start":{"line":54,"column":1,"offset":1578},"end":{"line":54,"column":10,"offset":1587}},"content":["&bare"]},{"type":"para","id":"sFRjYWB0ukxuaa70jBQu5","margin":"","location":{"start":{"line":56,"column":1,"offset":1589},"end":{"line":56,"column":322,"offset":1910}},"text":"text","content":["Optional (defaults to ",{"type":"fcode","name":"C","content":["{ $ = $ }"]},"). When specified, this ",{"type":"fcode","name":"C","content":["Callable"]}," will be run same number of times as other code and the time it took to run will be subtracted from the ",{"type":"fcode","name":"C","content":["&new"]}," and ",{"type":"fcode","name":"C","content":["&old"]}," times. Use this to run some \"setup\" code. That is code that's used in ",{"type":"fcode","name":"C","content":["&new"]}," and ",{"type":"fcode","name":"C","content":["&old"]}," but should not be part of the benched times."]},{"type":"block","id":"AkxIG36Hhpz7uT00rdPP5","margin":"","level":3,"name":"head","location":{"start":{"line":58,"column":1,"offset":1912},"end":{"line":58,"column":13,"offset":1924}},"content":[":$silent"]},{"type":"para","id":"knITtxiggq_Sjq6XBIKjh","margin":"","location":{"start":{"line":60,"column":1,"offset":1926},"end":{"line":60,"column":63,"offset":1988}},"text":"text","content":["If set to a truthy value, the routine will not print anything."]},{"type":"block","id":"bmHBa2lchfucovtHk0XEF","margin":"","level":3,"name":"head","location":{"start":{"line":62,"column":1,"offset":1990},"end":{"line":62,"column":12,"offset":2001}},"content":["returns"]},{"type":"para","id":"kp9oc7p7r11KLm0CiCcr5","margin":"","location":{"start":{"line":64,"column":1,"offset":2003},"end":{"line":64,"column":252,"offset":2254}},"text":"text","content":["Returns a hash with three keys - ",{"type":"fcode","name":"C","content":["bare"]},", ",{"type":"fcode","name":"C","content":["new"]},", and ",{"type":"fcode","name":"C","content":["old"]}," — whose values are ",{"type":"fcode","name":"C","content":["Duration"]}," objects representing the time it took the corresponding ",{"type":"fcode","name":"C","content":["Callable"]},"s to run. ",{"type":"fcode","name":"B","content":["NOTE:"]}," the ",{"type":"fcode","name":"C","content":["new"]}," and ",{"type":"fcode","name":"C","content":["old"]}," already have the duration of ",{"type":"fcode","name":"C","content":["bare"]}," subtracted from them."]},{"type":"block","id":"rKnCgYT-2N5AC4PKwr613","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":66,"column":1,"offset":2256},"end":{"line":72,"column":4,"offset":2424}},"content":[{"type":"verbatim","value":"{\n    :bare(Duration.new(<32741983139/488599474770>)),\n    :new(Duration.new(<167/956>)),\n    :old(Duration.new(<1280561957330937733/590077351150947660>))\n}"}]},{"type":"block","id":"5cGIFTDa2KXvA3iDSSZW-","margin":"","level":1,"name":"head","location":{"start":{"line":74,"column":1,"offset":2426},"end":{"line":74,"column":9,"offset":2434}},"content":["AUTHOR"]},{"type":"para","id":"xbA8QJ20yQx7yD9WQGHW7","margin":"","location":{"start":{"line":76,"column":1,"offset":2436},"end":{"line":76,"column":12,"offset":2447}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"ejdV5QsHstWSpv2zLS6zK","margin":"","level":1,"name":"head","location":{"start":{"line":78,"column":1,"offset":2449},"end":{"line":78,"column":24,"offset":2472}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"A61P9B4r0VCpTQ3qqIqiX","margin":"","location":{"start":{"line":80,"column":1,"offset":2474},"end":{"line":80,"column":27,"offset":2500}},"text":"text","content":["Copyright 2017 Zoffix Znet"]},{"type":"para","id":"RVMi-HUYtPX_xffKE_-MA","margin":"","location":{"start":{"line":82,"column":1,"offset":2502},"end":{"line":82,"column":37,"offset":2538}},"text":"text","content":["Copyright 2018 - 2022 Raku Community"]},{"type":"para","id":"PDKSqu_guS14J6_WZyowW","margin":"","location":{"start":{"line":84,"column":1,"offset":2540},"end":{"line":84,"column":104,"offset":2643}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Benchy/Benchy-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":[],"description":"Benchmark some code","dist":"Benchy:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Benchy","path":"B/EN/BENCHY/e9c115f1985e530bea6780521291440d5d505b6a.tar.gz","perl":"6.c","provides":{"Benchy":"lib/Benchy.rakumod"},"resources":[],"source-url":"https://github.com/raku-community-modules/Benchy.git","support":{"source":"https://github.com/raku-community-modules/Benchy.git"},"tags":["benchmark","dev"],"test-depends":["Testo"],"version":"1.1"},"files":[{"file":"work_mods/zef/Benchy/Benchy-1.1/README.md","publishUrl":"/mods/zef/Benchy/Benchy-1.1/README.md"},{"file":"work_mods/zef/Benchy/Benchy-1.1/lib/Benchy.rakumod","publishUrl":"/mods/zef/Benchy/Benchy-1.1/lib/Benchy.rakumod"}],"src":"zef","url":"/mods/zef/Benchy"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Benchy/Benchy-1.1/README.md","sources":[],"node":{"type":"block","id":"bDLrZO44e9pH7MpXuHeap","margin":"","name":"root","content":[{"type":"para","id":"cShOyj7lJt792o6TNV-Ch","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":165,"offset":164}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Benchy/actions","type":"fcode","name":"L","content":[{"type":"block","id":"QpT-e8dil7jQRe_0ubhTd","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":106,"offset":105}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Benchy/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"KSTmRTMLCWlJvl_Bk2A5G","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":166},"end":{"line":3,"column":7,"offset":172}},"content":["NAME"]},{"type":"para","id":"tGfK3Jd0927cBQXdqlKv2","margin":"","location":{"start":{"line":5,"column":1,"offset":174},"end":{"line":5,"column":29,"offset":202}},"text":"text","content":["Benchy - Benchmark some code"]},{"type":"block","id":"3zKTgrzW0YB21a4Sps30O","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":204},"end":{"line":7,"column":11,"offset":214}},"content":["SYNOPSIS"]},{"type":"block","id":"MZFUVXVKc6UWxHFR2CXdY","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":216},"end":{"line":22,"column":4,"offset":567}},"content":[{"type":"verbatim","value":"use Benchy;\n\nb 20_000,  # number of times to loop\n    { some-setup; my-old-code }, # your old version\n    { some-setup; my-new-code }, # your new version\n    { some-setup } # optional \"bare\" loop to eliminate setup code's time\n\n# SAMPLE OUTPUT:\n# Bare: 0.0606532677866851s\n# Old:  2.170558s\n# New:  0.185170s\n# NEW version is 11.72x faster"}]},{"type":"block","id":"RE4-yZ0Az-rPX-MTBrl3f","margin":"","level":1,"name":"head","location":{"start":{"line":24,"column":1,"offset":569},"end":{"line":24,"column":14,"offset":582}},"content":["DESCRIPTION"]},{"type":"para","id":"JIA1CU_xPfs0cbCNnLTrQ","margin":"","location":{"start":{"line":26,"column":1,"offset":584},"end":{"line":26,"column":225,"offset":808}},"text":"text","content":["Takes 2 ",{"type":"fcode","name":"C","content":["Callable"]},"s and measures which one is faster. Optionally takes a 3rd ",{"type":"fcode","name":"C","content":["Callable"]}," that will be run the same number of times as other two callables, and the time it took to run will be subtracted from the other results."]},{"type":"block","id":"wYk9MfVria1vu7Gw1zshM","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":810},"end":{"line":28,"column":19,"offset":828}},"content":["EXPORTED PRAGMAS"]},{"type":"block","id":"rlK-SY_0m2bGOTb51thS0","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":830},"end":{"line":30,"column":10,"offset":839}},"content":["MONKEY"]},{"type":"para","id":"u65daF2_qOhMJFfAJrJha","margin":"","location":{"start":{"line":32,"column":1,"offset":841},"end":{"line":32,"column":132,"offset":972}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["use"]}," of this module enables ",{"type":"fcode","name":"C","content":["MONKEY"]}," pragma, so you can augment, use NQP, EVAL, etc, without needing to specify those pragmas."]},{"type":"block","id":"DeoYXsx6-dKCMGY0tMxLg","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":974},"end":{"line":34,"column":23,"offset":996}},"content":["EXPORTED SUBROUTINES"]},{"type":"block","id":"kEhAMFRyvxEbhWBGUwc-S","margin":"","level":2,"name":"head","location":{"start":{"line":36,"column":1,"offset":998},"end":{"line":36,"column":54,"offset":1051}},"content":["b(int ",{"type":"fcode","name":"F","content":[{"type":"text","value":"n, &old, &new, &bare = { "}]}," = ",{"type":"fcode","name":"F","content":[{"type":"text","value":" }, :"}]},"silent)"]},{"type":"para","id":"_3vP5B46eScxVSMhQD2ci","margin":"","location":{"start":{"line":38,"column":1,"offset":1053},"end":{"line":38,"column":156,"offset":1208}},"text":"text","content":["Benches the codes and prints the results. Will print in colour, if ",{"meta":"https://modules.raku.org/repo/Terminal::ANSIColor","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["Terminal::ANSIColor"]}]}," is installed."]},{"type":"block","id":"HQqLi6JkBHIlhwZ1RgQ7Y","margin":"","level":3,"name":"head","location":{"start":{"line":40,"column":1,"offset":1210},"end":{"line":40,"column":7,"offset":1216}},"content":["$n"]},{"type":"para","id":"ldkXmvw-YmsRdIE305CLj","margin":"","location":{"start":{"line":42,"column":1,"offset":1218},"end":{"line":42,"column":24,"offset":1241}},"text":"text","content":["How many times to loop."]},{"type":"para","id":"_t5ocEQDltmm1kNWIM5rC","margin":"","location":{"start":{"line":44,"column":1,"offset":1243},"end":{"line":44,"column":186,"offset":1428}},"text":"text","content":["Note that the exact number to loop will always be evened out, as the bench splits the work into two chunks that are measured at different times, so the total time is ",{"type":"fcode","name":"C","content":["2 × floor ½ × $n"]},"."]},{"type":"block","id":"roXx2F6LSsqU2eef_zL_f","margin":"","level":3,"name":"head","location":{"start":{"line":46,"column":1,"offset":1430},"end":{"line":46,"column":9,"offset":1438}},"content":["&old"]},{"type":"para","id":"qSqfTIUhgiHM8zHE4_KLg","margin":"","location":{"start":{"line":48,"column":1,"offset":1440},"end":{"line":48,"column":109,"offset":1548}},"text":"text","content":["Your \"old\" code; assumption is you have \"old\" code and you're trying to write some \"new\" code to replace it."]},{"type":"block","id":"JMScNCIRw8yjjCes9sR32","margin":"","level":3,"name":"head","location":{"start":{"line":50,"column":1,"offset":1550},"end":{"line":50,"column":9,"offset":1558}},"content":["&new"]},{"type":"para","id":"ypS5ASmYQnn4VF5JfsiZM","margin":"","location":{"start":{"line":52,"column":1,"offset":1560},"end":{"line":52,"column":17,"offset":1576}},"text":"text","content":["Your \"new\" code."]},{"type":"block","id":"EkHVtCAutkyJE-cRey3w2","margin":"","level":3,"name":"head","location":{"start":{"line":54,"column":1,"offset":1578},"end":{"line":54,"column":10,"offset":1587}},"content":["&bare"]},{"type":"para","id":"sFRjYWB0ukxuaa70jBQu5","margin":"","location":{"start":{"line":56,"column":1,"offset":1589},"end":{"line":56,"column":322,"offset":1910}},"text":"text","content":["Optional (defaults to ",{"type":"fcode","name":"C","content":["{ $ = $ }"]},"). When specified, this ",{"type":"fcode","name":"C","content":["Callable"]}," will be run same number of times as other code and the time it took to run will be subtracted from the ",{"type":"fcode","name":"C","content":["&new"]}," and ",{"type":"fcode","name":"C","content":["&old"]}," times. Use this to run some \"setup\" code. That is code that's used in ",{"type":"fcode","name":"C","content":["&new"]}," and ",{"type":"fcode","name":"C","content":["&old"]}," but should not be part of the benched times."]},{"type":"block","id":"AkxIG36Hhpz7uT00rdPP5","margin":"","level":3,"name":"head","location":{"start":{"line":58,"column":1,"offset":1912},"end":{"line":58,"column":13,"offset":1924}},"content":[":$silent"]},{"type":"para","id":"knITtxiggq_Sjq6XBIKjh","margin":"","location":{"start":{"line":60,"column":1,"offset":1926},"end":{"line":60,"column":63,"offset":1988}},"text":"text","content":["If set to a truthy value, the routine will not print anything."]},{"type":"block","id":"bmHBa2lchfucovtHk0XEF","margin":"","level":3,"name":"head","location":{"start":{"line":62,"column":1,"offset":1990},"end":{"line":62,"column":12,"offset":2001}},"content":["returns"]},{"type":"para","id":"kp9oc7p7r11KLm0CiCcr5","margin":"","location":{"start":{"line":64,"column":1,"offset":2003},"end":{"line":64,"column":252,"offset":2254}},"text":"text","content":["Returns a hash with three keys - ",{"type":"fcode","name":"C","content":["bare"]},", ",{"type":"fcode","name":"C","content":["new"]},", and ",{"type":"fcode","name":"C","content":["old"]}," — whose values are ",{"type":"fcode","name":"C","content":["Duration"]}," objects representing the time it took the corresponding ",{"type":"fcode","name":"C","content":["Callable"]},"s to run. ",{"type":"fcode","name":"B","content":["NOTE:"]}," the ",{"type":"fcode","name":"C","content":["new"]}," and ",{"type":"fcode","name":"C","content":["old"]}," already have the duration of ",{"type":"fcode","name":"C","content":["bare"]}," subtracted from them."]},{"type":"block","id":"rKnCgYT-2N5AC4PKwr613","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":66,"column":1,"offset":2256},"end":{"line":72,"column":4,"offset":2424}},"content":[{"type":"verbatim","value":"{\n    :bare(Duration.new(<32741983139/488599474770>)),\n    :new(Duration.new(<167/956>)),\n    :old(Duration.new(<1280561957330937733/590077351150947660>))\n}"}]},{"type":"block","id":"5cGIFTDa2KXvA3iDSSZW-","margin":"","level":1,"name":"head","location":{"start":{"line":74,"column":1,"offset":2426},"end":{"line":74,"column":9,"offset":2434}},"content":["AUTHOR"]},{"type":"para","id":"xbA8QJ20yQx7yD9WQGHW7","margin":"","location":{"start":{"line":76,"column":1,"offset":2436},"end":{"line":76,"column":12,"offset":2447}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"ejdV5QsHstWSpv2zLS6zK","margin":"","level":1,"name":"head","location":{"start":{"line":78,"column":1,"offset":2449},"end":{"line":78,"column":24,"offset":2472}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"A61P9B4r0VCpTQ3qqIqiX","margin":"","location":{"start":{"line":80,"column":1,"offset":2474},"end":{"line":80,"column":27,"offset":2500}},"text":"text","content":["Copyright 2017 Zoffix Znet"]},{"type":"para","id":"RVMi-HUYtPX_xffKE_-MA","margin":"","location":{"start":{"line":82,"column":1,"offset":2502},"end":{"line":82,"column":37,"offset":2538}},"text":"text","content":["Copyright 2018 - 2022 Raku Community"]},{"type":"para","id":"PDKSqu_guS14J6_WZyowW","margin":"","location":{"start":{"line":84,"column":1,"offset":2540},"end":{"line":84,"column":104,"offset":2643}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/Benchy/Benchy-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":[],"description":"Benchmark some code","dist":"Benchy:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Benchy","path":"B/EN/BENCHY/e9c115f1985e530bea6780521291440d5d505b6a.tar.gz","perl":"6.c","provides":{"Benchy":"lib/Benchy.rakumod"},"resources":[],"source-url":"https://github.com/raku-community-modules/Benchy.git","support":{"source":"https://github.com/raku-community-modules/Benchy.git"},"tags":["benchmark","dev"],"test-depends":["Testo"],"version":"1.1"},"files":[{"file":"work_mods/zef/Benchy/Benchy-1.1/README.md","publishUrl":"/mods/zef/Benchy/Benchy-1.1/README.md"},{"file":"work_mods/zef/Benchy/Benchy-1.1/lib/Benchy.rakumod","publishUrl":"/mods/zef/Benchy/Benchy-1.1/lib/Benchy.rakumod"}],"src":"zef","url":"/mods/zef/Benchy"}}}
    =end data
    =end React


Benchmark some code


Benchy


=begin data
{"type":"page","file":"work_mods/zef/Bench/README.md","sources":[],"node":{"type":"block","id":"v-iIYrfwqFhE_cmxpwhiN","margin":"","name":"root","content":[{"type":"block","id":"N9nchjC_ErxYrwHA36yoz","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":14,"offset":13}},"content":["Bench[mark]"]},{"type":"para","id":"uLGIb6P0lVE3kKSenxuxg","margin":"","location":{"start":{"line":3,"column":1,"offset":15},"end":{"line":3,"column":106,"offset":120}},"text":"text","content":[{"meta":"https://travis-ci.org/tony-o/perl6-bench","type":"fcode","name":"L","content":[{"type":"block","id":"bk_Cy_ruWpEi3Dj8_1BFL","margin":"","name":"Image","config":[],"location":{"start":{"line":3,"column":2,"offset":16},"end":{"line":3,"column":63,"offset":77}},"content":[{"type":"image","src":"https://travis-ci.org/tony-o/perl6-bench.svg","alt":"Build Status"}]}]}]},{"type":"para","id":"B3M87Ko4V_cdEy00icVOM","margin":"","location":{"start":{"line":5,"column":1,"offset":122},"end":{"line":5,"column":129,"offset":250}},"text":"text","content":["Benchmark tool for benchmarking how long a block of code runs for X iterations ",{"type":"fcode","name":"I","content":["or"]}," how many times it can run in a given period."]},{"type":"para","id":"JOwBN18zZzLweyTy3u0Rz","margin":"","location":{"start":{"line":7,"column":1,"offset":252},"end":{"line":7,"column":125,"offset":376}},"text":"text","content":["Bench now uses Telemetry if you have it to show you the USR/SYS/CPU times, so your output below may look slightly different."]},{"type":"block","id":"X08yP70Kt27gt-O3Nn1I7","margin":"","level":1,"name":"head","location":{"start":{"line":9,"column":1,"offset":378},"end":{"line":9,"column":8,"offset":385}},"content":["Usage"]},{"type":"block","id":"tFYP5uBs9BMUYPA3BaNl6","margin":"","name":"code","config":[{"name":"lang","value":"perl6","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":387},"end":{"line":25,"column":4,"offset":675}},"content":[{"type":"verbatim","value":"use Bench;\n\nmy $b = Bench.new;\n\n$b.timethese(1000, {\n  first  => sub { sleep .05; },\n  second => sub { sleep .005; },\n});\n'---------------------------------------------------------'.say;\n$b.cmpthese(1000, {\n  first  => sub { sleep .05; },\n  second => sub { sleep .005; },\n});"}]},{"type":"para","id":"Z66Q59o9FMDQ4PcN7La4K","margin":"","location":{"start":{"line":27,"column":1,"offset":677},"end":{"line":27,"column":7,"offset":683}},"text":"text","content":["Output"]},{"type":"block","id":"4nUIKMpGQ7brKBCA0UqNm","margin":"","name":"code","config":[],"location":{"start":{"line":29,"column":1,"offset":685},"end":{"line":45,"column":4,"offset":1304}},"content":[{"type":"verbatim","value":"Benchmark:\nTiming 1000 iterations of first, second...\n     first: 51.5808 wallclock secs @ 19.3871/s (n=1000)\n    second: 6.4035 wallclock secs @ 156.1656/s (n=1000)\n---------------------------------------------------------\nBenchmark:\nTiming 1000 iterations of first, second...\n     first: 51.5511 wallclock secs @ 19.3982/s (n=1000)\n    second: 6.4145 wallclock secs @ 155.8971/s (n=1000)\nO--------O--------O-------O--------O\n|        | Rate   | first | second |\nO========O========O=======O========O\n| first  | 19.4/s | --    | -88%   |\n| second | 156/s  | 704%  | --     |\n------------------------------------"}]},{"type":"block","id":"GI43DNb_b4f0rIdDg0YYf","margin":"","level":1,"name":"head","location":{"start":{"line":47,"column":1,"offset":1306},"end":{"line":47,"column":10,"offset":1315}},"content":["Methods"]},{"type":"block","id":"zB0BMZ6Tr3mJSjKzTAhGO","margin":"","level":2,"name":"head","location":{"start":{"line":49,"column":1,"offset":1317},"end":{"line":49,"column":31,"offset":1347}},"content":[".timestr(Array) returns Str"]},{"type":"para","id":"iKPDolXLkru9RU4mao-LG","margin":"","location":{"start":{"line":51,"column":1,"offset":1349},"end":{"line":51,"column":192,"offset":1540}},"text":"text","content":["Takes an array returned from any of the following methods and returns a formatted string with the data filled in. The string is similar to below: ",{"type":"fcode","name":"C","content":["6.4145 wallclock secs @ 155.8971/s (n=1000)"]}]},{"type":"block","id":"sg7BhJ_2U3BNHRbhCd3Z-","margin":"","level":2,"name":"head","location":{"start":{"line":53,"column":1,"offset":1542},"end":{"line":53,"column":47,"offset":1588}},"content":[".timeit(Int $iterations, Sub) returns Array"]},{"type":"para","id":"eMHMbInjVM5q-U1a5wHOi","margin":"","location":{"start":{"line":55,"column":1,"offset":1590},"end":{"line":55,"column":161,"offset":1750}},"text":"text","content":["Times a single sub over X iterations. Doesn't output anything by default, just returns an array of time spent and iterations. Use in conjunction with ",{"type":"fcode","name":"C","content":[".timestr"]}]},{"type":"block","id":"r6ZaJarsxvRYGrmpRIiat","margin":"","level":2,"name":"head","location":{"start":{"line":57,"column":1,"offset":1752},"end":{"line":57,"column":42,"offset":1793}},"content":[".countit(Rat $time, Sub) returns Array"]},{"type":"para","id":"D27srbiYt92_qlmVGXCvs","margin":"","location":{"start":{"line":59,"column":1,"offset":1795},"end":{"line":59,"column":108,"offset":1902}},"text":"text","content":["Returns how many iterations of the Sub it can run in the specified time. Use in conjunction with ",{"type":"fcode","name":"C","content":[".timestr"]}]},{"type":"block","id":"RQ3APbpsXpXg7YMsksdug","margin":"","level":2,"name":"head","location":{"start":{"line":61,"column":1,"offset":1904},"end":{"line":61,"column":62,"offset":1965}},"content":[".timethis(Int ",{"type":"fcode","name":"F","content":[{"type":"text","value":"iterations, Sub, Str :"}]},"title) returns Array"]},{"type":"para","id":"vroPGrrA71KT2xN08Utaj","margin":"","location":{"start":{"line":63,"column":1,"offset":1967},"end":{"line":63,"column":161,"offset":2127}},"text":"text","content":["Runs the specified sub for ",{"type":"fcode","name":"F","content":[{"type":"text","value":"iterations and automatically prints out the `.timestr`. If "}]},"iterations is negative or 0 then it runs ",{"type":"fcode","name":"C","content":[".countit"]}," instead of ",{"type":"fcode","name":"C","content":[".timeit"]}]},{"type":"block","id":"4EyTW45TmqQYMnlppmaVw","margin":"","level":2,"name":"head","location":{"start":{"line":65,"column":1,"offset":2129},"end":{"line":65,"column":57,"offset":2185}},"content":[".timethese(Int ",{"type":"fcode","name":"F","content":[{"type":"text","value":"iterations, Hash "}]},"Subs) returns Array"]},{"type":"para","id":"YDZgIrNjskBXA21mrqqPk","margin":"","location":{"start":{"line":67,"column":1,"offset":2187},"end":{"line":67,"column":111,"offset":2297}},"text":"text","content":["Similar to ",{"type":"fcode","name":"C","content":[".timethis"]}," but the key in the hash becomes the title for the test. An example of the output can be"]},{"type":"block","id":"3kk116Ou_Dz7muWe7La7r","margin":"","level":2,"name":"head","location":{"start":{"line":69,"column":1,"offset":2299},"end":{"line":69,"column":56,"offset":2354}},"content":[".cmpthese(Int ",{"type":"fcode","name":"F","content":[{"type":"text","value":"iterations, Hash "}]},"Subs) returns Array"]},{"type":"para","id":"OyMCi55I-gpl0HJ-asOpX","margin":"","location":{"start":{"line":71,"column":1,"offset":2356},"end":{"line":71,"column":83,"offset":2438}},"text":"text","content":["Similar to ",{"type":"fcode","name":"C","content":[".timethese"]}," but it produces a cute little table comparing the results."]},{"type":"block","id":"p_sPgAgPwx61CcEif8h0Y","margin":"","level":1,"name":"head","location":{"start":{"line":73,"column":1,"offset":2440},"end":{"line":73,"column":10,"offset":2449}},"content":["License"]},{"type":"para","id":"GJ5esp2D4Nx3NAbmKkLOX","margin":"","location":{"start":{"line":75,"column":1,"offset":2451},"end":{"line":75,"column":30,"offset":2480}},"text":"text","content":["Do whatever you want with it."]},{"type":"block","id":"6J9BkvqUfJ4zraRsLKGLe","margin":"","level":1,"name":"head","location":{"start":{"line":77,"column":1,"offset":2482},"end":{"line":77,"column":10,"offset":2491}},"content":["Authors"]},{"type":"para","id":"Zz0XbLh1nMV0fVypgcUFI","margin":"","location":{"start":{"line":79,"column":1,"offset":2493},"end":{"line":79,"column":42,"offset":2534}},"text":"text","content":[{"meta":"https://www.gittip.com/tony-o/","type":"fcode","name":"L","content":["@tony-o"]}]}]},"publishUrl":"/mods/zef/Bench/README.md","pluginsData":{"moduleInfo":{"meta":{"auth":"zef:tony-o","depends":[],"description":"Perl6's premier benchmarking utility","dist":"Bench:ver<0.2.0>:auth<zef:tony-o>","name":"Bench","path":"B/EN/BENCH/5dc46b9f004d630b6d5d01d63e4a78608861b316.tar.gz","perl":"6.*","provides":{"Bench":"lib/Bench.pm6"},"source-url":"git://github.com/tony-o/perl6-bench.git","version":"0.2.0"},"files":[{"file":"work_mods/zef/Bench/README.md","publishUrl":"/mods/zef/Bench/README.md"}],"src":"zef","url":"/mods/zef/Bench"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Bench/README.md","sources":[],"node":{"type":"block","id":"v-iIYrfwqFhE_cmxpwhiN","margin":"","name":"root","content":[{"type":"block","id":"N9nchjC_ErxYrwHA36yoz","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":14,"offset":13}},"content":["Bench[mark]"]},{"type":"para","id":"uLGIb6P0lVE3kKSenxuxg","margin":"","location":{"start":{"line":3,"column":1,"offset":15},"end":{"line":3,"column":106,"offset":120}},"text":"text","content":[{"meta":"https://travis-ci.org/tony-o/perl6-bench","type":"fcode","name":"L","content":[{"type":"block","id":"bk_Cy_ruWpEi3Dj8_1BFL","margin":"","name":"Image","config":[],"location":{"start":{"line":3,"column":2,"offset":16},"end":{"line":3,"column":63,"offset":77}},"content":[{"type":"image","src":"https://travis-ci.org/tony-o/perl6-bench.svg","alt":"Build Status"}]}]}]},{"type":"para","id":"B3M87Ko4V_cdEy00icVOM","margin":"","location":{"start":{"line":5,"column":1,"offset":122},"end":{"line":5,"column":129,"offset":250}},"text":"text","content":["Benchmark tool for benchmarking how long a block of code runs for X iterations ",{"type":"fcode","name":"I","content":["or"]}," how many times it can run in a given period."]},{"type":"para","id":"JOwBN18zZzLweyTy3u0Rz","margin":"","location":{"start":{"line":7,"column":1,"offset":252},"end":{"line":7,"column":125,"offset":376}},"text":"text","content":["Bench now uses Telemetry if you have it to show you the USR/SYS/CPU times, so your output below may look slightly different."]},{"type":"block","id":"X08yP70Kt27gt-O3Nn1I7","margin":"","level":1,"name":"head","location":{"start":{"line":9,"column":1,"offset":378},"end":{"line":9,"column":8,"offset":385}},"content":["Usage"]},{"type":"block","id":"tFYP5uBs9BMUYPA3BaNl6","margin":"","name":"code","config":[{"name":"lang","value":"perl6","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":387},"end":{"line":25,"column":4,"offset":675}},"content":[{"type":"verbatim","value":"use Bench;\n\nmy $b = Bench.new;\n\n$b.timethese(1000, {\n  first  => sub { sleep .05; },\n  second => sub { sleep .005; },\n});\n'---------------------------------------------------------'.say;\n$b.cmpthese(1000, {\n  first  => sub { sleep .05; },\n  second => sub { sleep .005; },\n});"}]},{"type":"para","id":"Z66Q59o9FMDQ4PcN7La4K","margin":"","location":{"start":{"line":27,"column":1,"offset":677},"end":{"line":27,"column":7,"offset":683}},"text":"text","content":["Output"]},{"type":"block","id":"4nUIKMpGQ7brKBCA0UqNm","margin":"","name":"code","config":[],"location":{"start":{"line":29,"column":1,"offset":685},"end":{"line":45,"column":4,"offset":1304}},"content":[{"type":"verbatim","value":"Benchmark:\nTiming 1000 iterations of first, second...\n     first: 51.5808 wallclock secs @ 19.3871/s (n=1000)\n    second: 6.4035 wallclock secs @ 156.1656/s (n=1000)\n---------------------------------------------------------\nBenchmark:\nTiming 1000 iterations of first, second...\n     first: 51.5511 wallclock secs @ 19.3982/s (n=1000)\n    second: 6.4145 wallclock secs @ 155.8971/s (n=1000)\nO--------O--------O-------O--------O\n|        | Rate   | first | second |\nO========O========O=======O========O\n| first  | 19.4/s | --    | -88%   |\n| second | 156/s  | 704%  | --     |\n------------------------------------"}]},{"type":"block","id":"GI43DNb_b4f0rIdDg0YYf","margin":"","level":1,"name":"head","location":{"start":{"line":47,"column":1,"offset":1306},"end":{"line":47,"column":10,"offset":1315}},"content":["Methods"]},{"type":"block","id":"zB0BMZ6Tr3mJSjKzTAhGO","margin":"","level":2,"name":"head","location":{"start":{"line":49,"column":1,"offset":1317},"end":{"line":49,"column":31,"offset":1347}},"content":[".timestr(Array) returns Str"]},{"type":"para","id":"iKPDolXLkru9RU4mao-LG","margin":"","location":{"start":{"line":51,"column":1,"offset":1349},"end":{"line":51,"column":192,"offset":1540}},"text":"text","content":["Takes an array returned from any of the following methods and returns a formatted string with the data filled in. The string is similar to below: ",{"type":"fcode","name":"C","content":["6.4145 wallclock secs @ 155.8971/s (n=1000)"]}]},{"type":"block","id":"sg7BhJ_2U3BNHRbhCd3Z-","margin":"","level":2,"name":"head","location":{"start":{"line":53,"column":1,"offset":1542},"end":{"line":53,"column":47,"offset":1588}},"content":[".timeit(Int $iterations, Sub) returns Array"]},{"type":"para","id":"eMHMbInjVM5q-U1a5wHOi","margin":"","location":{"start":{"line":55,"column":1,"offset":1590},"end":{"line":55,"column":161,"offset":1750}},"text":"text","content":["Times a single sub over X iterations. Doesn't output anything by default, just returns an array of time spent and iterations. Use in conjunction with ",{"type":"fcode","name":"C","content":[".timestr"]}]},{"type":"block","id":"r6ZaJarsxvRYGrmpRIiat","margin":"","level":2,"name":"head","location":{"start":{"line":57,"column":1,"offset":1752},"end":{"line":57,"column":42,"offset":1793}},"content":[".countit(Rat $time, Sub) returns Array"]},{"type":"para","id":"D27srbiYt92_qlmVGXCvs","margin":"","location":{"start":{"line":59,"column":1,"offset":1795},"end":{"line":59,"column":108,"offset":1902}},"text":"text","content":["Returns how many iterations of the Sub it can run in the specified time. Use in conjunction with ",{"type":"fcode","name":"C","content":[".timestr"]}]},{"type":"block","id":"RQ3APbpsXpXg7YMsksdug","margin":"","level":2,"name":"head","location":{"start":{"line":61,"column":1,"offset":1904},"end":{"line":61,"column":62,"offset":1965}},"content":[".timethis(Int ",{"type":"fcode","name":"F","content":[{"type":"text","value":"iterations, Sub, Str :"}]},"title) returns Array"]},{"type":"para","id":"vroPGrrA71KT2xN08Utaj","margin":"","location":{"start":{"line":63,"column":1,"offset":1967},"end":{"line":63,"column":161,"offset":2127}},"text":"text","content":["Runs the specified sub for ",{"type":"fcode","name":"F","content":[{"type":"text","value":"iterations and automatically prints out the `.timestr`. If "}]},"iterations is negative or 0 then it runs ",{"type":"fcode","name":"C","content":[".countit"]}," instead of ",{"type":"fcode","name":"C","content":[".timeit"]}]},{"type":"block","id":"4EyTW45TmqQYMnlppmaVw","margin":"","level":2,"name":"head","location":{"start":{"line":65,"column":1,"offset":2129},"end":{"line":65,"column":57,"offset":2185}},"content":[".timethese(Int ",{"type":"fcode","name":"F","content":[{"type":"text","value":"iterations, Hash "}]},"Subs) returns Array"]},{"type":"para","id":"YDZgIrNjskBXA21mrqqPk","margin":"","location":{"start":{"line":67,"column":1,"offset":2187},"end":{"line":67,"column":111,"offset":2297}},"text":"text","content":["Similar to ",{"type":"fcode","name":"C","content":[".timethis"]}," but the key in the hash becomes the title for the test. An example of the output can be"]},{"type":"block","id":"3kk116Ou_Dz7muWe7La7r","margin":"","level":2,"name":"head","location":{"start":{"line":69,"column":1,"offset":2299},"end":{"line":69,"column":56,"offset":2354}},"content":[".cmpthese(Int ",{"type":"fcode","name":"F","content":[{"type":"text","value":"iterations, Hash "}]},"Subs) returns Array"]},{"type":"para","id":"OyMCi55I-gpl0HJ-asOpX","margin":"","location":{"start":{"line":71,"column":1,"offset":2356},"end":{"line":71,"column":83,"offset":2438}},"text":"text","content":["Similar to ",{"type":"fcode","name":"C","content":[".timethese"]}," but it produces a cute little table comparing the results."]},{"type":"block","id":"p_sPgAgPwx61CcEif8h0Y","margin":"","level":1,"name":"head","location":{"start":{"line":73,"column":1,"offset":2440},"end":{"line":73,"column":10,"offset":2449}},"content":["License"]},{"type":"para","id":"GJ5esp2D4Nx3NAbmKkLOX","margin":"","location":{"start":{"line":75,"column":1,"offset":2451},"end":{"line":75,"column":30,"offset":2480}},"text":"text","content":["Do whatever you want with it."]},{"type":"block","id":"6J9BkvqUfJ4zraRsLKGLe","margin":"","level":1,"name":"head","location":{"start":{"line":77,"column":1,"offset":2482},"end":{"line":77,"column":10,"offset":2491}},"content":["Authors"]},{"type":"para","id":"Zz0XbLh1nMV0fVypgcUFI","margin":"","location":{"start":{"line":79,"column":1,"offset":2493},"end":{"line":79,"column":42,"offset":2534}},"text":"text","content":[{"meta":"https://www.gittip.com/tony-o/","type":"fcode","name":"L","content":["@tony-o"]}]}]},"publishUrl":"/mods/zef/Bench/README.md","pluginsData":{"moduleInfo":{"meta":{"auth":"zef:tony-o","depends":[],"description":"Perl6's premier benchmarking utility","dist":"Bench:ver<0.2.0>:auth<zef:tony-o>","name":"Bench","path":"B/EN/BENCH/5dc46b9f004d630b6d5d01d63e4a78608861b316.tar.gz","perl":"6.*","provides":{"Bench":"lib/Bench.pm6"},"source-url":"git://github.com/tony-o/perl6-bench.git","version":"0.2.0"},"files":[{"file":"work_mods/zef/Bench/README.md","publishUrl":"/mods/zef/Bench/README.md"}],"src":"zef","url":"/mods/zef/Bench"}}}
    =end data
    =end React


Perl6's premier benchmarking utility


Bench


The Raku Knowledge Base


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>

=item1 B<Resources>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>

=end nested
=begin nested :!nested

=item1 B<Resoures>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=end React


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


Benchmark

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

COPYRIGHT AND LICENSE

Benchmark v1.0

Authors

License

Dependencies

Test Dependencies

Provides

Documentation