change api to accept arguments in-line with other plugins
update tests
update readme