boto3-refresh-session 1.3.15__py3-none-any.whl → 1.3.17__py3-none-any.whl

boto3_refresh_session/__init__.py

@@ -4,7 +4,7 @@ from .session import RefreshableSession
 from .sts import STSRefreshableSession
 
 __all__ = ["RefreshableSession"]
-__version__ = "1.3.15"
+__version__ = "1.3.17"
 __title__ = "boto3-refresh-session"
 __author__ = "Mike Letts"
 __maintainer__ = "Mike Letts"

boto3_refresh_session/custom.py

@@ -5,7 +5,7 @@ __all__ = ["CustomRefreshableSession"]
 from typing import Any, Callable
 
 from .exceptions import BRSError
-from .session import BaseRefreshableSession
+from .session import BaseRefreshableSession, TemporaryCredentials
 
 
 class CustomRefreshableSession(BaseRefreshableSession, method="custom"):
@@ -80,8 +80,8 @@ class CustomRefreshableSession(BaseRefreshableSession, method="custom"):
             refresh_method="custom",
         )
 
-    def _get_credentials(self) -> dict[str, str]:
-        credentials = self._custom_get_credentials(
+    def _get_credentials(self) -> TemporaryCredentials:
+        credentials: TemporaryCredentials = self._custom_get_credentials(
             **self._custom_get_credentials_args
         )
         required_keys = {"access_key", "secret_key", "token", "expiry_time"}
@@ -96,14 +96,12 @@ class CustomRefreshableSession(BaseRefreshableSession, method="custom"):
         return credentials
 
     def get_identity(self) -> dict[str, str]:
-        """
-        Returns metadata about the custom credential getter.
+        """Returns metadata about the custom credential getter.
 
         Returns
         -------
         dict[str, str]
             Dict containing information about the custom credential getter.
-
         """
 
         source = getattr(

boto3_refresh_session/ecs.py

@@ -7,7 +7,7 @@ import os
 import requests
 
 from .exceptions import BRSError
-from .session import BaseRefreshableSession
+from .session import BaseRefreshableSession, TemporaryCredentials
 
 _ECS_CREDENTIALS_RELATIVE_URI = "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI"
 _ECS_CREDENTIALS_FULL_URI = "AWS_CONTAINER_CREDENTIALS_FULL_URI"
@@ -71,7 +71,7 @@ class ECSRefreshableSession(BaseRefreshableSession, method="ecs"):
         session.headers.update(self._headers)
         return session
 
-    def _get_credentials(self) -> dict[str, str]:
+    def _get_credentials(self) -> TemporaryCredentials:
         try:
             response = self._http.get(self._endpoint, timeout=3)
             response.raise_for_status()

boto3_refresh_session/session.py

@@ -3,7 +3,8 @@ from __future__ import annotations
 __all__ = ["RefreshableSession"]
 
 from abc import ABC, abstractmethod
-from typing import Any, Callable, ClassVar, Literal, get_args
+from datetime import datetime
+from typing import Any, Callable, ClassVar, Literal, TypedDict, get_args
 
 from boto3.session import Session
 from botocore.credentials import (
@@ -18,9 +19,17 @@ Method = Literal["sts", "ecs", "custom"]
 RefreshMethod = Literal["sts-assume-role", "ecs-container-metadata", "custom"]
 
 
+class TemporaryCredentials(TypedDict):
+    """Temporary IAM credentials."""
+
+    access_key: str
+    secret_key: str
+    token: str
+    expiry_time: datetime | str
+
+
 class BaseRefreshableSession(ABC, Session):
-    """
-    Abstract base class for implementing refreshable AWS sessions.
+    """Abstract base class for implementing refreshable AWS sessions.
 
     Provides a common interface and factory registration mechanism
     for subclasses that generate temporary credentials using various
@@ -34,7 +43,6 @@ class BaseRefreshableSession(ABC, Session):
     ----------
     registry : dict[str, type[BaseRefreshableSession]]
         Class-level registry mapping method names to registered session types.
-
     """
 
     # adding this and __init_subclass__ to avoid circular imports
@@ -56,7 +64,7 @@ class BaseRefreshableSession(ABC, Session):
         super().__init__(**kwargs)
 
     @abstractmethod
-    def _get_credentials(self) -> dict[str, str]: ...
+    def _get_credentials(self) -> TemporaryCredentials: ...
 
     @abstractmethod
     def get_identity(self) -> dict[str, Any]: ...
@@ -80,8 +88,7 @@ class BaseRefreshableSession(ABC, Session):
             )
 
     def refreshable_credentials(self) -> dict[str, str]:
-        """
-        The current temporary AWS security credentials.
+        """The current temporary AWS security credentials.
 
         Returns
         -------
@@ -93,7 +100,6 @@ class BaseRefreshableSession(ABC, Session):
                     AWS secret access key.
                 AWS_SESSION_TOKEN : str
                     AWS session token.
