dev: more tests, helper functions, better readme