added the ability to filter out keys. small refactoring for more 'pythonic' code. updated documentation.

it is now possible to filter the JSONObject keys by specifying an 'allowed_keys' option in the whitelist