updated API reference
updated tests and readme