instrumental 0.2dev

A condition/decision coverage tool for Python

Instrumental automatically instruments your code to add function calls that
reveal execution characteristics of your code. Instrumental can then monitor
execution of your code and report back to you on how your source was executed.

When you run a script with Instrumental, it will tell you which decisions and
conditions haven't been fully exercised. So for a decision in an if statement,
it will tell you if the decision only ever evaluated True or False. Instrumental
will also tell you if the conditions in boolean decisions (and, or) were ever
executed both True and False.

As an example: if you usually say

::

python setup.py nosetests

you can say

instrumental -rs -t <packagename> setup.py nosetests

where packagename is the name of your project's top-level package.