Enable pylint doclinters (#10)

* Enabling docstring linters

* Updated docstring text

.pylintrc

@@ -20,7 +20,7 @@ persistent=no
 
 # List of plugins (as comma separated values of python modules names) to load,
 # usually to register additional checkers.
-load-plugins=
+load-plugins=pylint.extensions.docparams,pylint.extensions.docstyle
 
 # Use multiple processes to speed up Pylint.
 jobs=1
@@ -65,7 +65,7 @@ enable=indexing-exception,old-raise-syntax
 # --enable=similarities". If you want to run only the classes checker, but have
 # no Warning level messages displayed, use"--disable=all --enable=classes
 # --disable=W"
-disable=design,similarities,no-self-use,attribute-defined-outside-init,locally-disabled,star-args,pointless-except,bad-option-value,global-statement,fixme,suppressed-message,useless-suppression,locally-enabled,file-ignored
+disable=design,similarities,no-self-use,attribute-defined-outside-init,locally-disabled,star-args,pointless-except,bad-option-value,global-statement,fixme,suppressed-message,useless-suppression,locally-enabled,file-ignored,missing-type-doc
 
 
 [REPORTS]

firebase_admin/__init__.py

@@ -28,7 +28,7 @@ def initialize_app(credential=None, options=None, name=_DEFAULT_APP_NAME):
       name: Name of the app (optional).
 
     Returns:
-      A newly initialized instance of App.
+      App: A newly initialized instance of App.
 
     Raises:
       ValueError: If the app name is already in use, or any of the
@@ -92,7 +92,7 @@ def get_app(name=_DEFAULT_APP_NAME):
       name: Name of the App instance to retrieve (optional).
 
     Returns:
-      An App instance.
+      App: An App instance with the given name.
 
     Raises:
       ValueError: If the specified name is not a string, or if the specified

firebase_admin/auth.py

@@ -51,7 +51,7 @@ def _get_token_generator(app):
       app: A Firebase App instance (or None to use the default App).
 
     Returns:
-      A _TokenGenerator instance.
+      _TokenGenerator: A _TokenGenerator for the specified App instance.
 
     Raises:
       ValueError: If the app argument is invalid.
@@ -73,7 +73,7 @@ def create_custom_token(uid, developer_claims=None, app=None):
       app: An App instance (optional).
 
     Returns:
-      A token string minted from the input parameters.
+      string: A token minted from the input parameters.
 
     Raises:
       ValueError: If input parameters are invalid.
@@ -93,7 +93,7 @@ def verify_id_token(id_token, app=None):
       app: An App instance (optional).
 
     Returns:
-      A dict consisting of the key-value pairs parsed from the decoded JWT.
+      dict: A dictionary of key-value pairs parsed from the decoded JWT.
 
     Raises:
       ValueError: If the input parameters are invalid, or if the App was not
@@ -140,7 +140,7 @@ def create_custom_token(self, uid, developer_claims=None):
           developer_claims: A dictionary of claims to be included in the token.
 
         Returns:
-          A token string minted from the input parameters.
+          string: A token string minted from the input parameters.
 
         Raises:
           ValueError: If input parameters are invalid.
@@ -195,7 +195,7 @@ def verify_id_token(self, id_token):
           id_token: A string of the encoded JWT.
 
         Returns:
-          A dict consisting of the key-value pairs parsed from the decoded JWT.
+          dict: A dictionary of key-value pairs parsed from the decoded JWT.
 
         Raises:
           ValueError: The app was not initialized with a credentials.Certificate instance.

firebase_admin/credentials.py

@@ -14,11 +14,7 @@ class Base(object):
     """Provides OAuth2 access tokens for accessing Firebase services."""
 
     def get_access_token(self):
-        """Fetches a Google OAuth2 access token using this credential instance.
-
-        Returns:
-          An oauth2client.client.AccessTokenInfo instance
-        """
+        """Fetches a Google OAuth2 access token using this credential instance."""
         raise NotImplementedError
 
     def get_credential(self):
@@ -76,9 +72,18 @@ def service_account_email(self):
         return self._service_account_email
 
     def get_access_token(self):
+        """Fetches a Google OAuth2 access token using this certificate credential.
+
+        Returns:
+          oauth2client.client.AccessTokenInfo: An access token obtained via oauth2client.
+        """
         return self._g_credential.get_access_token(_http)
 
     def get_credential(self):
+        """Returns the underlying Google credential.
+
+        Returns:
+          oauth2client.client.GoogleCredentials: An oauth2client credential instance."""
         return self._g_credential
 
 
@@ -96,9 +101,18 @@ def __init__(self):
         self._g_credential = client.GoogleCredentials.get_application_default()
 
     def get_access_token(self):
+        """Fetches a Google OAuth2 access token using this application default credential.
+
+        Returns:
+          oauth2client.client.AccessTokenInfo: An access token obtained via oauth2client.
+        """
         return self._g_credential.get_access_token(_http)
 
     def get_credential(self):
+        """Returns the underlying Google credential.
+
+        Returns:
+          oauth2client.client.GoogleCredentials: An oauth2client credential instance."""
         return self._g_credential
 
 
@@ -143,7 +157,16 @@ def refresh_token(self):
         return self._refresh_token
 
     def get_access_token(self):
+        """Fetches a Google OAuth2 access token using this refresh token credential.
+
+        Returns:
+          oauth2client.client.AccessTokenInfo: An access token obtained via oauth2client.
+        """
         return self._g_credential.get_access_token(_http)
 
     def get_credential(self):
+        """Returns the underlying Google credential.
+
+        Returns:
+          oauth2client.client.GoogleCredentials: An oauth2client credential instance."""
         return self._g_credential

firebase_admin/jwt.py

@@ -57,7 +57,7 @@ def encode(payload, signer, headers=None):
       headers: An dictionary of headers (optional).
 
     Returns:
-      A signed JWT token as a string
+      string: A signed JWT token.
     """
     header = {'typ': 'JWT', 'alg': 'RS256'}
     if headers:
@@ -86,7 +86,7 @@ def decode(token):
       token: A signed JWT token as a string.
 
     Returns:
-      A 2-tuple where the first element is a dictionary of JWT headers,
+      tuple: A 2-tuple where the first element is a dictionary of JWT headers,
       and the second element is a dictionary of payload claims.
 
     Raises:
@@ -118,7 +118,7 @@ def verify_id_token(id_token, cert_uri, audience=None, kid=None, http=None):
       http: An httplib2 HTTP client instance.
 
     Returns:
-      A dictionary of claims extracted from the ID token.
+      dict: A dictionary of claims extracted from the ID token.
 
     Raises:
       ValueError: Certificate URI is None or empty.