feat: Added type hints to method parameters (#650)

Closes: SDK-1875

Author: lukaszsocha2

boxsdk/auth/cooperatively_managed_oauth2.py

@@ -1,4 +1,5 @@
 # coding: utf-8
+from typing import Callable, Tuple, Any
 
 from .oauth2 import OAuth2
 
@@ -8,18 +9,16 @@ class CooperativelyManagedOAuth2Mixin(OAuth2):
     Box SDK OAuth2 mixin.
     Allows for sharing auth tokens between multiple clients.
     """
-    def __init__(self, retrieve_tokens=None, *args, **kwargs):
+    def __init__(self, retrieve_tokens: Callable[[], Tuple[str, str]] = None, *args: Any, **kwargs: Any):
         """
         :param retrieve_tokens:
             Callback to get the current access/refresh token pair.
-        :type retrieve_tokens:
-            `callable` of () => (`unicode`, `unicode`)
         """
         # pylint:disable=keyword-arg-before-vararg
         self._retrieve_tokens = retrieve_tokens
         super().__init__(*args, **kwargs)
 
-    def _get_tokens(self):
+    def _get_tokens(self) -> Tuple[str, str]:
         """
         Base class override. Get the tokens from the user-specified callback.
         """

boxsdk/auth/developer_token_auth.py

@@ -1,12 +1,13 @@
 # coding: utf-8
+from typing import Callable, Any, Tuple, Optional
 
 from .oauth2 import OAuth2
 
 
 class DeveloperTokenAuth(OAuth2):
     ENTER_TOKEN_PROMPT = 'Enter developer token: '
 
-    def __init__(self, get_new_token_callback=None, **kwargs):
+    def __init__(self, get_new_token_callback: Callable[[], str] = None, **kwargs: Any):
         self._get_new_token = get_new_token_callback
         super().__init__(
             client_id=None,
@@ -15,21 +16,21 @@ def __init__(self, get_new_token_callback=None, **kwargs):
             **kwargs
         )
 
-    def _refresh_developer_token(self):
+    def _refresh_developer_token(self) -> str:
         if self._get_new_token is not None:
             return self._get_new_token()
 
         return input(self.ENTER_TOKEN_PROMPT)
 
-    def _refresh(self, access_token):
+    def _refresh(self, access_token: str) -> Tuple[str, Optional[str]]:
         """
         Base class override.
         Ask for a new developer token.
         """
         self._access_token = self._refresh_developer_token()
         return self._access_token, None
 
-    def revoke(self):
+    def revoke(self) -> None:
         """
         Base class override.
         Do nothing; developer tokens can't be revoked without client ID and secret.