Raise ValueError for invalid inputs
Minor PEP8 fixes (lowercase function / variable names)
Document return values of some functions
Merge pull request #225 from cdeil/cleanup-for-0.1

Minor cleanup for 0.1