update readme and add assertions in unit tests