Add Exception InvalidCredentials

- This is thrown when invalid credentials are passed. This is usually an incorrect email/password pair.
- Subclass of `HTTPException`

Author: mathsman5133

coc/__init__.py

@@ -38,8 +38,12 @@
     HTTPException,
     NotFound,
     InvalidArgument,
-    InvalidToken,
+    InvalidCredentials,
     Forbidden,
     Maitenance
 )
 from .http import HTTPClient
+
+from .enums import (
+    CacheType
+)

coc/errors.py

@@ -79,11 +79,11 @@ class InvalidArgument(ClashOfClansException):
     pass
 
 
-class InvalidToken(HTTPException):
-    """Thrown when an error status 403 occurs and the reason is an invalid token.
+class InvalidCredentials(HTTPException):
+    """Thrown when an error status 403 occurs and the reason is invalid credentials.
 
     Special Exception thrown when missing/incorrect credentials
-    were passed. This is most likely an invalid token.
+    were passed. This is when your email/password pair is incorrect.
     Subclass of :exc:`HTTPException`
     """
 

coc/http.py

@@ -39,7 +39,7 @@
 from datetime import datetime
 from collections import deque
 
-from .errors import HTTPException, Maitenance, NotFound, InvalidArgument, Forbidden
+from .errors import HTTPException, Maitenance, NotFound, InvalidArgument, Forbidden, InvalidCredentials
 
 log = logging.getLogger(__name__)
 KEY_MINIMUM, KEY_MAXIMUM = 1, 10
@@ -366,6 +366,8 @@ async def login_to_site(self, email, password):
             response_dict = await sess.json()
             log.debug('%s has received %s', 'https://developer.clashofclans.com/api/login',
                       response_dict)
+            if sess.status == 403:
+                raise InvalidCredentials(sess, response_dict)
 
             session = sess.cookies.get('session').value
 

docs/api.rst

@@ -212,7 +212,7 @@ The following exceptions are thrown by the library.
 
 .. autoexception:: InvalidArgument
 
-.. autoexception:: InvalidToken
+.. autoexception:: InvalidCredentials
 
 .. autoexception:: Forbidden