basic reading
adding options for read
:notebook: updating readme after latest api changes