Friday, May 18, 2012

I often stumble across and use a number of useful tools for creating Python code. Thought I'd barf out a blog post documenting a few of them so that my future self will be able to find this info again if need be. :)

coverage.py

Coverage.py is a Python code coverage tool and is useful for finding out how well your unit tests cover your code. I've often had it find big deficiencies in my unit test coverage. Common usage:

$ coverage run somemodule_test.py$ coverage report -m

Will spit out a coverage report for the tests in somemodule_test.py. Used in this way, coverage.py isn't particularly handy, but combined with a good unit test runner (see below) it becomes very handy.

Nose

Is nicer testing for Python. Nose is an extremely handy unittest runner that has some perks over the standard Python unittest module. Continuing from the last tool, nose also integrates very nicely with coverage.py. I commonly use it to produce some nice HTML pages summarzing test coverage for my project:

pymetrics

pymetrics is a handy tool for spitting out some well, metrics, about your code. Ex:

$ pymetrics somemodule.py

Spits out a bunch of numbers about somemodule.py including trivial things like how many methods have docstrings, to more interesting things like the McCabe cyclomatic complexity of each method/function within the module. Handy.