update README and add tests for new interface