updated assertions with better errors, added new tests
upadated readme