refactor
update tests for new api
adds examples
update readme and examples