-
         """
 
         creds = self.get_credentials().get_frozen_credentials()
@@ -140,7 +146,6 @@ class RefreshableSession:
     boto3_refresh_session.custom.CustomRefreshableSession
     boto3_refresh_session.sts.STSRefreshableSession
     boto3_refresh_session.ecs.ECSRefreshableSession
-
     """
 
     def __new__(

boto3_refresh_session/sts.py

@@ -5,7 +5,7 @@ __all__ = ["STSRefreshableSession"]
 from typing import Any
 
 from .exceptions import BRSWarning
-from .session import BaseRefreshableSession
+from .session import BaseRefreshableSession, TemporaryCredentials
 
 
 class STSRefreshableSession(BaseRefreshableSession, method="sts"):
@@ -66,7 +66,7 @@ class STSRefreshableSession(BaseRefreshableSession, method="sts"):
             refresh_method="sts-assume-role",
         )
 
-    def _get_credentials(self) -> dict[str, str]:
+    def _get_credentials(self) -> TemporaryCredentials:
         temporary_credentials = self._sts_client.assume_role(
             **self.assume_role_kwargs
         )["Credentials"]

{boto3_refresh_session-1.3.15.dist-info → boto3_refresh_session-1.3.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: boto3-refresh-session
-Version: 1.3.15
+Version: 1.3.17
 Summary: A simple Python package for refreshing the temporary security credentials in a boto3.session.Session object automatically.
 License: MIT
 Keywords: boto3,botocore,aws,sts,ecs,credentials,token,refresh
@@ -57,11 +57,11 @@ Description-Content-Type: text/markdown
   </a>
 
   <a href="https://pypistats.org/packages/boto3-refresh-session">
-    <img src="https://img.shields.io/badge/downloads-67.6K-red?logo=python&color=%23FF0000&label=Downloads%20%28with%20mirrors%29" alt="Downloads with mirrors"/>
+    <img src="https://img.shields.io/badge/downloads-72.1K-red?logo=python&color=%23FF0000&label=Downloads%20%28with%20mirrors%29" alt="Downloads with mirrors"/>
   </a>
 
   <a href="https://pypistats.org/packages/boto3-refresh-session">
-    <img src="https://img.shields.io/badge/downloads-17.3K-red?logo=python&color=%23FF0000&label=Downloads%20%28without%20mirrors%29" alt="Downloads without mirrors"/>
+    <img src="https://img.shields.io/badge/downloads-18.1K-red?logo=python&color=%23FF0000&label=Downloads%20%28without%20mirrors%29" alt="Downloads without mirrors"/>
   </a>  
 
   <a href="https://michaelthomasletts.github.io/boto3-refresh-session/index.html">

boto3_refresh_session-1.3.17.dist-info/RECORD

@@ -0,0 +1,11 @@
+boto3_refresh_session/__init__.py,sha256=hh8Wnfs1zfTXzMDJdHdAgRNk49evO3K_a-_SwEPgbas,364
+boto3_refresh_session/custom.py,sha256=wR7122COYuFkmVprORfz-mPRqH4XeTH8Uw8_2QUYWUg,3845
+boto3_refresh_session/ecs.py,sha256=Php_ETJ-4E99ka93nXwpDa7vS3El7UCxfX0ptb6ofA4,3741
+boto3_refresh_session/exceptions.py,sha256=qcFzdIuK5PZirs77H_Kb64S9QFb6cn2OJtirjvaRLiY,972
+boto3_refresh_session/session.py,sha256=TGI3-Zv52kGigw0f-mUNBkB2nqM632gCRZgY6KhZd-A,5564
+boto3_refresh_session/sts.py,sha256=f9dtJMfs5bYWfZAcKuANAe0InjmNjZfKyqt5LpHFDxk,3202
+boto3_refresh_session-1.3.17.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
+boto3_refresh_session-1.3.17.dist-info/METADATA,sha256=htPgP6GardF6_6y6QdRwZNcLNB3YWEiBzj9uMi1_U5c,7804
+boto3_refresh_session-1.3.17.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
+boto3_refresh_session-1.3.17.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+boto3_refresh_session-1.3.17.dist-info/RECORD,,

boto3_refresh_session-1.3.15.dist-info/RECORD

@@ -1,11 +0,0 @@
-boto3_refresh_session/__init__.py,sha256=_4VLYpIvCjuw0X_PUpBwM5vDKWGPpsouzlNkzm0wJKE,364
-boto3_refresh_session/custom.py,sha256=YuorVYEzoYxLkzuoMwSqqAmN0n7ZsXKkS2Q8soAyGkc,3805
-boto3_refresh_session/ecs.py,sha256=2lLMDWEE_JArBf0sRtcFmrzxiIpo_S6dauHS-TDUn4U,3713
-boto3_refresh_session/exceptions.py,sha256=qcFzdIuK5PZirs77H_Kb64S9QFb6cn2OJtirjvaRLiY,972
-boto3_refresh_session/session.py,sha256=mxATkH7rDTCiPtEbqxIkhnl_i7xwHJ0wzTH8Zv-xaL8,5368
-boto3_refresh_session/sts.py,sha256=gJKbslmNl8kR8oAeZfOGmrHtgUUxMm7e9hPgZO678FE,3174
-boto3_refresh_session-1.3.15.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
-boto3_refresh_session-1.3.15.dist-info/METADATA,sha256=s6KkLftJRR6xtmntJt8M2Y_QFVZWOdKdrT3BN9BBHhg,7804
-boto3_refresh_session-1.3.15.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
-boto3_refresh_session-1.3.15.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-boto3_refresh_session-1.3.15.dist-info/RECORD,,