always stringify decimals. Better docstrings and a few PEP8.