Fixed broken tests, bumped version

These commits comprise a code example in the readme file, fixes for broken unit tests, additional tests and a version bump to 1.3.0.