add some common helper functions
update readme