3 files changed, 47 insertions, 14 deletions

diff --git a/README.rst b/README.rst
index 2d51698..0ddd641 100644
--- a/README.rst
+++ b/README.rst
@@ -2,8 +2,29 @@ Mastodon.py
 ===========
 .. code-block:: python
 
+   from mastodon import Mastodon
+
+   # Register app - only once!
+   '''
+   Mastodon.create_app(
+        'pytooterapp', 
+         to_file = 'pytooter_clientcred.txt'
+   )
+   '''
+
+   # Log in - either every time, or use persisted
+   '''
+   mastodon = Mastodon(client_id = 'pytooter_clientcred.txt')
+   mastodon.log_in(
+       '[email protected]',
+       'incrediblygoodpassword', 
+       to_file = 'pytooter_usercred.txt'
+   )
+   '''
+
+   # Create actual instance
    mastodon = Mastodon(
-       client_id = 'pytooter_clientcred.txt',
+       client_id = 'pytooter_clientcred.txt', 
        access_token = 'pytooter_usercred.txt'
    )
    mastodon.toot('Tooting from python!')
diff --git a/docs/index.rst b/docs/index.rst
index 8be642a..6279d48 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -19,7 +19,7 @@ Mastodon.py
    '''
    mastodon = Mastodon(client_id = 'pytooter_clientcred.txt')
    mastodon.log_in(
-       'pytooter', 
+       'my_login_e[email protected]',
        'incrediblygoodpassword', 
        to_file = 'pytooter_usercred.txt'
    )
diff --git a/mastodon/Mastodon.py b/mastodon/Mastodon.py
index 06fe8a1..69d71ec 100644
--- a/mastodon/Mastodon.py
+++ b/mastodon/Mastodon.py
@@ -56,8 +56,10 @@ class Mastodon:
                 request_data['redirect_uris'] = 'urn:ietf:wg:oauth:2.0:oob';
 
             response = requests.post(api_base_url + '/api/v1/apps', data = request_data, timeout = request_timeout).json()
-        except:
-            raise MastodonNetworkError("Could not complete request.")
+        except Exception as e:
+            import traceback
+            traceback.print_exc()
+            raise MastodonNetworkError("Could not complete request: %s" % e)
 
         if to_file != None:
             with open(to_file, 'w') as secret_file:
@@ -142,8 +144,10 @@ class Mastodon:
         try:
             response = self.__api_request('POST', '/oauth/token', params, do_ratelimiting = False)
             self.access_token = response['access_token']
-        except:
-            raise MastodonIllegalArgumentError('Invalid user name, password or scopes.')
+        except Exception as e:
+            import traceback
+            traceback.print_exc()
+            raise MastodonIllegalArgumentError('Invalid user name, password or scopes: %s' % e)
 
         requested_scopes = " ".join(sorted(scopes))
         received_scopes = " ".join(sorted(response["scope"].split(" ")))
@@ -415,8 +419,10 @@ class Mastodon:
                         media_ids_proper.append(media_id["id"])
                     else:
                         media_ids_proper.append(media_id)
-            except:
-                raise MastodonIllegalArgumentError("Invalid media dict.")
+            except Exception as e:
+                import traceback
+                traceback.print_exc()
+                raise MastodonIllegalArgumentError("Invalid media dict: %s" % e)
 
             params_initial["media_ids"] = media_ids_proper
 
@@ -640,8 +646,10 @@ class Mastodon:
 
                 if method == 'DELETE':
                     response_object = requests.delete(self.api_base_url + endpoint, data = params, headers = headers, files = files, timeout = self.request_timeout)
-            except:
-                raise MastodonNetworkError("Could not complete request.")
+            except Exception as e:
+                import traceback
+                traceback.print_exc()
+                raise MastodonNetworkError("Could not complete request: %s" % e)
 
             if response_object == None:
                 raise MastodonIllegalArgumentError("Illegal request.")
@@ -649,7 +657,7 @@ class Mastodon:
             # Handle response
             if self.debug_requests == True:
                 print('Mastodon: Response received with code ' + str(response_object.status_code) + '.')
-                print('Respose headers: ' + str(response_object.headers))
+                print('response headers: ' + str(response_object.headers))
                 print('Response text content: ' + str(response_object.text))
 
             if response_object.status_code == 404:
@@ -661,7 +669,9 @@ class Mastodon:
             try:
                 response = response_object.json()
             except:
-                raise MastodonAPIError("Could not parse response as JSON, respose code was " + str(response_object.status_code))
+                import traceback
+                traceback.print_exc()
+                raise MastodonAPIError("Could not parse response as JSON, response code was %s, bad json content was '%s'" % (response_object.status_code, response_object.content))
 
             # Handle rate limiting
             if 'X-RateLimit-Remaining' in response_object.headers and do_ratelimiting:
@@ -678,8 +688,10 @@ class Mastodon:
                     server_time_diff = time.time() - server_time
                     self.ratelimit_reset += server_time_diff
                     self.ratelimit_lastcall = time.time()
-                except:
-                    raise MastodonRatelimitError("Rate limit time calculations failed.")
+                except Exception as e:
+                    import traceback
+                    traceback.print_exc()
+                    raise MastodonRatelimitError("Rate limit time calculations failed: %s" % e)
 
                 if "error" in response and response["error"] == "Throttled":
                     if self.ratelimit_method == "throw":