[ANN] Benchmarker 3.0.1 released - a small benchmark utility

[Makoto Kuwata]

Hi,

I released Benchmarker 3.0.1.
http://pypi.python.org/pypi/Benchmarker/

Benchmarker is a small utility to benchmark your code.

*NOTICE* This release doesn't have compatibility with release 2.0.0.


Download
--------

http://pypi.python.org/pypi/Benchmarker/

Installation::

## if you have installed easy_install:
$ sudo easy_install Benchmarker
## or download Benchmarker-3.0.1.tar.gz and install it
$ wget http://pypi.python.org/packages/source/B/Benchmarker/Benchmarker-3.0.1.tar.gz
$ tar xzf Benchmarker-3.0.1.tar.gz
$ cd Benchmarker-3.0.1/
$ sudo python setup.py install


Example
-------

ex0.py::

from benchmarker import Benchmarker, cmdopt
cmdopt.parse()

s1, s2, s3, s4, s5 = "Haruhi", "Mikuru", "Yuki", "Itsuki", "Kyon"
with Benchmarker(width=20, loop=1000*1000) as bm:
for _ in bm.empty(): ## empty loop
pass
for _ in bm('join'):
sos = ''.join((s1, s2, s3, s4, s5))
for _ in bm('concat'):
sos = s1 + s2 + s3 + s4 + s5
for _ in bm('format'):
sos = '%s%s%s%s%s' % (s1, s2, s3, s4, s5)

Output example::

$ python ex0.py -h # show help message of command-line optins
$ python ex0.py
## benchmarker: release 3.0.1 (for python)
## python platform: darwin [GCC 4.2.1 (Apple Inc. build 5664)]
## python version: 2.7.1
## python executable: /usr/local/python/2.7.1/bin/python

## user sys total real
(Empty) 0.1600 0.0000 0.1600 0.1639
join 0.6500 0.0000 0.6500 0.6483
concat 0.5700 0.0000 0.5700 0.5711
format 0.7600 0.0000 0.7600 0.7568

## Ranking real
concat 0.5711 (100.0%) *************************
join 0.6483 ( 88.1%) **********************
format 0.7568 ( 75.5%) *******************

## Ratio Matrix real [01] [02] [03]
[01] concat 0.5711 100.0% 113.5% 132.5%
[02] join 0.6483 88.1% 100.0% 116.7%
[03] format 0.7568 75.5% 85.7% 100.0%

Notice that empty loop times (user, sys, total, and real) are
subtracted from other benchmark times automatically.
For example::

===================================================
benchmark label real (second)
---------------------------------------------------
join 0.6483 (= 0.8122 - 0.1639)
concat 0.5711 (= 0.7350 - 0.1639)
format 0.7568 (= 0.9207 - 0.1639)
===================================================


See http://pypi.python.org/pypi/Benchmarker/ for details.


Changes on release 3.0.1
------------------------

* License is changed again to Public Domain.

* Change Task class to pass 1-origin index to yield block when 'for _ in bm()' .

* Fix a bug that 'for _ in bm()' raised error when loop count was not specified.

* Fix a bug that 'for _ in bm()' raised RuntimeError on Python 3.


Changes on release 3.0.0
------------------------

* Rewrite entirely.

* Enhanced to support command-line options. ::

import benchmarker
benchmarker.cmdopt.parse()

You can show all command-line options by ``python file.py -h``.
See README file for details.

* Benchmarker.repeat() is obsolete. ::

## Old (obsolete)
with Benchmarker() as bm:
for b in bm.repeat(5, 1):
with b('bench1'):
....

## New
for bm in Benchmarker(repeat=5, extra=1):
with bm('bench1'):
....

* Changed to specify time (second) format. ::

import benchmarker
benchmarker.format.label_with = 30
benchmarker.format.time = '%9.4f'

* Followings are removed.

* Benchmark.stat
* Benchmark.compared_matrix()
* Benchmark.print_compared_matrix()


Have fun!