Merge pull request #1453 from burnash/feature/expose_credentials_expiry

Add property expiry in gspread client

gspread/client.py

@@ -6,6 +6,7 @@
 
 """
 
+from datetime import datetime
 from http import HTTPStatus
 from typing import Any, Dict, List, Optional, Tuple, Union
 
@@ -39,6 +40,18 @@ def __init__(
     ) -> None:
         self.http_client = http_client(auth, session)
 
+    @property
+    def expiry(self) -> Optional[datetime]:
+        """Returns the expiry date of the curenlty loaded credentials
+
+        :returns: (optional) datetime the expiry date time object.
+
+        .. note::
+
+           It only applies to gspread client created using oauth
+        """
+        return self.http_client.auth.expiry
+
     def set_timeout(
         self, timeout: Optional[Union[float, Tuple[float, float]]] = None
     ) -> None: