instrumental 0.5.1

A condition/decision coverage tool for Python

Instrumental automatically instruments your code to add function calls that reveal execution characteristics. 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.

For more information visit the Instrumental documentation.

Announcements and discussion about instrumental can be found on the "python-instrumental-discuss" google group.

Please file bug reports and enhancement requests on bitbucket.