new interface, tests, examples, readme, threadsafe

- updated tests to test new interface
- corrected bugs found in tests
- changed what is and isn't classed as an error
- updated example
- updated readme

removed example binary