README.md: minor formatting, add links

This makes some things consistent, has minor formatting tweaks like putting ` ```python ` around a decorator code example to add syntax highlighting, add links to py.test and Tox, etc.