NAME
    Attribute::Benchmark - dead easy benchmarking

SYNOPSIS
       #!/usr/bin/env perl
   
       use Attribute::Benchmark;
   
       sub foo :Benchmark
       {
          1 for 0..10;
       }
   
       sub bar1 :Benchmark(bar)
       {
          1 for 0..1000;
       }

    That's all folks!

DESCRIPTION
    Attribute::Benchmark provides a `:Benchmark` attribute for subs. Just
    import it into a script, write the subs you wish to compare, and add the
    `:Benchmark` attribute to each. Then run your script.

    No need to `use strict` or `use warnings` - Attribute::Benchmark does that
    for you.

    By default Attribute::Benchmark uses `cmpthese(-3, \%subs)` but the
    iteration count can be changed in the import statement:

       use Attribute::Benchmark (100);

    Don't forget the parentheses; otherwise Perl will assume you want version
    100.0 of Attribute::Benchmark!

    Attribute::Benchmark will use the name of the sub as the label for the
    benchmark results (e.g. "foo" above). But you can provide an explicit
    label for a result like:

       sub bar1 :Benchmark(bar)

    Easy, peasy, lemon squeezy.

BUGS
    Please report any bugs to
    <http://rt.cpan.org/Dist/Display.html?Queue=Attribute-Benchmark>.

SEE ALSO
    Benchmark.

AUTHOR
    Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE
    This software is copyright (c) 2013 by Toby Inkster.

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

DISCLAIMER OF WARRANTIES
    THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
    WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
    MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.