Proposing easy to use API

Implements the proposal at #8 , added docs and tests.