Merge pull request #23 from tlatsas/readme

add deprecated decorator in Readme
port exception handling